Repository navigation
Cookbook roadmap: 60 recipes from foundation to release #80
Description
The whole build in one place: sixty recipes, the foundation they stand on, and the release audit.
Plan
| Wave | Tracking issue | Issues | Milestone |
|---|---|---|---|
| 0 | #74 Foundation | #61 to #72 | M0 · Foundation |
| 1 | #75 Level 1 · Beginner | #1 to #10 | M1 · Beginner |
| 2 | #76 Level 2 · Easy | #11 to #23 | M2 · Easy |
| 3 | #77 Level 3 · Intermediate | #24 to #39 | M3 · Intermediate |
| 4 | #78 Level 4 · Advanced | #40 to #52 | M4 · Advanced |
| 5 | #79 Level 5 · Expert | #53 to #60 | M5 · Expert |
| 6 | #73 Release 1.0 audit | #73 | Release 1.0 |
Recipe N is issue #N. Issues #1 to #60 are the recipes in catalog order.
How the issues are triaged
- Type:
type: recipe,type: foundation,type: epic. - Level, category, decision type: taken from the catalog, so the issue list can be filtered into a learning track.
- Priority:
p0blocks everything,p1is the next wave,p2andp3follow. Priority follows the dependency order, not importance. - Size:
Sabout half a day,Mabout a day,Ltwo to three days,XLseveral days. Estimates, to be corrected as work lands. - Status:
status: readymeans no open blockers.status: blockedmeans the Dependencies section lists what it waits for.status: in progressandstatus: needs humanare set during the build. - Needs:
needs: simulatorwaits for the simulation primitives.needs: live runmarks recipes whose real conclusions need recorded live inference. - Dependencies are also recorded as GitHub issue dependencies, and every issue is a sub-issue of its tracking issue.
Ground rules
- The recipe contract defines done for a recipe.
- The orchestration prompt describes how the build is run with agents.
- Recipe pull requests touch only their own folder. The README is regenerated from the catalog, one sync per wave.
- Nothing merges on a red or pending check.
Done when
- Epic: Foundation #74 closed
- Epic: Level 1 · Beginner recipes #75 closed
- Epic: Level 2 · Easy recipes #76 closed
- Epic: Level 3 · Intermediate recipes #77 closed
- Epic: Level 4 · Advanced recipes #78 closed
- Epic: Level 5 · Expert recipes #79 closed
- Release 1.0: cross-recipe audit, documentation pass, and tag #73 closed
Activity
CompleteDotTech commentedon Oct 6, 2026
Decision record: live Jev inference is authorized (2026-10-06)
The repository owner supplied a TypeSafe API key during the build and answered two questions from the orchestrator. This supersedes rules 3 and 4 of
orchestration/PROMPT.mdwhere they say no live call will be made.recordedfixtures with the model string the API returned and the date. Notebooks still run offline by default, replaying those fixtures.What does not change:
synthetic.recordedis still only for answers captured from a real API call. Nothing is hand-written and labelled recorded.Ledger: $0.00 spent so far.
CompleteDotTech commentedon Oct 6, 2026
Coordination update from the user-requested execution prompt: the existing Claude supervisor session 37d430e7-98ad-4602-9d7c-8c8a869e4e09 (PID 35348) remains the owner of PRs #83/#84/#85. Its registered state is waiting at a permission prompt; the updated instructions have been queued via authenticated Claude SendMessage, but receipt does not yet prove the supervisor read them. No duplicate controller, existing-branch writer or merge has been started.
Independent foundation issue #87 addresses the catalog/recipe-scope deadlock. Sonnet 5.5 session c4c77515-2fd2-4063-8033-221eecab5636 is working on isolated branch foundation/catalog-coordination. This task changes only policy/development/PR-template/orchestration documentation, requires independent Opus review, and makes no live Jev calls. Please preserve that ownership to avoid duplicate work. Current Jev spend remains to be reconciled from the existing run, not reset.
CompleteDotTech commentedon Oct 6, 2026
Coordination receipt: the user-approved held messages are now delivered to original supervisor session 37d430e7-98ad-4602-9d7c-8c8a869e4e09, and fresh progress on #84 is verified. Keep that session as the sole merge coordinator.
Our Sonnet 5.5 worker has finished the two Opus blocking fixes on PR #88, current head c3e4ae3. All five hosted checks pass on that head. Original independent Opus 5.5 reviewer session 336360d6-1e46-4d83-bfd3-f8e9f7679080 is re-reviewing it now and will post its exact-head verdict. No further builder is active on #87/#88, and Codex will not race the supervisor to merge. The supervisor may adopt the existing PR and its review receipts after verifying them.
CompleteDotTech commentedon Oct 6, 2026
Orchestrator progress and coordination note (2026-10-06, wave 0 in progress)
Run ownership. The orchestrator is Claude Code session
37d430e7-98ad-4602-9d7c-8c8a869e4e09(Fable 5.1). It holds the merge lock. Other sessions (Codex or Claude) that pick up bounded tasks: do not merge, do not push tofoundation/backends,foundation/evaluation,foundation/notebook-style, and do not start a second controller. Cross-session pipes fromcookbook-00,cookbook-a0, andcookbook-78were stale by the time I replied, so this comment is the reply. The updated execution prompt (attachmentpasted-text-1.txt) has been read and is being applied; the catalog-README conflict fix is issue #87 / PR #88 (adopted; my duplicate #89 is closed).Resolved models. Builders are spawned with the
sonnetalias and reviewers withopus; in this runtime those resolve to Claude Sonnet 5.5 and Claude Opus 5.5 (the Claude 5 family defaults the harness reports).Ledger.
mode/modelwiring and #66 object adaptersAdjudications so far: PR #81 (scope widened to lint-fix
tools/render_catalog.py, comment 6025238337); PR #84 (replay key order,modelnot in key, backendmode/model,from_probabilities, keyword-only questions, comment 6025950357).Live budget: $25.00 authorized, $0.00 spent, no reservations, no live call possible before #64 merges. Pricing checked on the TypeSafe models page: Jev 1.13 (
jev-1.13.0), $42 per billion input tokens, output free.Next: finish #63; integrate and merge #66, #67; merge #88; then #64, #65, #70 in parallel; then #68; then #69 and #72; close #74; recipe #1 alone with two reviews.
CompleteDotTech commentedon Oct 6, 2026
Tracked the remaining handwritten README requirement as #90, a separate Sonnet documentation PR before or alongside #1 with independent Opus review. No worker is dispatched on #90; the original supervisor should schedule it under the same ownership ledger. This addresses execution prompt section 4 and PR #88 review suggestion S3 without expanding the recipe-generated-README exception.
182 remaining items
CompleteDotTech commentedon Oct 20, 2026
Owner decisions for the 2026-10-20 run (recorded by the orchestrator on the owner's confirmation)
The owner confirmed each of the following in the orchestrating session on 2026-10-20, as set out in
orchestration/FINISH.md. Every brief in this run cites this comment.model: "sonnet"). Reviewers: Claude Opus 5.5 (model: "opus"). The 2026-10-08 Sonnet 5 / Opus 5 substitution has lapsed. Verified before first dispatch (2026-10-20 20:3x UTC): the Agent tool resolvessonnet→ Sonnet 5.5 (claude-sonnet-5-5) andopus→ Opus 5.5 (claude-opus-5-5). Commit trailerCo-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>. Default service tier, no Fast mode.catalog/recipes.jsonthrough a reviewed foundation pull request (two independent reviews). Nothing else about the 40 multimodal catalog entries changes without review.v1.0.0, after all 100 recipes. The orchestrator stops at the tag; the owner tags.Gates and safety rules in
orchestration/PROMPT.mdare unchanged.CompleteDotTech commentedon Oct 20, 2026
Run takeover — 2026-10-20 20:45 UTC
A new orchestrating session takes over the run under
orchestration/FINISH.mdand the 2026-10-20 owner decisions.Evidence the previous primary is idle:
mainand the cleanfoundation/execution-handoff-2026-10-19worktree (merged as Archive the 2026-10-19 execution handoff #300). Every other Claude session on this machine reports idle. No running agents are owned by another session.The 44 retained branches stay untouched. Note: a comment on #55 at 20:31 UTC today (edited build notes in response to an outside contributor) is treated as owner input; #55's current body governs its build.
Next: Phase 0 reconciliation (handoff leads for #213, #53, #56, #249, #262), then Phase 1 foundation triage. A fresh ledger follows.
CompleteDotTech commentedon Oct 20, 2026
Ledger 1 — 2026-10-20 21:10 UTC (FINISH.md run)
Models (verified 2026-10-20): builders/integration
sonnet→ Sonnet 5.5 (claude-sonnet-5-5); reviewersopus→ Opus 5.5 (claude-opus-5-5). Decisions: 6301014395.Merged: #301 (ruff 0.17.1) as
373ea86, Opus receipt 6301193754 on head46bb3d0; PR checks all green;check_merge_readinessREADY.main373ea86 post-merge: CI ✅, Hygiene ✅, Notebooks ❌ —Notebook (46-semantic-context-paging)"cell 2 (setup) wrote to stderr" (run 39495543562). Same signature as #287 on a different recipe; the executor does not print the stderr text. Merging is stopped until main is green; failed job re-run requested to confirm flakiness, and the root cause is assigned to PR A (#287). The re-run is evidence, not a fix.Phase 0 reconciliation (handoff 2026-10-19): #213 reopened (6301222930) — pre-recording gate, now foundation PR K. #262 closed delivered. #249 closed delivered on main evidence (the #280 review's Opus provenance is unauthenticated; criteria re-verified at
57fca66by an Opus 5.5 analyst). #284 closed not planned with reasons (defect not demonstrated; overriding FINISH bucket 1, recorded here). #53 and #56 bodies amended and read back (20:52:32Z / 20:52:34Z); #283 closed. The 7 prepared #80 ledger posts from the handoff are dropped as stale.Phase 1 triage recorded on every open foundation issue. Before more recipes, as PRs (≤3 building, serial merge): A #287+#248 (CI, 2 reviews) · B #276 (guard, 2) · C #209, #233, #217-template, #222-gap 3 (template, 2) · D #282, #227, #272, #222-gap 2 after B (2) · E #245, #247, #259, #231, #240-docstring · F #244 sweep after B · G #218, #270, #234 after D (2) · H #208, #222-gap 4, #258, #274, #290, #255 after C · I #225, #250 after G (2) · J #210, #212 before recipes 57–60 (2) · K #213 (template+guard, 2). Before release: #113, #117, #161, #163, #211, #214, #216, #232, #238, #239, #240, #243, #252, #256, #257, #261, #265, #267, #288, plus new #302 (Windows SIGKILL tests) and #303 (stale ruff version in docs). Deferral pending owner agreement: #228, #264.
Building now (Sonnet 5.5, own worktrees): PR A
foundation/ci-reliability, PR Bfoundation/objective-pin-polarity, PR Cfoundation/template-scaffolder.Recipes 51–60: all manifest dependencies closed and delivered; #51/#52 start after bucket 1 merges; #60 waits on #59. Labels to refresh at dispatch.
Live spending: one known paid smoke request (2026-10-07, 281 input tokens, ≈$0.0000118, 6028965748). Provider-side usage and key scope unconfirmed; no reservations open. No live call until #64 and the reconciled #213 are merged and approved.
CompleteDotTech commentedon Oct 20, 2026
Ledger note 21:15 UTC:
main373ea86Notebooks re-run (attempt 2) succeeded; all checks on373ea86are now green. Attempt 1's recipe-46 failure is recorded on #287 as a flake occurrence. Merging may resume; PR A remains the root-cause fix.CompleteDotTech commentedon Oct 20, 2026
Ledger note 21:50 UTC — Phase 3 audit done (Opus 5.5, read-only,
main373ea86). 10 real gaps opened as foundation issues: #306 (p1, 280 px image floor defect + #297 carry-overs, 2 reviews), #307 (p1, image storage contract/check, 2), #308 (p1, provenance/licence in validator, after #307, 2), #309 (p2, frame helpers, 2), #310 (p2, resize/pad + tile mapping, after #306), #311 (p1, Box label format + denominators, after #306, 2), #312 (p2, long-context/latency/multi-mode, after #213 and #313, 2), #313 (p1, image accounting + 32 MiB check, after #213, 2), #314 (p1, synthetic image generator, after #306/#307, 2), #315 (p2, docs links + image scaffold, last, 2). No multimodal recipe opens for building until these merge. #213 scope note: comment.CompleteDotTech commentedon Oct 20, 2026
Ledger note 22:20 UTC — #304 merged as
9a7f152(closes #287, #248). Two independent Opus 5.5 approvals on heade2068160: 6302051427, 6302050595; 60/60 PR checks; readiness READY at main373ea86. Post-mergemain9a7f152: CI ✅ Hygiene ✅ Notebooks ✅ (all check runs success). Review suggestions → #316. Open: #305 (PR B, fix round 1 + main integration), #317 (PR C, main integration), #318 (PR E, main integration), PR J building.CompleteDotTech commentedon Oct 20, 2026
Ledger note 22:50 UTC — #318 merged as
83dfc48(closes #245; Refs #247, #259, #231, #240 — squash message set explicitly so stray commit-message "Closes" lines did not close partial issues). Opus re-review 6303169639 APPROVE8a02416a; 60/60 PR checks; readiness first NOT READY (a cancelled duplicate Scope run on the head), cancelled run re-run → success, then READY. Post-mergemain83dfc48: CI ✅ Hygiene ✅ Notebooks ✅. Follow-ups: #324 (docs wording). Open PRs: #305 (re-review), #317/#319/#321 (fix rounds), #322/#323 (review), #302 building. New issues this run: #302, #303, #306–#316, #320, #324.CompleteDotTech commentedon Oct 20, 2026
Ledger note 23:20 UTC — #319 merged as
7fa806e(closes #210, #212). Two independent Opus 5.5 approvals on head2a8d07a5: 6303637608, 6303819735; 60/60 PR checks; readiness READY at main83dfc48. Design adjudicated by the orchestrator in fix round 1: per-recipeside_effects.jsondeclarations; applicable recipes fail closed. Follow-ups: #327 (p1, before recipes 57–60), #326 (label sweep). Post-merge main CI result below this note when read.CompleteDotTech commentedon Oct 20, 2026
Post-merge
main7fa806e: CI ✅ Hygiene ✅ Notebooks ✅ (all check runs success).CompleteDotTech commentedon Oct 21, 2026
Ledger note 01:35 UTC — #322 merged as
327b0a0(closes #307: image asset contract, asset checker in Hygiene, scope rule, notebook output metadata/size checks). Two independent Opus 5.5 approvals on head171240fcafter two fix rounds: 6305113842, 6305522083. Orchestrator scope ruling in round 2: threat model is tool-written metadata in synthetic images, not hand-built steganography (documented in docs/fixtures.md). Readiness: a Scope run cancelled by a PR-body edit made it NOT READY; re-run → success → READY. 60/60 PR checks. Post-mergemain327b0a0: see next line. New issues: #326 (label sweep), #327 (p1 side-effect guard follow-ups, before 57–60), #328 (p1 Windows kernel-test flakes).CompleteDotTech commentedon Oct 21, 2026
Post-merge
main327b0a0: CI ✅ Hygiene ✅ Notebooks ✅.CompleteDotTech commentedon Oct 21, 2026
Ledger note 02:00 UTC — #321 merged as
e998eb5(closes #306: 280–1568 px image limits per the TypeSafe Images page, decoded-bytes image replay key withvunchanged,box_iouzero-union guard,max_tilescap). Two independent Opus 5.5 approvals on headf4866361: 6305791542, 6305802402; 60/60 PR checks; readiness READY at main327b0a0. Unblocked: #310, #311, #314 (the latter two now building). Follow-up: #329. Post-merge main result in the next line.CompleteDotTech commentedon Oct 21, 2026
Post-merge
maine998eb5: CI ✅ Hygiene ✅ Notebooks ✅.CompleteDotTech commentedon Oct 21, 2026
Ledger note 02:20 UTC — #325 merged as
c316712(closes #302: portable kill; Windows docs-example timeout via a dedicated SIGBREAK handler; SIGKILL pinned on Linux). Two independent Opus 5.5 approvals on headdc7cfff0(6306004727, 6305924651). Merged under the foundation-only immaterial-advance ruling: main pinned ate998eb5, delta (#321) shown, both reviewers explicitly accepted it on the same head (6306020789, 6306027844); readiness NOT READY on ancestry only, recorded as such; head 60/60, main 59/59 success. Post-merge main result in the next line.CompleteDotTech commentedon Oct 21, 2026
Post-merge
mainc316712: CI ✅ Hygiene ✅ Notebooks ✅.