feat(aidd-context): refresh cook recipes and validate practical guides by alexsoyes · Pull Request #521 · ai-driven-dev/framework

alexsoyes · 2026-07-26T15:02:37Z

Summary

Restore the original English Markdown recipe scaffold, with optional Why, Verify, and difficulty sections.
Reduce the recipe contract to concise, non-duplicated principles and address the review comments on routing, references, and report assets.
Keep structural validation read-only and adaptable; fix file-read failures, symlinked entry points, and punctuation false positives.
Refresh the AIDDy, MCP, and token recipes; retire the two bundled project/feature flow guides. Correct the current RTK Codex hook guidance.

Validation

Independent review: cleanup and six-file Cook template follow-up approved, no remaining findings; all 19 supplied template criteria satisfied and 27 validator tests passed.
Global pre-commit: 576 script tests and 140 CLI architecture tests passed; manifests, typecheck, lint, paths, and Markdown links passed.
Pre-push: Knip passed; 6,795 CLI tests passed, one optional local Kilo-runtime test skipped.
JSON, YAML, TOML, and shell examples parsed successfully.
Fresh Codex flat and Claude marketplace distributions each returned the exact three-recipe validation PASS output.
Commit and push hooks ran without bypass. The latest commit is 476678cd.

The cleanup review and evidence are recorded in aidd_docs/tasks/2026_10/2026_10_01_cook-pr-cleanup/review.md. Remote CI, including Windows and CodeQL, passed on 476678cd; no open CodeQL alerts remain for this PR. Interactive client workflows were not executed.

Cook template conformance

The follow-up changes only the router and five actions, preserving their existing behavior. The recipe template, contract, recipes, references, and validator are unchanged by this follow-up. Paths below are relative to plugins/aidd-context/skills/12-cook/.

File	Checked and corrected	Remaining findings
`SKILL.md`	Routing entries, handoffs, outcomes, repair loops, and the single shared index rule	None
`actions/01-list.md`	Ordered process, recipe listing guarantees, and observable Case / Pass tests	None
`actions/02-upsert.md`	Research evidence, new-only deduplication, bundled authorization, preservation, and repair reuse	None
`actions/03-research.md`	One-sentence process steps, source verification, complete outputs, and Case / Pass tests	None
`actions/04-apply.md`	Analysis before choice, per-file confirmation, human-only steps, and Case / Pass tests	None
`actions/05-validate.md`	Purpose sentence, section ownership, read-only checks, and optional parser disclosure	None

A read-only independent checker reviewed all six complete files and their cited Cook contracts. Fresh Codex flat and Claude marketplace builds contain the six current files and return the exact three-recipe validator PASS output.

Keep recipe steps actionable, enforce valid heading nesting, and preserve verified token and MCP guidance.

Separate durable agent instructions from scoped rules and keep each optimization technique directly actionable.

Keep bundled guidance concise, reproducible, and mechanically verifiable.

Keep lint settings compatible with the installed Biome schema.

alexsoyes · 2026-08-24T06:32:04Z

@blafourcade t'es good dessus ?

Keep the cook router, actions, and recipe contract consistent with the skill-generation rules and Baptiste's review feedback.

Keep the original Markdown scaffold adaptable and let validation reject broken recipes without imposing editorial heuristics. Make file reads and symlinked entry points reliable.

Accept native Windows line endings and derive heading anchors without regex-based tag stripping. Keep the symlink entry-point regression active across hosts.

Keep the removed shipping recipe deleted while retaining integration changes.

Expose one validator through the CLI so Cook, hooks and CI share the same checks without a bundled script.

Separate optional rollback from installation and clarify telemetry privacy and output-style activation.

alexsoyes · 2026-10-09T07:03:07Z

C'est pas la panacée cette PR mais elle corrige déjà pas mal de choses par rapport à l'existant, j'aurais jamais du la créer c'est de l'over engineering le content devrait être sur Skool 😅

Accept valid angle-wrapped Markdown destinations while preserving target and placeholder checks. Cover recipe and registration behavior missed by the mutation gate, and synchronize lock acquisition in its regression test.

Use single quotes in the recipe hook so it complies with the command quoting guard introduced on next.

The recipe hook builds the CLI, so Windows must install its dependencies before running commit hooks. Preserve build failures rather than attempting validation with an absent or stale binary.

alexsoyes mentioned this pull request Jul 26, 2026

Clarify recipe step heading hierarchy #519

Closed

alexsoyes marked this pull request as ready for review August 7, 2026 06:41

alexsoyes requested a review from a team as a code owner August 7, 2026 06:41

