sdd-start

Creates a dated cycle folder and captures the raw problem statement in request.md.

1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/AngeloResplandes/harness-sdd --skill sdd-start-angeloresplandes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-start
Source: https://github.com/AngeloResplandes/harness-sdd/tree/main/sdd-start
Command: npx skills add https://github.com/AngeloResplandes/harness-sdd --skill sdd-start-angeloresplandes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Starting a feature or refactor without a written problem statement leads to plans built on assumptions. This Skill opens a new spec-driven development cycle by creating a properly dated cycle folder and writing the human's raw request into request.md, keeping the problem separate from any solution. ## Core Features & Use Cases - Cycle Folder Creation: Builds a folder named cycles/Q{quarter}{year}/{MMDD}-{slug}/ using the real system date and a kebab-case capability slug. - Request Capture: Writes request.md from a template with Context, Intent, Taste/Constraints, References, and Attachments sections, preserving the human's own wording without inventing content. - State Guardrails: Detects unfinished prior cycles, duplicate folders, and trivial requests (typo fixes, dependency bumps) that do not need a cycle at all. - Use Case: You say "preciso de uma tela com os episódios do paciente em timeline" and the Skill creates cycles/Q32026/0726-episodes-list-webcomponent/request.md with your request written up for your review before any planning begins. ## Quick Start Ask the assistant to open a new SDD cycle and describe the feature or problem you want to work on in your own words.

Frequently Asked Questions about sdd-start

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

FAQPage Schema
How do I start a new spec-driven development cycle?

Describe the feature, refactor, or bugfix you want in plain language. The Skill creates a folder like cycles/Q32026/0726-episodes-list-webcomponent/ and writes your request into request.md for you to review and correct before any planning happens.

What goes into request.md in an SDD cycle?

request.md holds only the raw problem statement: Context, Intent, Taste/Constraints, References, and Attachments. It must never contain plans, tasks, file lists, or acceptance criteria, because those are produced later by the refine phase.

When should I not open an SDD cycle?

Skip the cycle for trivial work like a one-line typo fix, a dependency bump, a question about existing code, or exploratory spiking. The Skill itself recognizes these cases and does the work directly instead of applying ceremony.

What happens if a previous cycle was left unfinished?

The Skill checks whether the newest cycle folder lacks a passing validation.md or a checked promote task. If so, it asks whether your request is a continuation of that cycle or a genuinely new one, instead of silently stacking cycles.

How is the cycle folder name and date generated?

The date comes from the actual system clock via Get-Date or date +%F, never inferred from conversation. The quarter derives from the calendar month, and the slug is a kebab-case capability name, not a ticket number like JIRA-4412.