fix(#3440): retire GAP CLOSURE PLANS CREATED marker, document artifact return contract (#3443)

* fix(#3440): retire GAP CLOSURE PLANS CREATED marker, document artifact return contract

* chore(#3440): backfill changeset pr number

* docs(#3440): mark changeset docs-exempt with audit reason

---------

Co-authored-by: sim <sim@local>
This commit is contained in:
Tom Boucher
2026-08-14 09:20:50 -04:00
committed by GitHub
parent 6b34557ba3
commit 43475a2e0f
4 changed files with 36 additions and 10 deletions

View File

@@ -162,24 +162,18 @@ Derive plans from actual work. Granularity determines compression tolerance, not
Run `/clear` first for a fresh context window, then execute: `/gsd:execute-phase {phase}`
```
## Gap Closure Plans Created Return Format
## Gap Closure Return (artifact-based — #3440)
```markdown
## GAP CLOSURE PLANS CREATED
Gap-closure completion has **no completion marker**: nothing consumes one. The return contract is the artifacts themselves — `verify-work.md` spawns you in `--gaps` mode, and your output is complete when the fix plans are on disk carrying `gap_closure: true` in their frontmatter; the spawning workflow detects the files (never a return string), and `/gsd:execute-phase {phase} --gaps-only` consumes them. (The former `GAP CLOSURE PLANS CREATED` completion marker was retired as vestigial — it had no dispatch branch anywhere.)
**Phase:** {phase-name}
**Closing:** {N} gaps from {VERIFICATION|UAT}.md
### Plans
| Plan | Gaps Addressed | Files |
|------|----------------|-------|
| {phase}-04 | [gap truths] | [files] |
### Next Steps
Execute: `/gsd:execute-phase {phase} --gaps-only`
```
**Next step for the orchestrator:** `/gsd:execute-phase {phase} --gaps-only`
## Checkpoint Reached / Revision Complete