claude/skills/doc/SKILL.md at 0d717d9bfc662b9aee97c970d574d4879f844a43

Files

T

Bastien Chanot 18075a38db feat(agents): W2/S2 doc pipeline two-mode + last inline conversions (BDR-077)

doc-syncer: ONE agent, TWO dispatch modes around the dispatcher's gate —
MODE: audit (model="opus" call-site override, READ-ONLY, drafts + PATCH
PLAN) / MODE: patch (sonnet pin, applies the APPROVED plan, shape oracle
w/ revert-on-fail, emits CHANGE SUMMARY + PATCHED_FILES). Deviation from
plan's 2-file split, per the challenge's own commit-changer mode
precedent: zero text duplication, zero lock moves. Fixes a LATENT DEFECT:
/doc dispatched an agent whose STEP 8 gate could never fire (dispatched
agents cannot ask) — the gate now lives in the dispatcher (DISPATCHER
PROTOCOL section). doc-commit.md consumes the patcher's CHANGE SUMMARY
(the in-thread context now crosses the dispatch boundary, LRN-126).
Consumers rewired: /doc (audit→gate→patch→commit), onboard (audit
report-only, opus), doc-commit steps in bugfix/hotfix/feat/ship-feature/
init-project(5b+10c); scaffolder loses PHASE 6 (README = init 5b's job);
scaffolder + onboarder now DISPATCHED in init-project/onboard (pins live,
was inline on session model). In-wave planted-drift smoke PASSED
end-to-end, disk-verified (audit caught npm-run-dev drift → [MINOR] plan
→ patch applied → summary crossed). Census §14-15 (103 pass), make test
exit 0. Typed plugin-probe dispatch resolution verified post-restart.

2026-07-19 22:28:09 +02:00

1.7 KiB

Raw Blame History

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".

leave empty for full audit

or list specific files/docs to check

Read

Edit

Write

Bash

Grep

Glob

Agent

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):

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). A SHAPE ESCALATION in 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's PATCHED_FILES, summary composed from its CHANGE SUMMARY block, never .claude//CLAUDE.md, no-op if nothing patched).

1.7 KiB Raw Blame History

1.7 KiB

Raw Blame History