feat: v1.8.1 — copy-ready stage-handoff block at every skill's finish#4
Merged
Conversation
Each skill now ends by emitting a copy-ready handoff block (canonical format in skills/_shared/handoff.md): What I did + Review before continuing (links to the files it wrote) + Run next (/clear, then the next /sdd-… command in a fenced block). Replaces the bare "Next: …" line — the user sees what changed, which files to review at the gate, and what to run next without scrolling back. Variants: backbone forward (/clear + next stage), loop-back (review→implement, no /clear), terminal (ship → PR link), utility (resume your stage, /clear optional). All 16 skills updated; README documents it; manifests → 1.8.1. validate_plugin.py: 177 checks pass. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…surfacing config gaps) Two config artifacts were read across stages but produced only late / out-of-band, so a missing one surfaced as a silent default deep in the pipeline: - .size: now established by `specify` at the start (classify via the shared size-matrix + write it if absent), so design…plan-tests read a real size instead of silently defaulting to M — the gap that only showed at plan-tests. The handoff block now states the feature_size used (and flags a default loudly). - .claude/sdd.local.md: auto-created early (normally `specify`, not implement-only) with documented, self-documenting defaults — the frontmatter + the «What each key does» body, every key's allowed values explained inline — and `.gitignore` is patched (`.claude/*.local.md` covers it). interview-depth/settings/implement/README reconciled; classify-size stays the re-classify utility. validate_plugin.py: 177 checks pass; 302 markdown links resolve. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Owner
Author
|
Second commit
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Every skill now ends by emitting a copy-ready handoff block instead of a bare «Next: …» line. Canonical format in new
skills/_shared/handoff.md; each skill keeps a one-line pointer + supplies its own content.The block (sectioned):
/sdd-
Fixes the complaint that the per-gate output was poor and hard to copy/verify: you now see what changed, which files to open at this gate (real paths), and what to run next (
/clear+ a fenced, one-click-copy/sdd-…command) without scrolling back.Variants
survey → … → ship):/clearmandatory + next stage.review → implementon CHANGES): no/clear(stay in context to iterate).ship): no/sddsuccessor — PR link + «merge is your call».classify-size/glossary/decide-adr/roadmap): «resume your stage»,/clearoptional.Changes
skills/_shared/handoff.md— the format, the four variants, a canonical stage→review-files→next sequence table, the discipline.handoffin the_sharedlist.Verification
python3 scripts/validate_plugin.py→ 177 checks pass; manifests agree on 1.8.1.handoff.mdlinks resolve; the block shape is canonical tohandoff.mdonly (no skill hard-codes it).🤖 Generated with Claude Code