bastien
94189adbc6
A/B /reconcile headless — BEFORE requests=18 output=12374 thinking=3135 effort={'high'} duration_ms=96518 / AFTER requests=15 output=9038 thinking=2248 effort={'low'} duration_ms=78410
2.2 KiB
name, effort, description, argument-hint, allowed-tools
| name | effort | description | argument-hint | allowed-tools | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| doc | low | Use when documentation may be out of sync with code — features added/removed vs README / INSTALL / DEPLOY / CHANGELOG. Stack-aware audit, cross-references git history, patches approved items. Triggers: "doc", "sync docs", "update readme", "documentation drift", "stale docs", "docs à jour ?", "create README", "should I have a DEPLOY doc". |
|
|
Run the two-mode doc pipeline (BDR-077 — audit judgment on opus, patch on the sonnet pin, the validation gate in THIS loop; a dispatched agent cannot hold a gate):
-
AIGUILLAGE — before any write, follow
$HOME/.claude/lib/gitflow-aiguillage.md— this skill's TYPE =chore. Onmain/developit branches tochore/<name>off develop so the doc patch lands on a branch; on a working branch it proceeds in place. Nevergitflow finish.lib/doc-commit.md's rc 5 (commit rejected by the hook on a protected base) stays as the backstop, not the plan. -
AUDIT — dispatch:
Agent(subagent_type="doc-syncer", model="opus")prompt: "MODE: audit. Audit public docs for this project. Context from the user: $ARGUMENTS. Emit the DOC SYNC REPORT + PATCH PLAN — no writes." -
GATE — present the report and run the DOC SYNC — VALIDATION GATE from the agent's DISPATCHER PROTOCOL (AUTO yes/select/cancel; HUMAN, CREATE, CLEAN per-item; README CREATE has no skip). Wait for explicit approval.
DOC SYNC: all docs current→ stop here. -
PATCH — re-dispatch:
Agent(subagent_type="doc-syncer")(sonnet pin) prompt: "MODE: patch." + the APPROVED PATCH PLAN verbatim (approved item lines + rendered drafts for approved CREATE items). ASHAPE ESCALATIONin its report → re-gate the named set here, then re-dispatch patch with the kept subset. -
COMMIT — from THIS loop per
$HOME/.claude/lib/doc-commit.md(surgical: only the report'sPATCHED_FILES, summary composed from itsCHANGE SUMMARYblock, never.claude//CLAUDE.md, no-op if nothing patched).