Does it support specific documentation formats?

Yes, it supports the OpenSpec format if an openspec directory exists, or standard technical design documents in docs/specs/ by default.

When should I use the stage-spec workflow?

Use it for new projects, major features, security-critical work, or any task involving high complexity or more than 15 implementation steps.

How does this skill handle technical validation?

It uses 'Meta-Testing,' which includes generating minimal code to test technical concepts (PoCs) and asking critical architectural questions to ensure scalability and simplicity.

What is the primary purpose of the stage-spec skill?

It manages the specification phase (Stage A) of development, ensuring technical requirements are documented, tested via PoC, and validated before implementation starts.

What happens once the specification is finalized?

The skill automatically suggests moving to Stage B (Implementation), offering to generate test cases and launch a TDD-driven development workflow.

Technical Specification & Validation Stage

Name: Technical Specification & Validation Stage
Author: TomazWang

byTomazWang

0•

Productivity & Workflow

Guides the creation and validation of detailed technical specifications, architecture designs, and proof-of-concept tests for complex features.

The stage-spec skill automates the critical planning phase of software development by facilitating a rigorous 'Stage A' specification workflow. It helps developers move from initial requirements to a validated Software Design Document (SDD) through a structured process involving Behavior-Driven Development (BDD) scenarios, Test-Driven Development (TDD) planning, and meta-testing. By generating minimal Proof of Concept (PoC) code to validate architectural assumptions before full implementation begins, this skill mitigates risks associated with security-critical features, high-complexity projects, and unknown technical constraints.

Key Features

01Structured BDD scenario mapping and TDD implementation planning

02Seamless transition prompts to implementation stages

03Automated OpenSpec and standard Software Design Document (SDD) generation

04Architectural complexity checks and mitigation strategies

050 GitHub stars

06Meta-testing through auto-generated PoC validation tests

Use Cases

01Designing security-critical functionality requiring pre-implementation validation

02Researching and validating technical feasibility for projects with unknown requirements

03Planning major architectural shifts or new high-risk project features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/agent-toolkit stage-spec

For use in Claude.ai and ChatGPT

Download Skill