Repository navigation
Add hone stage, SPDD pipeline completion, and example artifact trail - #16
Merged
Merged
Conversation
…d example Release readiness - Collapse CHANGELOG into a single [0.1.0] section; add a tag-triggered Release workflow that publishes the GitHub Release from that section - Pin vendor/spec-kit to the v1.0.5 tag; README vendored-submodules table now names the real pins (superpowers v6.3.0, spec-kit v1.0.5) - CI fails unless each submodule pointer sits on an upstream tag named in the README, and unless every upstream superpowers skill is KEEP in install.sh or a DENY row in the README; Dependabot head-commit bumps fail by design install.sh - Exit non-zero when any link could not be placed (non-damascus path in the way, or a target that no longer exists); link() refuses missing targets - Pure-bash relative-path computation replaces realpath --relative-to, so stock macOS no longer gets absolute symlinks that break on a fresh clone - Sourcing guard so CI reads the name arrays from the script instead of duplicating them; smoke test covers relative links, DENY skills, and the skipped-link exit code Skill contracts - Move using-superpowers and subagent-driven-development to DENY: both route into already-DENY skills (brainstorming, requesting-code-review) - anvil: portable DAMASCUS path lookup (no readlink -f) - quench: dispatch table states the shipped agents' Python/FastAPI shape and how another stack binds to the same contract - smithy: effort frontmatter; every state-machine row decidable from disk (quench-log green per task, FINISH line in smithy-log.md) - Trim tdd-test-generator, fastapi-implementer and playwright-e2e-tester to their contracts plus one example per concept (2035 -> 624 lines) Docs - examples/cart-discounts: one feature's full artifact trail through all five gates, checked for completeness in CI; README "which stage do I start at?" table; requirements name the agents' stack; bug template lists hone; CLAUDE.md bump policy and release ritual updated Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhCxRx3NtQvWL2nYu2GuYD
…e PR Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhCxRx3NtQvWL2nYu2GuYD
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HhCxRx3NtQvWL2nYu2GuYD
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
2 participants
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.
Summary
This PR completes the SPDD pipeline by adding the hone stage (adversarial code review between quench and merge), restructures agent guidance to enforce the test-freeze contract, and includes a complete example artifact trail showing one feature's journey through all five stages.
Key Changes
Pipeline Completion
skills/hone/SKILL.md) — local adversarial review with three critic lenses (conformance, security, simplicity), mandatory active procedures, ≤400-line review units, A++ rating requires two consecutive zero-blocking rounds, max 3 rounds totalhoneto the stage skill list ininstall.shand CI validationAgent Guidance Hardening
tasks.md, not speculativelyExample Artifact Trail
examples/cart-discounts/— a complete, real-run feature (cart discount codes: percentage/fixed codes, expiry, single-use per customer, Safeguard property test) with all pipeline artifacts:.prd/001_cart-discount-codes.md— REASONS Canvas PRD (forge output)specs/001-cart-discount-codes/spec.md— 3 user stories, 5 FRs, acceptance scenarios (anvil output)specs/001-cart-discount-codes/plan.md— REASONS Canvas implementation plan (anvil output)specs/001-cart-discount-codes/tasks.md— 6 tasks with file paths, FR traceability, gates (anvil output)specs/001-cart-discount-codes/quench-log.md— BDD scenarios, test counts, failure messages, gate results (quench output)specs/001-cart-discount-codes/code-review.md— 3 rounds of adversarial review, blocking/nit counts, judge verdicts (hone output)specs/001-cart-discount-codes/review.md— spec-level adversarial review (temper output)specs/001-cart-discount-codes/smithy-log.md— pipeline orchestration log (smithy output)examples/README.mdexplaining the trail and layoutCI & Release
.github/workflows/ci.ymlto validate all skills, aliases, agents, and KEEP superpowers frominstall.sh(sourced, not executed, so renames on disk and in script must agree).github/workflows/release.yml— publishes GitHub Releases from semver tags, extracting changelog section verbatim.github/dependabot.ymland.github/ISSUE_TEMPLATE/bug_report.mdtohttps://claude.ai/code/session_01HhCxRx3NtQvWL2nYu2GuYD