Does this skill help with technical architecture decisions?

Yes, it includes scripts to log and find decisions, ensuring that architectural choices are documented alongside the requirements they support.

What is the final output of the Spec Writer skill?

The final output is a comprehensive, validated SPEC.md file containing prioritized user stories, acceptance scenarios, edge cases, and specific measurable requirements.

How does Spec Writer manage state in Claude Code?

It uses a dedicated discovery directory containing SPEC.md for graduated stories, STATE.md for active work, and OPEN_QUESTIONS.md for blockers, all managed via automated helper scripts.

What is discovery-driven specification?

It is a methodology where user stories and requirements emerge from deep problem exploration rather than being predefined. This prevents gaps in logic and ensures the solution truly addresses the root problem.

Can I revise a story after it has been graduated?

Yes. Spec Writer follows a mutable graduation philosophy where graduated stories can be flagged for revision if later discovery reveals new dependencies or conflicts.

Spec Writer

Name: Spec Writer
Author: aaronbassett

byaaronbassett

0•

Productivity & Workflow

Guides users through a structured, discovery-driven process to transform feature ideas into comprehensive, implementation-ready specifications.

Spec Writer is a specialized skill for Claude Code that moves beyond simple prompt engineering to provide a rigorous framework for requirements analysis. Instead of starting with predefined user stories, it utilizes a discovery-driven philosophy where requirements emerge from a deep understanding of the problem space. The skill manages a dedicated discovery directory with automated scripts to track open questions, log architectural decisions, and graduate stories from a working state into a finalized specification (SPEC.md). This ensures that the resulting documentation is unambiguous, prioritized, and detailed enough for immediate development without further clarification.

Key Features

010 GitHub stars

02Automated state management for tracking in-flight work and blockers

03Integrated validation scripts to ensure specification quality and coverage

04Story graduation protocol for iterative requirements development

05Structured four-phase discovery workflow (Exploration to Refinement)

06Comprehensive directory architecture for decisions, research, and revisions

Use Cases

01Transforming high-level feature requests into technical requirements

02Managing stakeholder discovery sessions with structured output

03Mapping complex problem spaces before writing a single line of code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aaronbassett/aaronbassett-marketplace specs-workflow

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Automated state management for tracking in-flight work and blockers

03Integrated validation scripts to ensure specification quality and coverage

04Story graduation protocol for iterative requirements development

05Structured four-phase discovery workflow (Exploration to Refinement)

06Comprehensive directory architecture for decisions, research, and revisions

Use Cases

01Transforming high-level feature requests into technical requirements

02Managing stakeholder discovery sessions with structured output

03Mapping complex problem spaces before writing a single line of code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aaronbassett/aaronbassett-marketplace specs-workflow

For use in Claude.ai and ChatGPT