{"_id":"@daniel-da-silva-alves/sddk","_rev":"4-2e67d123cfdf3f6b0fa557f7423a0ccb","name":"@daniel-da-silva-alves/sddk","dist-tags":{"latest":"2.5.0"},"versions":{"2.0.0":{"name":"@daniel-da-silva-alves/sddk","version":"2.0.0","keywords":["ai-agent","plugin","spec-driven","software-engineering","gemini","claude","srs","sdd","code-review","requirements","architecture","ieee-830","development-pipeline","ai-coding","specification"],"author":{"name":"SDDK Contributors"},"license":"MIT","_id":"@daniel-da-silva-alves/sddk@2.0.0","maintainers":[{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"}],"homepage":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit#readme","bugs":{"url":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit/issues"},"bin":{"sddk":"bin/cli.js"},"dist":{"shasum":"98e2bf3d624e343329e1b91860272a2c41384fec","tarball":"https://registry.npmjs.org/@daniel-da-silva-alves/sddk/-/sddk-2.0.0.tgz","fileCount":31,"integrity":"sha512-20KqaZtFT+Vro5zqAkYBpAkGnbJSI6tgtyb16Ko4TRlSDpWXZVLHBdP1PDsOr6EFRJk16HKqqHGWq4HKrRGnFA==","signatures":[{"sig":"MEQCICVBB2clsgIvVWn0Cfw0ITBpToMPHmb8SrZEP0Qm4B7dAiANHcDSuLHKBhxQ4foE9KW6dmM7RiTTwmHjhos9cxUmmw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":137394},"engines":{"node":">=18.0.0"},"scripts":{"test":"node bin/cli.js --version","validate":"node -e \"const p = require('./package.json'); console.log(p.name + '@' + p.version + ' ✓');\""},"_npmUser":{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"},"repository":{"url":"git+https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git","type":"git"},"_npmVersion":"10.9.3","description":"Spec-Driven Development Kit — An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline (SRS → SDD → Planning → Dev → Code Review).","directories":{},"_nodeVersion":"22.20.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sddk_2.0.0_1780414709249_0.9408691553585657","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@daniel-da-silva-alves/sddk","version":"2.1.0","keywords":["ai-agent","plugin","spec-driven","software-engineering","gemini","claude","srs","sdd","code-review","requirements","architecture","ieee-830","development-pipeline","ai-coding","specification"],"author":{"name":"SDDK Contributors"},"license":"MIT","_id":"@daniel-da-silva-alves/sddk@2.1.0","maintainers":[{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"}],"homepage":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit#readme","bugs":{"url":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit/issues"},"bin":{"sddk":"bin/cli.js"},"dist":{"shasum":"16d0bf5ba85bae4c75c34f4f83680cd260210195","tarball":"https://registry.npmjs.org/@daniel-da-silva-alves/sddk/-/sddk-2.1.0.tgz","fileCount":31,"integrity":"sha512-6xTD08624hydPedqnyDiRGThnireYS0nNCoxIjmhL1kvjJixjTVLvtK4TMhguGbEMIEJ7oBAw/5yHQEw8XKNYg==","signatures":[{"sig":"MEQCICMoHc+2ImDZuDf/0mCSb0Y4aeFy2qChSDdbhjbikZMrAiBPpW/Xj4VMcSjVz7naim5jIOzn5Ay1PtdxqqhlNzax9A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@daniel-da-silva-alves%2fsddk@2.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":135715},"engines":{"node":">=18.0.0"},"gitHead":"27911594440de73e3d3f9a0a3aa18b01dca31d72","scripts":{"test":"node bin/cli.js --version","validate":"node -e \"const p = require('./package.json'); console.log(p.name + '@' + p.version + ' ✓');\"","prepublishOnly":"node bin/cli.js --version && echo 'Pre-publish validation passed ✓'"},"_npmUser":{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"},"repository":{"url":"git+https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git","type":"git"},"_npmVersion":"10.9.8","description":"Spec-Driven Development Kit — An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline (SRS → SDD → Planning → Dev → Code Review).","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sddk_2.1.0_1780435295098_0.596639289336053","host":"s3://npm-registry-packages-npm-production"}},"2.4.0":{"name":"@daniel-da-silva-alves/sddk","version":"2.4.0","keywords":["ai-agent","plugin","spec-driven","software-engineering","gemini","claude","srs","sdd","code-review","requirements","architecture","ieee-830","development-pipeline","ai-coding","specification"],"author":{"name":"SDDK Contributors"},"license":"MIT","_id":"@daniel-da-silva-alves/sddk@2.4.0","maintainers":[{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"}],"homepage":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit#readme","bugs":{"url":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit/issues"},"bin":{"sddk":"bin/cli.js"},"dist":{"shasum":"470f7c417574d352b72cc20e3f183089a2091ea6","tarball":"https://registry.npmjs.org/@daniel-da-silva-alves/sddk/-/sddk-2.4.0.tgz","fileCount":40,"integrity":"sha512-5l51Ow09514GFP8maEWyL7fObZDsZLzmE/VjVjUprgcI7JmFBTKpC/JPQjvQDUqwogltFlU71WOfbfgC55q5uQ==","signatures":[{"sig":"MEYCIQDR/JAcDFSfFx04XnEmhqwZ+SjirmsSXSI+vBOQa2+VaAIhALZcvTj28N5XqgyvLLOEX/6zKb1dvWRtwKkwDR5B2I2R","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":213338},"engines":{"node":">=18.0.0"},"gitHead":"83ac4eb2a2c4c156a7a3ec7e55583864f3d2b059","scripts":{"test":"node bin/cli.js --version && node --test tests/validate-plugin.mjs","validate":"node -e \"const p = require('./package.json'); console.log(p.name + '@' + p.version + ' ✓');\"","prepublishOnly":"node bin/cli.js --version && echo 'Pre-publish validation passed ✓'"},"_npmUser":{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"},"repository":{"url":"git+https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git","type":"git"},"_npmVersion":"10.9.3","description":"Spec-Driven Development Kit — An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline (SRS → SDD → Planning → Dev → Code Review).","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sddk_2.4.0_1781641609231_0.27605757453723556","host":"s3://npm-registry-packages-npm-production"}},"2.5.0":{"name":"@daniel-da-silva-alves/sddk","version":"2.5.0","description":"Spec-Driven Development Kit — An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline (SRS → SDD → Planning → Dev → Code Review).","author":{"name":"SDDK Contributors"},"license":"MIT","keywords":["ai-agent","plugin","spec-driven","software-engineering","gemini","claude","srs","sdd","code-review","requirements","architecture","ieee-830","development-pipeline","ai-coding","specification"],"bin":{"sddk":"bin/cli.js"},"repository":{"type":"git","url":"git+https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git"},"homepage":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit#readme","bugs":{"url":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit/issues"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"scripts":{"test":"node bin/cli.js --version && node --test tests/validate-plugin.mjs","validate":"node -e \"const p = require('./package.json'); console.log(p.name + '@' + p.version + ' ✓');\"","prepublishOnly":"node bin/cli.js --version && echo 'Pre-publish validation passed ✓'"},"_id":"@daniel-da-silva-alves/sddk@2.5.0","gitHead":"7ba179950e00fc13ea098e61b6d54264c9f09466","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-w8q2bQgHk73J1dkLgJSZvXshC1W7axSYw05rWS0w8gIyvTLGqH5bwbYZ1O8KM8B8QLW4iFzY6B4NqrBwbnHWow==","shasum":"5f47d475d018ab36d30f7a4001cef6e39dcb2257","tarball":"https://registry.npmjs.org/@daniel-da-silva-alves/sddk/-/sddk-2.5.0.tgz","fileCount":40,"unpackedSize":214435,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC7jlA9J3IQDMOFiasSWhmh/fBxBf6+QJUMvtocHBz4CAIgWlqJdrt9i6OyiNf8lGzH1EImGuW8d/isautB0Q8gxWo="}]},"_npmUser":{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"},"directories":{},"maintainers":[{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sddk_2.5.0_1781644844034_0.1928665871998272"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T15:38:29.041Z","modified":"2026-06-16T21:20:44.302Z","2.0.0":"2026-06-02T15:38:29.418Z","2.1.0":"2026-06-02T21:21:35.251Z","2.4.0":"2026-06-16T20:26:49.405Z","2.5.0":"2026-06-16T21:20:44.192Z"},"bugs":{"url":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit/issues"},"author":{"name":"SDDK Contributors"},"license":"MIT","homepage":"https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit#readme","keywords":["ai-agent","plugin","spec-driven","software-engineering","gemini","claude","srs","sdd","code-review","requirements","architecture","ieee-830","development-pipeline","ai-coding","specification"],"repository":{"type":"git","url":"git+https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git"},"description":"Spec-Driven Development Kit — An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline (SRS → SDD → Planning → Dev → Code Review).","maintainers":[{"name":"daniel-da-silva-alves","email":"domhnalprofissional@gmail.com"}],"readme":"\r\n
\r\n\r\n\"SDDK\r\n\r\n# Spec-Driven Development Kit (SDDK)\r\n\r\n*An AI agent plugin that enforces disciplined software engineering through a 5-stage specification-driven pipeline.*\r\n\r\n[![npm](https://img.shields.io/npm/v/@daniel-da-silva-alves/sddk?style=flat-square&color=blue)](https://www.npmjs.com/package/@daniel-da-silva-alves/sddk)\r\n[![Plugin](https://img.shields.io/badge/type-AI_Agent_Plugin-8B5CF6?style=flat-square)]()\r\n[![Pipeline](https://img.shields.io/badge/stages-5_Skills-10B981?style=flat-square)]()\r\n[![Standard](https://img.shields.io/badge/spec-IEEE_830-3B82F6?style=flat-square)]()\r\n[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)\r\n\r\n[Overview](#overview) • [The Pipeline](#the-pipeline) • [Installation](#installation) • [Usage](#usage) • [Project Structure](#project-structure) • [Features](#features)\r\n\r\n
\r\n\r\n---\r\n\r\n## Overview\r\n\r\n**SDDK** is a plugin for AI coding agents (Gemini, Claude, and other IDE-integrated agents) that transforms how AI writes software. Instead of letting the agent jump straight into code, SDDK enforces a **rigorous 5-stage engineering pipeline** — from requirements elicitation through code review — ensuring that every line of code is traceable, well-architected, and production-grade.\r\n\r\nThe core problem SDDK solves: AI agents tend to produce **\"tutorial-quality\" code** — functional but poorly structured, undocumented, and difficult to maintain. SDDK forces the agent to behave like a **senior engineering team**, producing formal specifications before writing a single line of code.\r\n\r\n> [!IMPORTANT]\r\n> SDDK is **not a code generator**. It's a **process enforcer** — a set of 5 sequential skills that guide an AI agent through the same disciplined workflow a professional engineering team would follow.\r\n\r\n## The Pipeline\r\n\r\nSDDK guides the AI agent through 5 sequential stages. Each stage must be completed and approved before advancing to the next:\r\n\r\n```mermaid\r\ngraph LR\r\n SRS[\"1. SRS
Requirements\"]\r\n SDD[\"2. SDD
Architecture\"]\r\n PLAN[\"3. Planning
Microtasks\"]\r\n DEV[\"4. Dev
Fullstack\"]\r\n CR[\"5. Code Review
Audit\"]\r\n\r\n SRS --> SDD --> PLAN --> DEV --> CR\r\n\r\n style SRS fill:#3B82F6,stroke:#1E40AF,color:#fff\r\n style SDD fill:#8B5CF6,stroke:#5B21B6,color:#fff\r\n style PLAN fill:#10B981,stroke:#047857,color:#fff\r\n style DEV fill:#F59E0B,stroke:#B45309,color:#fff\r\n style CR fill:#EF4444,stroke:#B91C1C,color:#fff\r\n```\r\n\r\n| Stage | Skill | Agent Role | Output |\r\n|:---:|:---|:---|:---|\r\n| 1 | **Specification** | Senior Requirements Engineer | `srs.md` / `bug-report.md` / `refact-spec.md` / `chore-spec.md` — adapted by work type |\r\n| 2 | **System Design Document** | Senior Software Architect | `sdd.md` — Architecture (full, reduced, or minimal by type) |\r\n| 3 | **Implementation Planning** | Senior Tech Lead | `implementation_plan` — Phased microtasks with traceability |\r\n| 4 | **Fullstack Development** | Senior Fullstack Developer | Production code following specs + inline self-review |\r\n| 5 | **Code Review** | Senior Reviewer & Security Auditor | Audit report + refactoring backlog |\r\n\r\n## Installation\r\n\r\n### Prerequisites\r\n\r\n- An AI coding agent that supports plugins/skills (e.g., Gemini in VS Code, Claude, or compatible IDE agents)\r\n- Node.js ≥ 18\r\n\r\n### Option A: Install via npm (recommended)\r\n\r\n```bash\r\n# Install the CLI\r\nnpm install -g @daniel-da-silva-alves/sddk\r\n\r\n# Install the plugin\r\nsddk install\r\n```\r\n\r\nOr without permanent install:\r\n\r\n```bash\r\nnpx @daniel-da-silva-alves/sddk install\r\n```\r\n\r\nThe plugin will be installed to `~/.gemini/config/plugins/sddk/` and will be available in **all your projects**.\r\n\r\n### Option B: Install manually\r\n\r\n1. Clone this repository:\r\n ```bash\r\n git clone https://github.com/Daniel-da-Silva-Alves/Spec-Driven-Development-Kit.git\r\n ```\r\n\r\n2. Copy the `sddk` folder into the global plugin directory:\r\n ```bash\r\n # Linux/macOS:\r\n cp -r sddk/ ~/.gemini/config/plugins/sddk/\r\n\r\n # Windows:\r\n xcopy /E /I sddk %USERPROFILE%\\.gemini\\config\\plugins\\sddk\r\n ```\r\n\r\n3. Restart your IDE. The agent will automatically detect the 5 skills.\r\n\r\n> [!TIP]\r\n> You can verify the installation anytime with `sddk status`, or by asking your agent: *\"What skills do you have available?\"* — it should list the 5 SDDK skills.\r\n\r\n## Usage\r\n\r\n### Starting the Pipeline\r\n\r\nTo begin, simply describe the work you want to do. The agent will first ask what **type of work** it is:\r\n\r\n```\r\nAgent: \"What type of work is this?\"\r\n a) New feature\r\n b) Bug fix\r\n c) Refactoring\r\n d) Chore (maintenance/infra)\r\n```\r\n\r\nThen it will activate the appropriate skill with templates adapted to the work type:\r\n\r\n| Type | Directory | Phase 1 Document | Standard | Interview Depth |\r\n|:---|:---|:---|:---|:---|\r\n| **Feature** | `features/` | `srs.md` | IEEE 830 | Full (12-20 questions) |\r\n| **Fix** | `fix/` | `bug-report.md` | IEEE 1044 | Focused (5-8 questions) |\r\n| **Refactoring** | `refact/` | `refact-spec.md` | IEEE 1219 / ISO 14764 | Moderate (6-10 questions) |\r\n| **Chore** | `chore/` | `chore-spec.md` | ISO 14764 | Minimal (4-7 questions) |\r\n\r\n### Stage 1 — Requirements Specification (SRS)\r\n\r\nThe agent acts as a **Senior Requirements Engineer** and conducts a **Socratic interview** — asking one question at a time to eliminate ambiguity:\r\n\r\n```\r\nAgent: \"What should happen when a user enters an incorrect password 3 times?\"\r\n a) Lock the account for 15 minutes\r\n b) Lock the account until admin reset\r\n c) Show CAPTCHA\r\n d) Other\r\n\r\nYou: (select your choice)\r\n```\r\n\r\nAfter all questions are answered, the agent generates a formal **SRS document** following IEEE 830 and saves it to:\r\n```\r\n.specs/features/{feature-name}/srs.md\r\n```\r\n\r\n> [!TIP]\r\n> For non-feature work types, the agent generates different documents: `bug-report.md` (fixes), `refact-spec.md` (refactoring), `chore-spec.md` (chores). Each uses a template adapted from the relevant IEEE/ISO standard.\r\n\r\n### Stage 2 — System Design Document (SDD)\r\n\r\nThe agent shifts to **Senior Software Architect** and conducts a technical interview covering:\r\n\r\n- Stack selection and validation\r\n- Architecture pattern (MVC, Clean Architecture, Hexagonal, etc.)\r\n- Data model and persistence strategy\r\n- API design (endpoints, request/response formats)\r\n- Frontend componentization and state management\r\n- Documentation sources for each technology\r\n\r\n> [!NOTE]\r\n> On first run, the agent will also conduct a **project standards onboarding**, generating reusable standards in `.specs/standards/` (architecture, naming conventions, design system, API conventions, coding standards). These apply to **all features** going forward.\r\n\r\nOutput: `.specs/features/{feature-name}/sdd.md`\r\n\r\n### Stage 3 — Implementation Planning\r\n\r\nThe agent becomes a **Senior Tech Lead** and decomposes the work into **phased microtasks**, ordered by dependency layer:\r\n\r\n1. Configuration and setup\r\n2. Data model / migrations\r\n3. Data access layer (repositories)\r\n4. Business logic (services)\r\n5. API / endpoints\r\n6. UI components\r\n7. Integration between layers\r\n8. Polish and edge cases\r\n\r\nEach microtask includes:\r\n- References to specific SRS requirements (`FR-001`, `FR-002`, ...)\r\n- References to specific SDD sections (with file links and line numbers)\r\n- References to project standards\r\n- List of files to create/modify\r\n- Clear \"definition of done\"\r\n\r\nThe agent also generates **manual test scenarios** in `.specs/features/{feature-name}/manual-tests.md`.\r\n\r\n### Stage 4 — Fullstack Development\r\n\r\nThe agent executes as a **Senior Fullstack Developer**, implementing one microtask at a time:\r\n\r\n- Reads only the referenced SRS/SDD sections for each task (optimized context usage)\r\n- Follows clean code rules — no generic names, no obvious comments, no boilerplate\r\n- Applies **anti-AI-design patterns** — no emojis in UI, no generic CSS, no placeholder text\r\n- Performs **inline self-review** after each microtask before marking it complete\r\n- Consults official documentation following the priority hierarchy defined in the SDD\r\n\r\n### Stage 5 — Code Review\r\n\r\nThe agent performs a comprehensive audit as a **Senior Code Reviewer & Security Auditor**, checking 6 categories:\r\n\r\n| Category | What it checks |\r\n|:---|:---|\r\n| Code Quality | Clean code, naming conventions, anti-AI patterns, component granularity |\r\n| Security | Input validation, injection vulnerabilities, CORS, hardcoded secrets |\r\n| SDD Adherence | Architecture layers, data model, API design, design tokens |\r\n| Componentization | Reusable components, design system consistency, responsiveness |\r\n| API Usage | Correct API versions, non-deprecated patterns, proper imports |\r\n| Standards Compliance | All `.specs/standards/` rules enforced |\r\n\r\nIssues are classified by severity:\r\n- **Critical** — fixed immediately (security, breaking bugs, SDD violations)\r\n- **Medium/Low** — documented in `.specs/features/{feature-name}/refactoring-backlog.md`\r\n\r\n### Generated Project Artifacts\r\n\r\nAfter completing the pipeline, your project will contain:\r\n\r\n```\r\n.specs/\r\n├── standards/ # Project-wide standards (generated once)\r\n│ ├── architecture.md\r\n│ ├── naming-conventions.md\r\n│ ├── design-system.md\r\n│ ├── api-conventions.md\r\n│ └── coding-standards.md\r\n├── features/ # New features (IEEE 830)\r\n│ └── {feature-name}/\r\n│ ├── srs.md\r\n│ ├── sdd.md\r\n│ ├── manual-tests.md\r\n│ └── refactoring-backlog.md\r\n├── fix/ # Bug fixes (IEEE 1044)\r\n│ └── {fix-name}/\r\n│ ├── bug-report.md\r\n│ ├── sdd.md\r\n│ ├── manual-tests.md\r\n│ └── refactoring-backlog.md\r\n├── refact/ # Refactoring (IEEE 1219 / ISO 14764)\r\n│ └── {refact-name}/\r\n│ ├── refact-spec.md\r\n│ ├── sdd.md\r\n│ ├── manual-tests.md\r\n│ └── refactoring-backlog.md\r\n└── chore/ # Maintenance (ISO 14764)\r\n └── {chore-name}/\r\n ├── chore-spec.md\r\n ├── sdd.md\r\n ├── manual-tests.md\r\n └── refactoring-backlog.md\r\n```\r\n\r\n## Project Structure\r\n\r\n```\r\nSpec-Driven-Development-Kit/\r\n├── bin/\r\n│ └── cli.js # CLI installer (zero dependencies)\r\n├── sddk/\r\n│ ├── plugin.json # Plugin manifest\r\n│ └── skills/\r\n│ ├── software-requirements-specification/\r\n│ │ ├── SKILL.md # Skill 1 — Specification\r\n│ │ └── references/\r\n│ │ ├── ieee-830-template.md # SRS template (IEEE 830)\r\n│ │ ├── bug-report-template.md # Bug report template (IEEE 1044)\r\n│ │ ├── refact-spec-template.md # Refactoring spec template (IEEE 1219)\r\n│ │ ├── chore-spec-template.md # Maintenance spec template (ISO 14764)\r\n│ │ ├── checklist-template.md # Feature interview checklist\r\n│ │ ├── checklist-bug-template.md # Bug interview checklist\r\n│ │ ├── checklist-refact-template.md # Refactoring interview checklist\r\n│ │ ├── checklist-chore-template.md # Chore interview checklist\r\n│ │ ├── socratic-interview-guide.md # Interview methodology guide\r\n│ │ └── overview-template.md # Project overview (_overview.md) template\r\n│ ├── system-design-document/\r\n│ │ ├── SKILL.md # Skill 2 — SDD\r\n│ │ └── references/\r\n│ │ ├── sdd-template.md # Full SDD template (features)\r\n│ │ ├── sdd-refact-template.md # Reduced SDD template (refactoring)\r\n│ │ ├── sdd-fix-chore-template.md # Minimal SDD template (fix/chore)\r\n│ │ ├── architecture-patterns.md # Architecture patterns catalog\r\n│ │ ├── tech-stack-analysis.md # Stack analysis guide\r\n│ │ ├── documentation-sources-guide.md # Doc sources hierarchy guide\r\n│ │ ├── standards-onboarding-guide.md # Standards onboarding guide\r\n│ │ ├── standards-architecture-template.md\r\n│ │ ├── standards-naming-template.md\r\n│ │ ├── standards-design-system-template.md\r\n│ │ ├── standards-api-template.md\r\n│ │ └── standards-coding-template.md\r\n│ ├── implementation-planning/\r\n│ │ ├── SKILL.md # Skill 3 — Planning\r\n│ │ └── references/\r\n│ │ ├── microtask-template.md\r\n│ │ └── manual-tests-template.md\r\n│ ├── fullstack-development/\r\n│ │ ├── SKILL.md # Skill 4 — Dev\r\n│ │ └── references/\r\n│ │ ├── self-review-checklist.md\r\n│ │ └── clean-code-rules.md\r\n│ └── code-review/\r\n│ ├── SKILL.md # Skill 5 — Code Review\r\n│ └── references/\r\n│ ├── anti-ai-design-patterns.md\r\n│ ├── security-checklist.md\r\n│ └── refactoring-severity-guide.md\r\n├── tests/\r\n│ └── validate-plugin.mjs # Plugin consistency tests (node --test)\r\n├── .github/\r\n│ └── workflows/\r\n│ ├── ci.yml # CI validation (Node 18, 20, 22)\r\n│ └── publish.yml # Auto-publish to npm on tag push\r\n├── sddk.svg # Project logo\r\n├── ARCHITECTURE.md # Architecture documentation\r\n├── CHANGELOG.md # Release history (Keep a Changelog)\r\n├── CONTRIBUTING.md # Contribution guidelines\r\n├── SECURITY.md # Security policy\r\n└── LICENSE # MIT License\r\n```\r\n\r\n## Features\r\n\r\n- **Socratic Requirements Elicitation** — The agent interviews you question-by-question, challenging vague answers and detecting ambiguities before anything is built\r\n- **IEEE 830 / ISO 29148 Compliance** — Requirements documents follow formal standards, not ad-hoc notes\r\n- **Full Traceability** — Every microtask traces back to specific SRS requirements and SDD sections with file links and line numbers\r\n- **Project Standards Onboarding** — On first use, the agent establishes reusable standards (architecture, naming, design system, API, coding) that apply to all future features\r\n- **Anti-AI-Design Detection** — The code review skill actively detects and rejects 8 common patterns of sloppy AI-generated code (emojis in UI, generic CSS, placeholder text, monolithic components, etc.)\r\n- **Security Audit Built-In** — Every feature goes through a security checklist covering injection, CORS, secrets, auth, and input validation\r\n- **Documentation-First Development** — The agent consults official docs (with version pinning) instead of relying on potentially stale training data\r\n- **Optimized Context Usage** — The dev skill reads only the specific SRS/SDD sections referenced by each microtask, not the entire document\r\n\r\n> [!WARNING]\r\n> SDDK is designed for **feature-level development**. Each run of the pipeline specifies, designs, plans, implements, and reviews a single feature. For multi-feature projects, run the pipeline once per feature.\r\n","readmeFilename":"README.md"}