bastien
d82c06f572
One ask policy; mandated executors exempt from the delegation rule; skill plan satisfies the planning rule; journal line exempt from the approval gate; chore = maintenance without new behaviour; small fix on develop = bugfix; BDR-068 written as the one auto-finish exception; deploy routes to /deploy. Skills and agents follow: hotfix types by base + skips the design gate on trivial; capitalize/close create missing registries; commit-change asks the branch type; doc/seo/web-validate/refactor branch through the aiguillage; tour reports BREAKING fixes as needs-decision and runs doc-syncer two-mode; client-handover applies audit bundles from its main loop behind one gate; init-project/onboard use the 200-file graphify signal and bootstrap memory; release-candidate gates the tag push only; push wording aligned with the BDR-095 hooks; stale pointers fixed (§ Language, .gsd/ROADMAP.md, handover script path, design-gate lists).
2.1 KiB
name, description, argument-hint, allowed-tools
| name | description | argument-hint | allowed-tools | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| doc | 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).