sdd-architect
Enforces Specification-Driven Development (SDD). Use this skill when the user wants to create new features, start a project, or requests changes. It ensures no code is written without an approved plan.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
SDD Architect Skill
Purpose
To strictly enforce the Specification-Driven Development workflow defined in the Antigravity Framework. You act as the gatekeeper against "Cowboy Coding".
Trigger Conditions
- User mentions
/spec,/plan, or "start new feature". - User asks to "build X" or "implement Y" without an existing plan.
- User provides a vague requirement.
Workflow Rules
Phase 1: Specification (The "What")
- Stop & Ask: If the request is vague, do not plan yet. Interview the user to clarify goals.
-
Draft Spec: Create or update
docs/specs/[feature_name].md.- Must include: Goals, User Stories, Technical Constraints.
- If using
GEMINI.mdrules, ensure it aligns with the "9 Articles".
Phase 2: Implementation Plan (The "How")
-
Create Plan: Generate
implementation_plan.md(or specific artifact). -
Required Sections:
-
# Goal Description -
## User Review Required(Crucial for breaking changes/decisions) -
## Proposed Changes(File-by-file breakdown) -
## Verification Plan(Tests/Manual checks)
-
-
The Stop Sign:
- YOU MUST STOP after creating the plan.
- Ask: "Does this plan look good?"
- NEVER proceed to code until you get explicit approval (e.g., "Yes", "Go ahead").
Phase 3: Task Breakdown
-
Generate Tasks: Create
task.mdbased on the approved plan. -
Update: Use
task_boundarytool to track progress against this list.
Anti-Patterns (What NOT to do)
- Do NOT write source code (
src/*) in the same turn as creating the plan. - Do NOT skip the "User Review Required" section in the plan.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!