alexsoyes enabled auto-merge (squash) August 7, 2026 07:03

alexsoyes requested a review from blafourcade August 16, 2026 01:56

alexsoyes added 4 commits August 24, 2026 14:26

docs(aidd-context): refresh cook recipes

e4d814a

Keep recipe steps actionable, enforce valid heading nesting, and preserve verified token and MCP guidance.

docs(aidd-context): streamline token optimization recipe

36f48da

Separate durable agent instructions from scoped rules and keep each optimization technique directly actionable.

feat(aidd-context): validate technical recipes

6e45f17

Keep bundled guidance concise, reproducible, and mechanically verifiable.

chore(cli): migrate Biome configuration

09f2d32

Keep lint settings compatible with the installed Biome schema.

alexsoyes force-pushed the codex/recipes-clean branch from 19c032e to 09f2d32 Compare August 24, 2026 06:30

blafourcade reviewed Aug 24, 2026

View reviewed changes

blafourcade assigned alexsoyes Aug 24, 2026

blafourcade changed the title ~~Refresh cook recipes and enforce heading hierarchy~~ feat(aidd-context): refresh cook recipes and enforce heading hierarchy Aug 24, 2026

alexsoyes added 2 commits August 27, 2026 15:00

chore: merge next into codex/recipes-clean

97b6abb

fix(aidd-context): align cook skill with generated format

4a9f80b

Keep the cook router, actions, and recipe contract consistent with the skill-generation rules and Baptiste's review feedback.

waewoo mentioned this pull request Sep 28, 2026

docs(framework): make intent-based skill workflows discoverable #931

Open

7 tasks

alexsoyes added 2 commits October 1, 2026 06:22

fix(aidd-context): preserve standalone cook workflows

ef53196

chore(vcs): merge next and verify cook integration

ff28a45

github-advanced-security Bot found potential problems Sep 30, 2026

View reviewed changes

fix(aidd-context): restore readable recipe authoring

74d1c18

Keep the original Markdown scaffold adaptable and let validation reject broken recipes without imposing editorial heuristics. Make file reads and symlinked entry points reliable.

alexsoyes changed the title ~~feat(aidd-context): refresh cook recipes and enforce heading hierarchy~~ feat(aidd-context): refresh cook recipes and validate practical guides Oct 1, 2026

github-advanced-security Bot found potential problems Oct 1, 2026

View reviewed changes

Comment thread plugins/aidd-context/skills/12-cook/scripts/validate-recipe.mjs Fixed

alexsoyes added 5 commits October 1, 2026 10:26

fix(aidd-context): make recipe checks portable

ab2f64d

Accept native Windows line endings and derive heading anchors without regex-based tag stripping. Keep the symlink entry-point regression active across hosts.

fix(aidd-context): align cook with skill templates

476678c

chore(vcs): merge next into recipe cleanup

5a6cbea

Keep the removed shipping recipe deleted while retaining integration changes.

fix(cli): centralize recipe validation

faebbf6

Expose one validator through the CLI so Cook, hooks and CI share the same checks without a bundled script.

fix(aidd-context): correct bundled recipe instructions

98cd4db

Separate optional rollback from installation and clarify telemetry privacy and output-style activation.

alexsoyes assigned blafourcade Oct 9, 2026

alexsoyes removed their assignment Oct 9, 2026

blafourcade approved these changes Oct 12, 2026

View reviewed changes

blafourcade added 5 commits October 12, 2026 10:26

fix(lefthook): preserve recipe validation on windows

da795f5

Use single quotes in the recipe hook so it complies with the command quoting guard introduced on next.

fix(ci): install recipe validation dependencies before windows hooks

f6246be

The recipe hook builds the CLI, so Windows must install its dependencies before running commit hooks. Preserve build failures rather than attempting validation with an absent or stale binary.

chore(ci): integrate next and preserve windows recipe validation

c413202

docs(ci): describe windows recipe and installation builds

ec15617

alexsoyes merged commit d31fb5e into next Oct 12, 2026
39 checks passed

Navigation Menu

Repository navigation

feat(aidd-context): refresh cook recipes and validate practical guides - #521

feat(aidd-context): refresh cook recipes and validate practical guides#521
alexsoyes merged 19 commits into
nextfrom
codex/recipes-clean

alexsoyes commented Jul 26, 2026 •

edited

Loading

Uh oh!

alexsoyes commented Aug 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

alexsoyes commented Oct 9, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

alexsoyes commented Jul 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Cook template conformance

Uh oh!

alexsoyes commented Aug 24, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

alexsoyes commented Oct 9, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

alexsoyes commented Jul 26, 2026 •

edited

Loading