sdd-architect

Enforce Specification-Driven Development by drafting specs and implementation plans before coding.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/mr-phariyawit/startup --skill sdd-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-architect
Source: https://github.com/mr-phariyawit/startup/tree/main/skills/sdd-architect
Command: npx skills add https://github.com/mr-phariyawit/startup --skill sdd-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces a disciplined, plan-first approach to software work by preventing coding without an approved specification and plan.

Core Features & Use Cases

  • Drafts a formal specification document for new features (docs/specs/[feature_name].md) including goals, user stories, and technical constraints.
  • Produces an implementation plan with sections: # Goal Description, ## User Review Required, ## Proposed Changes, and ## Verification Plan, to guide safe, auditable progress.
  • Acts as a governance gate to halt progress until the plan is approved, ensuring alignment with GEMINI rules and the 9 Articles.

Quick Start

Describe your feature in detail and allow this skill to generate the spec and implementation plan before any coding begins.

Frequently Asked Questions about sdd-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent cowboy coding when stakeholders request vague new features?

Prevent cowboy coding by enforcing a specification-driven development workflow that gates implementation behind a formal plan. This governance process requires drafting a specification and an implementation plan that must pass a review decision gate before any coding begins.

What is specification-driven development and how does it govern feature planning?

Specification-driven development is a plan-first governance workflow that halts progress until an implementation plan is approved. It satisfies requirements for a drafting phase, explicit implementation plan sections, and a decision gate to ensure safe, auditable progress.

How do I generate a formal specification document for a new software feature?

Generate a formal specification document by describing your feature in detail to trigger the drafting phase. The process produces a spec file including goals, user stories, and technical constraints to guide development before an implementation plan is created.

What sections are required in an implementation plan for auditable progress?

An implementation plan for auditable progress requires specific sections: Goal Description, User Review Required, Proposed Changes, and Verification Plan. These sections ensure safe, governed execution before the decision gate allows implementation to begin.

When do I need a decision gate review before starting software implementation?

You need a decision gate review whenever stakeholders request new features or changes without an existing plan, or when requirements are vague. This gate requires explicit review and approval of the specification and implementation plan before any implementation begins.

Can I start coding immediately if my feature requirements are ambiguous?

You cannot start coding immediately with ambiguous requirements because the governance workflow halts progress. It enforces a drafting phase to clarify goals, user stories, and technical constraints, followed by a mandatory decision gate requiring plan approval before implementation.