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

•

Productivity & Workflow

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

About

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.

Key Features

Structured 7-phase development lifecycle management
Standardized output templates for PRDs, ADRs, and research reports
Integrated best practices for TDD, BDD, and incremental delivery
Automated workflow transition commands (e.g., /flow:assess, /flow:plan)
5 GitHub stars
Heuristics for evaluating feature complexity and methodology suitability

Use Cases

Managing complex architectural changes that require formal decision records (ADRs)
Reducing technical debt by ensuring rigorous validation and documentation phases
Standardizing the engineering process for teams using AI coding assistants

About

Key Features

Structured 7-phase development lifecycle management
Standardized output templates for PRDs, ADRs, and research reports
Integrated best practices for TDD, BDD, and incremental delivery
Automated workflow transition commands (e.g., /flow:assess, /flow:plan)
5 GitHub stars
Heuristics for evaluating feature complexity and methodology suitability

Use Cases

Managing complex architectural changes that require formal decision records (ADRs)
Reducing technical debt by ensuring rigorous validation and documentation phases
Standardizing the engineering process for teams using AI coding assistants