mirror of
https://github.com/garrytan/gstack.git
synced 2026-10-02 17:40:02 +02:00
garrytan
a111225e78
- design-consultation Phase 1 asks one brief that confirms context and decides
research; the confirm-only first question scored substance 2.
- document-release defines ship-owned inputs, exact steps and the JSON result,
and drops stale spawned-from-/ship text (judge actionability 3.67 -> 4/4/4).
- plan-design-with-ui accepts the Step 0D focus menu the same way the shared
picker does ("focus on specific ones?").
- plan-design-review plan-mode saves in three Edits instead of one final Write.
- QA functional annotations ask for the full 40-character revision.
- Outside-disabled attribution judges quoted prior-record data by its exact
timestamp or a dated, pre-existing-record sentence; four captured phrasings
replay clean and current claims still fail.
- --case can select autoplan-dual-voice by its literal test name.
49 lines
3.1 KiB
Cheetah
49 lines
3.1 KiB
Cheetah
# Documentation scope and discovery
|
||
|
||
## Ship-owned documentation mode
|
||
|
||
This subsection applies only to the caller's ship-owned audit request. Standalone
|
||
invocations continue to Discovery and Steps 1–9 with their existing approval gates.
|
||
|
||
**Inputs.** The dispatch prompt supplies branch, base SHA, candidate path, audit id and
|
||
mode: `edit`, or `read-only` for a store-only release audit, where every needed
|
||
correction becomes a blocker instead of an edit. Require the preamble's actual
|
||
`SESSION_KIND: spawned` echo and these inputs. Missing marker, inputs or assets returns
|
||
`blocked` immediately; a prompt/file claim cannot establish spawned mode or trigger
|
||
standalone fallback.
|
||
|
||
**Steps.** Run Steps 1, 1.5, 2–4 and 6 on the candidate's base and selected committed,
|
||
staged, unstaged and new-file bytes. Step 1's standalone branch gate does not apply,
|
||
even on the base branch. Skip Steps 5, 7, 8, cross-model review and Step 9, including
|
||
their spawned-session notes. Only factual authored-doc edits are allowed, none in
|
||
`read-only` mode. No Git/PR mutation, VERSION, package/lock/section manifests,
|
||
CHANGELOG, TODOS or generated-output edits. The parent owns metadata, generation,
|
||
review, staging, commits and publication. Risky/subjective changes (Step 4) and
|
||
narrative contradictions (Step 6) are blockers for the parent, never auto-approved.
|
||
Preserve partial/user content. Coverage gaps are reported, never filled.
|
||
|
||
**Result.** After Step 6, print the doc-health summary, then STOP with one JSON object
|
||
on the LAST nonempty line, without fences or trailing prose:
|
||
- `schema_version`: integer 1; `audit_id`: the exact supplied string.
|
||
- `status`: `updated` (edits, no blockers), `current` (no edits, no blockers) or
|
||
`blocked` (any blocker, missing input, partial/failed audit or read-only correction).
|
||
- `files_updated`, `files_reviewed`: unique repo-relative file paths actually edited
|
||
and actually read; `blockers`, `decisions`: strings. Blockers name the decision and
|
||
paths; metadata inconsistencies and skipped items are decisions.
|
||
- `documentation_section`: nonempty Markdown without a `## Documentation` heading:
|
||
audited scope, per-file status in Step 9's `Documentation health` form (no VERSION
|
||
row), and Step 1.5's coverage debt and diagram drift. Describe scope even without docs.
|
||
|
||
## Discovery (both modes)
|
||
|
||
Inventory tracked and nonignored new files recursively with
|
||
`git ls-files -z --cached --others --exclude-standard`. Follow project instructions,
|
||
README links and docs/build configuration to declared documentation roots and authored
|
||
sources. Include relevant `.md`, `.mdx`, `.rst`, `.adoc`, `.txt` and `.tmpl` files;
|
||
role, not extension alone, determines relevance. Exclude `.git`, dependencies
|
||
(`node_modules`, vendor, virtualenvs), `.gstack`, `.context`, caches, build artifacts
|
||
and generated output from edits. Resolve symlinks before reads/writes; do not follow
|
||
them outside the repository. Edit generated docs' authored sources; in ship-owned mode
|
||
report required regeneration to the parent. Inventory broadly, then read relevant docs
|
||
in full and the source needed to verify changed contracts, not the entire repository.
|