Agent Config Write Checklist

Agent behavior changes must update executable surfaces, wiki references, graph bindings, routing, and sync checks together.

This page applies when editing skills, rules, hooks, MCP config, Codex/Cursor/Claude presets, workflows, graph bindings, routing maps, automation prompts, or tool-ranking docs. Source: Operational Heartbeat; AGENTS.md Codex sync contract

Checklist

1. Update the executable/config source of truth.
2. Update the wiki reference page that explains it.
3. Update Skill Resolver or Capability Routing Map if routing changed.
4. Regenerate skill registry/runtime links/command indexes when relevant.
5. Run bootstrap or config-sync checks when harness projections changed.
6. Run build-index and qmd.
7. Append wiki/log.md.

Common Command Set

npm run bootstrap
npm run skills:check
npm run slash-command-index
npm run slash-command-index:check
npx tsx scripts/doctor.ts --only config-sync
npx tsx scripts/build-index.ts
qmd update && qmd embed

Run the subset that matches the changed surface. Do not run cargo-cult checks; do run the checks that prove the changed surface is synchronized.

---

Timeline

• 2026-08-10 | Aligned the checklist with workflows, graph bindings, skills, routes, and cross-harness config. Source: User request, 2026-08-10