{
  "markdown": "# SDLC Kit\n\n> Spec-Driven Development (SDD) + Domain-Driven Design (DDD) vault for **Claude Code**, versioned inside your Git repo — Obsidian-compatible, LLM-optimized, language-agnostic.\n\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-8A2BE2?logo=anthropic)](https://claude.ai/code) [![Skills](https://img.shields.io/badge/skills-22-blueviolet)](https://github.com/vellus-ai/sdlc-kit/tree/main/plugins) [![Phases](https://img.shields.io/badge/phases-8-informational)](#vault-structure) [![Python](https://img.shields.io/badge/python-3.11%2B-blue?logo=python&logoColor=white)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![Version](https://img.shields.io/badge/version-0.4.0-orange)](https://github.com/vellus-ai/sdlc-kit/releases/tag/v0.4.0)\n\n> 📖 **Este documento também está disponível em [Português (Brasil)](#português-brasil) abaixo.**\n\n---\n\n## Why it exists\n\nWhen you work with Claude Code on real projects, three problems surface again and again:\n\n- **Architectural decisions get lost** between sessions — the LLM has no context on what was decided.\n- **Requirements drift out of sync** with implementation — the code moves forward, the spec falls behind.\n- **Every new session starts from zero** — no history of ADRs, epics, domain, incidents.\n\nSDLC Kit solves this by maintaining a versioned `.sdlc/` vault inside your own repo, with automatic indexing, **22 skills** across the full lifecycle (planning → architecture → domain → specs → development → design-system → retrospectives), and a self-contained HTML dashboard.\n\n---\n\n## Two composable plugins\n\nStarting at **v0.4.0**, SDLC Kit ships as **two plugins** in the same marketplace. Install just the core for the daily PR loop; add the extended pack when you need governance, architecture modeling and post-delivery analysis.\n\n| Plugin | Skills | Install | Purpose |\n|---|---|---|---|\n| **`sdlc-kit`** (core) | 11 | `/plugin install sdlc-kit@sdlc-kit` | Daily delivery loop: init, sync, status, dash, prd, adr, spec, task, worktree, review, retro. |\n| **`sdlc-kit-extended`** | 11 (optional) | `/plugin install sdlc-kit-extended@sdlc-kit` | Governance (trd, epic, milestone, steer), architecture & domain (c4, api, domain, design-system), ops/analysis (incident, trace, impact). Requires the core plugin. |\n\n---\n\n## Features\n\n- **Canonical 8-phase vault** (`00-steering` → `07-retrospectives`).\n- **22 skills** invokable via `/sdlc-kit:<name>`, each with a stable `list / scaffold / transition` contract.\n- **SDD** — `requirements.md` (EARS) + `design.md` + `tasks.md` trio per feature, with approval gates.\n- **DDD + C4** — aggregates, domain events, context map, ubiquitous language, 3-level diagrams.\n- **Living governance** — auto-numbered ADRs, cross-cutting TRDs, 4 API contract styles (REST/async/gRPC/webhook), Design System.\n- **Traceable delivery** — PRDs, epics, milestones with RAG status, task lifecycle workflow, PR review co-signed by Code Reviewer + AppSec.\n- **Post-delivery observability** — retros, 4-state incidents (open → mitigated → resolved → post-mortem) with auto-populated timestamps.\n- **Graph analysis** — `sdlc-trace` (PRD↔spec↔task↔review matrix) and `sdlc-impact` (forward/backward BFS on wikilinks).\n- **Self-contained HTML dashboard** — Kanban, Epics & Milestones, Documents, Domain; no server, via File System Access API.\n- **Git worktree + PR tracking** in SQLite.\n- **PostToolUse hook** re-indexes every saved `.md`, rate-limited to 1 signal / 5 s per vault.\n- **i18n of `_INDEX.md`** — rendered in the language set at `.sdlc-kit/marker.json:locale` (default `pt-br`, alternate `en`). Code and templates stay English; the LLM mirrors your chat language in content.\n\n---\n\n## Install\n\n### Via Claude Code marketplace (recommended)\n\nInside any Git project:\n\n```\n/plugin marketplace add vellus-ai/sdlc-kit\n/plugin install sdlc-kit@sdlc-kit            # core — required\n/plugin install sdlc-kit-extended@sdlc-kit   # optional extended skills\n/reload-plugins\n```\n\nThen run `/sdlc-kit:init` to scaffold `.sdlc/`.\n\n> Pin a version: `/plugin marketplace add vellus-ai/sdlc-kit@v0.4.0`.\n\n### One-liner installer (alternative — clones locally and registers in settings.json)\n\n**Linux / macOS:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/vellus-ai/sdlc-kit/main/install.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm \"https://raw.githubusercontent.com/vellus-ai/sdlc-kit/main/install.ps1?v=$(Get-Random)\" | iex\n```\n\nThe installer checks Python 3.11+, `git` and the `claude` CLI; clones the repo to `~/.claude/plugins/sdlc-kit`; installs the Python package via `pip install -e`; and registers the plugins in `~/.claude/settings.json`.\n\n### Uninstall\n\n**Linux / macOS:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/vellus-ai/sdlc-kit/main/uninstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm \"https://raw.githubusercontent.com/vellus-ai/sdlc-kit/main/uninstall.ps1?v=$(Get-Random)\" | iex\n```\n\n`.sdlc/` vaults inside your projects are **preserved**.\n\n---\n\n## Quick start\n\n```\n/sdlc-kit:init\n```\n\nA short interview auto-detects owner, remote and project type (greenfield vs brownfield), creates `.sdlc/` with the 8 canonical phases, `CLAUDE.md`, `_INDEX.md`, `dashboard.html` and the SQLite tracker.\n\n### Typical feature flow\n\n```text\n# 1 — Product alignment (01-planning)\n/sdlc-kit:prd        → initiative PRD\n\n# 2 — Architectural decisions & requirements (02-architecture)\n/sdlc-kit:adr        → numbered technical decision (ADR-NNNN)\n/sdlc-kit:trd        → cross-cutting requirements (extended)\n/sdlc-kit:c4         → C4 Context/Container/Component diagrams (extended)\n/sdlc-kit:api        → REST/async/gRPC/webhook contract (extended)\n\n# 3 — Domain modeling (03-domain, extended)\n/sdlc-kit:domain     → aggregates, events, ACL contracts, context map\n\n# 4 — Feature spec (04-specs)\n/sdlc-kit:spec       → trio requirements.md (EARS) + design.md + tasks.md\n\n# 5 — Execution (05-development)\n/sdlc-kit:worktree   → isolated git worktree + vault record\n/sdlc-kit:task       → start / complete / block / reopen a TASK-NNN\n\n# 6 — PR review\n/sdlc-kit:review     → Code Reviewer + AppSec checklist, 6 sections, decision\n\n# 7 — Cycle close\n/sdlc-kit:retro      → sprint retrospective\n/sdlc-kit:incident   → post-mortem (extended)\n\n# Anytime\n/sdlc-kit:sync       → revalidate and regenerate MOCs + _INDEX.md\n/sdlc-kit:status     → vault snapshot\n/sdlc-kit:trace      → PRD ↔ spec ↔ review matrix (extended)\n/sdlc-kit:impact --seed ADR-0007    → what breaks if I deprecate this? (extended)\n/sdlc-kit:dash       → open the dashboard in the browser\n```\n\n---\n\n## Vault structure\n\n```text\n.sdlc/\n├── CLAUDE.md                    # vault doctrine — read by the agent before any write\n├── _INDEX.md                    # living index, regenerated by /sdlc-kit:sync\n├── dashboard.html               # self-contained dashboard\n├── .sdlc-kit/\n│   ├── marker.json              # vault root + kit version + locale\n│   └── db.sqlite                # SQLite (WAL): notes, tasks, worktrees, events, …\n├── 00-steering/                 # product / tech / standards\n├── 01-planning/                 # PRDs, epics, milestones\n├── 02-architecture/             # ADRs, TRDs, C4, API designs\n├── 03-domain/                   # DDD artifacts\n├── 04-specs/                    # SDD trios per feature\n├── 05-development/              # git worktrees & branches\n├── 06-design-system/            # tokens, components, patterns\n└── 07-retrospectives/           # reviews, retros, incidents\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/vellus-ai/sdlc-kit.git\ncd sdlc-kit\npip install -e \".[dev,yaml]\"\n\npytest                                   # full suite\npytest tests/test_scanner.py             # specific file\npytest --cov=core --cov-report=html      # coverage\n```\n\n### Conventions\n\n- Branches: `feat/<slug>` or `fix/<slug>`.\n- TDD is the default — test before implementation.\n- Every skill script supports `--dry-run` and emits a single JSON object to stdout; exit codes `0` / `1` / `2`.\n- Minimum coverage: 90% on `core/` modules.\n\n---\n\n## Documentation\n\n- **Architecture** — [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)\n- **Contributing** — [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md)\n- **Publishing** — [`docs/PUBLISHING.md`](docs/PUBLISHING.md)\n- **Testing** — [`docs/TESTING.md`](docs/TESTING.md)\n- **Privacy policy** — [`PRIVACY.md`](PRIVACY.md)\n- **Changelog** — [`CHANGELOG.md`](CHANGELOG.md)\n\n---\n\n## Contributing\n\n1. Fork the repository.\n2. Create a branch: `feat/<slug>`.\n3. Implement with TDD.\n4. Open a PR describing **what** and **why**.\n\nBugs or feature requests: [open an issue](https://github.com/vellus-ai/sdlc-kit/issues).\n\n---\n\n## License\n\n[MIT](LICENSE) © 2026 [Vellus](https://vellus.tech/)\n\n---\n---\n\n## Português (Brasil)\n\n> Vault de **Spec-Driven Development (SDD)** + **Domain-Driven Design (DDD)** para o **Claude Code**, versionado dentro do seu repositório Git — compatível com Obsidian, otimizado para LLMs, agnóstico de linguagem.\n\n### Problema que resolve\n\nAo trabalhar com Claude Code em projetos reais, três problemas surgem constantemente:\n\n- **Decisões arquiteturais se perdem** entre sessões — o LLM não tem contexto do que foi decidido.\n- **Requisitos saem de sincronia** com a implementação — o código avança, a spec fica para trás.\n- **Cada nova sessão começa do zero** — sem histórico de ADRs, épicos, domínio, incidentes.\n\nO SDLC Kit resolve isso mantendo um vault `.sdlc/` versionado no seu próprio repo, com indexação automática, **22 skills** cobrindo o ciclo completo (planning → architecture → domain → specs → development → design-system → retrospectives) e um dashboard HTML autocontido.\n\n### Dois plugins compostos\n\nA partir da **v0.4.0**, o SDLC Kit é distribuído como **dois plugins** no mesmo marketplace. Instale só o core para o ciclo de PR diário; adicione o extended quando precisar de governança, modelagem arquitetural e análise pós-entrega.\n\n| Plugin | Skills | Instalação | Propósito |\n|---|---|---|---|\n| **`sdlc-kit`** (core) | 11 | `/plugin install sdlc-kit@sdlc-kit` | Ciclo de entrega diário: init, sync, status, dash, prd, adr, spec, task, worktree, review, retro. |\n| **`sdlc-kit-extended`** | 11 (opcional) | `/plugin install sdlc-kit-extended@sdlc-kit` | Governança (trd, epic, milestone, steer), arquitetura & domínio (c4, api, domain, design-system), ops/análise (incident, trace, impact). Requer o plugin core. |\n\n### Instalação\n\nDentro de qualquer projeto Git no Claude Code:\n\n```\n/plugin marketplace add vellus-ai/sdlc-kit\n/plugin install sdlc-kit@sdlc-kit            # core — obrigatório\n/plugin install sdlc-kit-extended@sdlc-kit   # skills extended (opcional)\n/reload-plugins\n```\n\nDepois execute `/sdlc-kit:init` para criar o vault `.sdlc/`.\n\n> Pinar uma versão: `/plugin marketplace add vellus-ai/sdlc-kit@v0.4.0`.\n\n### Uso rápido\n\nExecute `/sdlc-kit:init` dentro do seu projeto. Uma entrevista curta auto-detecta dono, remoto e tipo (greenfield / brownfield) e cria as 8 fases canônicas, o `CLAUDE.md`, o `_INDEX.md`, o `dashboard.html` e o SQLite tracker.\n\n### Funcionalidades\n\n- Vault estruturado em **8 fases canônicas** (`00-steering` → `07-retrospectives`).\n- **22 skills** invocáveis via `/sdlc-kit:<nome>`, cada uma com contrato `list / scaffold / transition` estável.\n- **SDD** — trio `requirements.md` (EARS) + `design.md` + `tasks.md` por feature, com portas de aprovação.\n- **DDD + C4** — aggregates, domain events, context map, ubiquitous language, diagramas em 3 níveis.\n- **Governança viva** — ADRs numerados, TRDs cross-cutting, 4 tipos de contratos de API (REST/async/gRPC/webhook), Design System.\n- **Entrega rastreável** — PRDs, épicos, milestones com RAG status, task lifecycle workflow, review de PR co-assinado por Code Reviewer + AppSec.\n- **Observabilidade pós-entrega** — retros, incidentes 4-estado com timestamps auto-preenchidos.\n- **Análise de grafo** — `sdlc-trace` (matriz PRD↔spec↔task↔review) e `sdlc-impact` (BFS forward/backward).\n- **Dashboard HTML autocontido** — Kanban, Épicos & Milestones, Documentos, Domínio; sem servidor.\n- **Rastreamento de git worktrees e PRs** em SQLite.\n- **Hook PostToolUse** que indexa cada `.md` salvo, rate-limited a 1 sinal / 5 s por vault.\n- **i18n do `_INDEX.md`** — renderizado no idioma definido em `.sdlc-kit/marker.json:locale` (default `pt-br`, alternativo `en`). Código e templates em inglês; o LLM espelha o idioma da conversa no conteúdo.\n\n### Desenvolvimento\n\n```bash\ngit clone https://github.com/vellus-ai/sdlc-kit.git\ncd sdlc-kit\npip install -e \".[dev,yaml]\"\npytest\n```\n\n**Convenções:** branches `feat/<slug>` ou `fix/<slug>`; TDD por padrão; cada script emite JSON em stdout com exit codes `0` / `1` / `2`; cobertura mínima 90% em `core/`.\n\n### Documentação\n\n- **Arquitetura** — [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)\n- **Contribuição** — [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md)\n- **Publicação** — [`docs/PUBLISHING.md`](docs/PUBLISHING.md)\n- **Testes** — [`docs/TESTING.md`](docs/TESTING.md)\n- **Política de privacidade** — [`PRIVACY.md`](PRIVACY.md)\n- **Changelog** — [`CHANGELOG.md`](CHANGELOG.md)\n\n### Licença\n\n[MIT](LICENSE) © 2026 [Vellus](https://vellus.tech/)\n",
  "bytes": 13240,
  "sha": "765344c514daac07f408a7f44b89556b8e7a48af0995c55162970b68053ebab8",
  "repo_slug": "vellus-ai/sdlc-kit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_vellus_ai_sdlc_kit_sdlc_kit_12e93f6a/readme"
}