Imported from MickBourgois/agentic-workflow (
AGENTS.md). Install upstream withnpx skills add MickBourgois/agentic-workflow. Copyright stays with the author.
Agentic Workflow
This repository is the canonical source for a portable delivery workflow. Read
README.md before changing behavior and docs/MANAGED-FILES.md before changing
the install payload.
Commands
npm test
npm run smoke
npm run scan:secrets
npm run check
Source of truth
- Skills live in
workflow/skills/; Claude commands are thin adapters. - Agent definitions live in
workflow/agents/codex/. - Routing lives in
workflow/config/defaults.mjsand must stay covered by tests. - Shared handoffs and phase invariants live in
workflow/contracts/delivery.md. - Installer ownership rules live in
scripts/agent-workflow.mjs.
Consumer copies are generated by install/update. Edit canonical source, not a temporary installed fixture.
Change rules
- Keep the workflow product- and stack-agnostic.
- Put project variance in config; keep machine values in the ignored local layer.
- Preserve fresh-context boundaries and exact-head review receipts.
- Preserve user files on install/update. A checksum mismatch is a conflict.
- Add or update tests for routing, state transitions, payload ownership, and conflict behavior.
- Run
npm run checkbefore committing. - Never add secrets, local paths, tracker data, runtime sessions, or generated conflict/backup content.