{"id":43442118,"url":"https://github.com/fall-out-bug/sdp","last_synced_at":"2026-02-19T13:01:00.429Z","repository":{"id":331157322,"uuid":"1124353553","full_name":"fall-out-bug/sdp","owner":"fall-out-bug","description":"Structured protocol for AI-assisted development. Discovery → Delivery → Evidence.","archived":false,"fork":false,"pushed_at":"2026-02-17T13:19:37.000Z","size":5361,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-17T13:42:59.896Z","etag":null,"topics":["ai-agents","claude-code","code-quality","cursor","developer-tools","evidence","opencode","orchestration","provenance","tdd"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fall-out-bug.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/roadmap/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-28T21:40:37.000Z","updated_at":"2026-02-17T13:00:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fall-out-bug/sdp","commit_stats":null,"previous_names":["fall-out-bug/consesus","fall-out-bug/sdp"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/fall-out-bug/sdp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fall-out-bug%2Fsdp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fall-out-bug%2Fsdp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fall-out-bug%2Fsdp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fall-out-bug%2Fsdp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fall-out-bug","download_url":"https://codeload.github.com/fall-out-bug/sdp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fall-out-bug%2Fsdp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29614585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T10:52:55.328Z","status":"ssl_error","status_checked_at":"2026-02-19T10:52:26.323Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","code-quality","cursor","developer-tools","evidence","opencode","orchestration","provenance","tdd"],"created_at":"2026-02-02T22:32:57.686Z","updated_at":"2026-02-19T13:01:00.424Z","avatar_url":"https://github.com/fall-out-bug.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SDP: Spec-Driven Protocol\n\n**A structured protocol for AI-assisted development.**\n\nSDP turns your AI assistant into a predictable process: Discovery → Delivery → Evidence.\n\n## What it is\n\nSDP is a set of prompts (skills) that load into Claude Code, Cursor, or other AI tools. Skills define:\n\n- **Discovery**: How to gather requirements and plan features\n- **Delivery**: How to write code with TDD and quality gates\n- **Evidence**: How to record decisions in an audit log\n\n**Everything works through skills.** CLI and Beads are optional add-ons.\n\n## Quick Start\n\n**One-liner installer (recommended):**\n\n```bash\n# Install for all IDEs\ncurl -sSL https://raw.githubusercontent.com/fall-out-bug/sdp/main/install.sh | bash\n\n# Or specify your IDE\nSDP_IDE=claude curl -sSL https://raw.githubusercontent.com/fall-out-bug/sdp/main/install.sh | bash\nSDP_IDE=cursor curl -sSL https://raw.githubusercontent.com/fall-out-bug/sdp/main/install.sh | bash\n```\n\n**Supported IDEs:** `claude`, `cursor`, `opencode`, `all` (default)\n\n**Manual install:**\n\n```bash\ngit submodule add https://github.com/fall-out-bug/sdp.git sdp\necho \"sdp/.git\" \u003e\u003e .gitignore\n```\n\nSkills load automatically from `sdp/.claude/skills/` (Claude Code) or `sdp/.cursor/skills/` (Cursor).\n\n## Core Workflow\n\n### Discovery (planning)\n\n```\n@vision \"AI task manager\"      → VISION.md, PRD.md, ROADMAP.md\n@reality --quick               → Codebase analysis\n@feature \"Add authentication\"  → Workstreams for feature\n```\n\n### Delivery (implementation)\n\n```\n@oneshot F001                  → Autonomous execution of all workstreams\n@review F001                   → Multi-agent quality review\n@deploy F001                   → Merge to main\n```\n\n### Manual mode\n\n```\n@build 00-001-01               → Single workstream with TDD\n@build 00-001-02\n@review F001\n@deploy F001\n```\n\n### Debug\n\n```\n@debug \"Test fails\"            → Systematic debugging\n@hotfix \"API down\"             → Emergency fix (P0)\n@bugfix \"Wrong totals\"         → Quality fix (P1/P2)\n```\n\n## Skills\n\n| Skill | Purpose | Phase |\n|-------|---------|-------|\n| `@vision` | Strategic planning (7 agents) | Discovery |\n| `@reality` | Codebase analysis (8 agents) | Discovery |\n| `@feature` | Feature planning (@idea + @design) | Discovery |\n| `@idea` | Requirements gathering | Discovery |\n| `@design` | Workstream decomposition | Discovery |\n| `@oneshot` | Autonomous execution | Delivery |\n| `@build` | TDD for single workstream | Delivery |\n| `@review` | Quality review (6 agents) | Delivery |\n| `@deploy` | Deploy to main | Delivery |\n| `@debug` | Systematic debugging | Debug |\n| `@hotfix` | Emergency fix | Debug |\n| `@bugfix` | Quality fix | Debug |\n\n## Protocol Flow\n\n```\n@oneshot F001  →  @review F001  →  @deploy F001\n     │                 │                │\n     ▼                 ▼                ▼\nExecute WS       APPROVED?         Merge PR\n                    │\n                    ├─ YES → proceed\n                    └─ NO → fix loop\n```\n\n**Done = @review APPROVED + @deploy completed**, not just \"PR merged\".\n\n## Quality Gates\n\n| Gate | Requirement |\n|------|-------------|\n| TDD | Tests first |\n| Coverage | \u003e= 80% |\n| File size | \u003c 200 LOC |\n| Architecture | No layer violations |\n\n## Workstream ID\n\nFormat: `PP-FFF-SS`\n\n- `PP` — Project (00 = SDP itself)\n- `FFF` — Feature number\n- `SS` — Step number\n\nExample: `00-024-03` = SDP, feature 24, step 3\n\n## Project Structure\n\n```\nyour-project/\n├── sdp/                      # SDP submodule\n│   ├── prompts/skills/       # Skills (source of truth)\n│   ├── prompts/agents/       # Agent definitions\n│   ├── .claude/              # Claude Code integration\n│   ├── docs/                 # Documentation\n│   └── CLAUDE.md             # Quick reference\n└── docs/workstreams/         # Your workstreams\n```\n\n---\n\n# Optional Components\n\n## Go CLI (experimental)\n\nCLI provides helper commands. **Not required for protocol to work.**\n\n```bash\n# Install\ncd sdp/sdp-plugin \u0026\u0026 go build -o sdp ./cmd/sdp\n\n# Commands\nsdp doctor              # Health check\nsdp status              # Project state\nsdp guard activate WS   # Edit scope enforcement\nsdp log show            # Evidence log\n```\n\n## Beads (experimental)\n\nTask tracking for multi-session work. **Not required.**\n\n```bash\nbrew tap beads-dev/tap \u0026\u0026 brew install beads\nbd ready                # Find available tasks\nbd create --title=\"...\" # Create task\nbd close \u003cid\u003e           # Close task\n```\n\n## Evidence Layer (experimental)\n\nAudit log in `.sdp/log/events.jsonl` with hash-chain.\n\n```bash\nsdp log show            # Show events\nsdp log trace           # Trace by commit/workstream\n```\n\n---\n\n## Documentation\n\n| File | Content |\n|------|---------|\n| [CLAUDE.md](CLAUDE.md) | Quick reference for Claude Code |\n| [docs/PROTOCOL.md](docs/PROTOCOL.md) | Full specification |\n| [docs/vision/ROADMAP.md](docs/vision/ROADMAP.md) | Roadmap and milestones |\n| [CHANGELOG.md](CHANGELOG.md) | Version history |\n\n## License\n\nMIT\n\n---\n\n**GitHub:** [fall-out-bug/sdp](https://github.com/fall-out-bug/sdp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffall-out-bug%2Fsdp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffall-out-bug%2Fsdp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffall-out-bug%2Fsdp/lists"}