← ClaudeAtlas

documentlisted

Generate minimal documentation through parallel agents
bitcraft-apps/spec-first · ★ 4 · Data & Documents · score 73
Install: claude install-skill bitcraft-apps/spec-first
# Document Command Creates minimal, proportional documentation. Match doc weight to change weight. One agent does the steps in order. ## Usage ``` /sf:document [SPECIFICATION_AND_IMPLEMENTATION_PATHS] ``` ## Context Read `.sf/implementation-summary.md` if it exists. ## Input Resolution 1. If `$ARGUMENTS` is non-empty: use it as the artifact and implementation paths 2. Else if `.sf/spec.md` and `.sf/implementation-summary.md` exist: use them 3. Else: ask the user where the artifacts are. Wait for the answer. ## Execution Write each file in turn. All paths are under `$SF_DIR/research/`. 1. `artifacts-summary.md` — the requirements and outcomes in the artifacts. Read only what exists. 2. `implementation-summary.md` — the real code structure: the main files, the changed interfaces. 3. `docs-inventory.md` — every existing doc as `filepath | primary topic`, from the headings only. **Gate 1 — Post-Analysis:** run `scripts/doc-gates.sh analysis`, in this skill directory. **If doc-gates.sh fails (non-zero exit), halt immediately — do not write the documents.** 4. `technical-docs.md` — what a developer needs to use or extend the change. Skip any section that does not apply. 5. `user-docs.md` — only what the user must do differently. Skip it if the change is invisible. An empty file is a valid result. It means the change does not need that document. **Gate 2 — Post-Generation:** run `scripts/doc-gates.sh generation`. **If doc-gates.sh fails (non-zero exit), halt immediat