Your AI writes code fast. The reasons disappear into chat. sdd is a small CLI that keeps short notes next to your code — so you, your team, and the agent stay aligned.
Install from npm: @structured-vibe-coding/cli
npm install -g @structured-vibe-coding/cli
cd your-app
sdd init --here --ai copilot # or: grok | claude | ollama
sdd new "Fix empty list crash" -w hotfix -y --no-agent
# open the intent.md path it prints → paste a few real sentences →
sdd next --no-agentFull walkthrough with a paste-ready example: Start in 10 minutes.
Learning tip
Add --no-agent the first time. You learn the process without the AI window popping up. Drop the flag later when you want the agent to help.
| I want to… | Open this |
|---|---|
| Learn sdd right now | Start in 10 minutes |
| Understand what it is | What is sdd? |
| Build a new product from an idea | New product (greenfield) |
| Add a feature to my app | Simple feature |
| Do serious / multi-team work | Enterprise path |
| See the daily commands | Everyday loop |
| Attach org design system / AST MCP | MCP sources |
| Slice this repo’s TypeScript with AST | Code context |
| Look up a command | CLI reference |
| Need | Detail |
|---|---|
| Node.js | 20 or newer (24 is nice) |
| CLI package | @structured-vibe-coding/cli on npm |
| An AI tool | One of: GitHub Copilot, Grok, Claude Code, or Ollama |
| Time | About 10 minutes for the first loop |
| Editor | Whatever you already use |
You get a folder under changes/ with a short write-up of the work, a status that moves when you run sdd next, and a habit your AI can follow next time.
Ready for the daily rhythm? → Everyday loop