Handbook

Workflow — task authoring

bash python3 scripts/audit_contract_docs.py --strict pytest -q

Updated

  1. Find a similar task in src/forge_lcdl/contracts/ and the matching runner under src/forge_lcdl/tasks/.
  2. Draft contract.md — inputs, outputs, examples, failure modes (see ContractSpec).
  3. Generate / edit contract.json — run python3 scripts/generate_contract_sidecars.py when appropriate.
  4. Implement or wire the Python runner; register in the catalog for v1 if applicable.
  5. Add tests — unit tests with fake chat where possible.
  6. Run gates:

bash python3 scripts/audit_contract_docs.py --strict pytest -q

  1. Update Task catalog or consumer notes if the task is public catalog.

Prompt snippet (for agents)

Implement or extend governed task <task_id> v1 following existing pw_chunk_classify patterns; keep schemas in contract.json; do not weaken responsible-use constraints.

See also