Handbook

Recipe template

Automated scaffold (from repo root):

./blueprints/agents/scripts/new-agent-recipe.sh <kebab-case-name> [--purpose "one line"]

That copies from README.template.md and run.sh.template into agents/recipes/<name>/.

Manual copy: duplicate this folder’s ideas into agents/recipes/<recipe-name>/ and adjust run.sh.

Optional AI diff review: subfolder llm-diff-review/ — OpenAI-compatible HTTP API, curl + jq only; see Agentic coding standards (cross-cutting).

Optional Playwright E2E: subfolder playwright-e2e/ — npm + @playwright/test in Dockerfile.playwright; see Playwright — blueprint infrastructure.

Optional Versona execution (stubs): versona-evidence-pack-assemble/ (CI/local evidence folder assembly) · versona-kitchensink-diagram-export/ (headless diagram/SVG export). Copy into agents/recipes/ per Orchestration — new agent / recipe; cognition side: Versona skill and tasklet matrix.

  • run.sh — entrypoint executed inside the container; repo is /work when you mount per Agents blueprint — structure & layers §4.
  • Keep recipes idempotent where possible; write outputs to agents/workspaces/<recipe-name>/, not into tracked source unless the recipe is explicit codegen.

Playbook: Orchestration — new agent / recipe.