Agent Config Write Checklist

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

This page applies when editing skills, rules, hooks, MCP config, Codex/Cursor/Claude presets, agent packs, 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/agent packs 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 agent-packs:refresh
npm run agent-packs: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-07-01 | Created the explicit heartbeat checklist for skills, rules, hooks, routing maps, agent packs, and cross-harness config changes. Source: User request, 2026-07-01