How do I move a task from assessment to implementation?

The skill uses a state machine logic. You transition through phases using commands like /flow:assess, /flow:specify, /flow:research, and /flow:plan before reaching the implementation state.

Does this skill work for small bug fixes?

The 'Assess' phase helps you decide the appropriate level of rigor. For simple tasks, it may recommend a 'Skip SDD' or 'Spec-Light' path to maintain velocity without unnecessary overhead.

What documentation does this skill help create?

It guides the creation of Assessment Reports, Product Requirement Documents (PRDs), Architecture Decision Records (ADRs), Research Reports, and QA/Security validation checklists.

What is the primary benefit of the SDD Methodology skill?

It enforces a 'specification first' approach, ensuring that requirements and technical designs are fully understood and documented before implementation begins, which significantly reduces rework and architectural errors.

SDD Methodology Guide

Name: SDD Methodology Guide
Author: jpoley

byjpoley

•

生产力与工作流

Implements a structured Spec-Driven Development workflow to guide AI-assisted engineering from initial assessment to production deployment.

The SDD Methodology skill provides a comprehensive framework for Spec-Driven Development (SDD), ensuring that AI-assisted software engineering is deliberate, well-documented, and high-quality. It guides developers through seven distinct phases—Assess, Specify, Research, Plan, Implement, Validate, and Operate—using specific commands to manage state transitions. This skill helps teams avoid common anti-patterns like 'Big Bang' implementations and documentation debt by enforcing a specification-first approach and architectural planning before a single line of feature code is written.

主要功能

01Structured 7-phase development lifecycle management

02Standardized output templates for PRDs, ADRs, and research reports

03Integrated best practices for TDD, BDD, and incremental delivery

04Automated workflow transition commands (e.g., /flow:assess, /flow:plan)

055 GitHub stars

06Heuristics for evaluating feature complexity and methodology suitability

使用场景

01Managing complex architectural changes that require formal decision records (ADRs)

02Reducing technical debt by ensuring rigorous validation and documentation phases

03Standardizing the engineering process for teams using AI coding assistants

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoley/flowspec sdd-methodology

For use in Claude.ai and ChatGPT