Skip to content

guided-complete-slice

guided-complete-slice closes out a completed slice in the guided (user-facing) workflow. It performs the same operations as the auto-mode complete-slice prompt: compress all task summaries into {sliceId}-SUMMARY.md, produce {sliceId}-UAT.md with the UAT Type and Not Proven By This UAT sections explicitly filled in, review task summaries for key_decisions and ensure significant ones land in .gsd/DECISIONS.md, mark the slice checkbox done in the roadmap, and update the milestone summary. The system handles commit and merge after the unit completes — the agent does not commit or merge manually.

The slice summary is the primary record of what was built. Downstream agents — reassess-roadmap, future slice researchers, and plan generators — read it to understand what this slice delivered and what to watch out for. Because downstream context depends on this artifact, the summary must be substantive: what was built, key decisions made, and anything that remains unproven by the UAT.

The prompt is a compact dispatch: one instruction block followed by {inlinedTemplates}, which supplies the Slice Summary and UAT output templates inline so the agent has the exact format contract at hand.

The /gsd command’s guided flow presents the user with contextual next-action options after all tasks in a slice are done. When the user selects “complete”, guided-complete-slice is dispatched. The resulting summary artifacts are identical in format to auto-mode outputs and are consumed by the same downstream agents.

VariableDescriptionRequired
sliceIdSlice identifier being completed (e.g. S01)Yes
sliceTitleHuman-readable title of the slice being completedYes
milestoneIdCurrent milestone identifier (e.g. M001)Yes
workingDirectoryAbsolute path to the project working directoryYes
skillActivationInjected skill-loading instruction block; activates any skills relevant to the completion contextYes
inlinedTemplatesSlice Summary and UAT output template content inlined directly into the promptYes
  • /gsd — dispatched when the user selects “complete” for a finished slice in guided (interactive) mode