spec-writer

Featured

Create or refine spec-superflow planning artifacts. Invoke when the change is understood well enough to write proposal.md, specs/, design.md, and tasks.md.

Testing & QA 614 stars 59 forks Updated today MIT

Install

View on GitHub

Quality Score: 92/100

Stars 20%
93
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Spec Writer Create or refine planning artifacts when the change has moved beyond exploration. ## Required Inputs Read `.spec-superflow.yaml` (especially `dp_0_decisions`, `dp_0_confirmed`) and any existing planning artifacts. If `dp_0_confirmed` is not `true`, stop and route back to `workflow-start` for DP-0. ## Config Check Run: `npx --yes --package spec-superflow@0.12.0 ssf runtime config --get artifacts.order` — generate in configured order (default: proposal → specs → design → tasks). Run with `artifacts.skip` — skip any listed artifacts. ## Artifact Roles - `proposal.md`: why and scope - `specs/`: required behavior (testable) - `design.md`: architecture decisions and trade-offs (not line-by-line) - `tasks.md`: dependency-aware implementation steps ## Working Rules **Honor DP-0**: Read `dp_0_decisions`, respect confirmed constraints, don't silently expand scope. Pause on unconfirmed decisions. ### proposal.md Must state: problem, what changes, capabilities affected, impact areas. ### specs/ Every requirement must be testable. Use SHALL or MUST. Every requirement must have at least one `#### Scenario:` with WHEN/THEN. Group under ADDED/MODIFIED/REMOVED Requirements headers. ### design.md Must have: Context (current state, constraints, stakeholders), Goals, Decisions (Choice + Rationale + Alternatives considered), Risks And Trade-Offs. ### tasks.md Must include: - **File Structure**: all files with one-sentence responsibility (Create/Modify) - **Interfaces**:...

Details

Author
MageByte-Zero
Repository
MageByte-Zero/spec-superflow
Created
1 months ago
Last Updated
today
Language
JavaScript
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category