How distinta/sdd-harness-kit works
SDD Harness Kit equips a development team’s AI-assisted workflow with canonical skills and agents, OpenSpec templates, deterministic Claude Code hooks, and stack-specific standards. The principal workflow starts with a ticket: product and engineering refine scope and contract, approve a code plan, implement task-by-task with TDD, verify evidence, document, deliver, and retrospect. Hooks enforce safeguards during work; agents and skills guide the phases. The README documents these capabilities and the installation/doctor flow. Source excerpts are limited to adapter examples, so detailed hook-to-skill or installer wiring is not asserted.
Main entry points: install.sh Kit installer · hooks Lifecycle hooks · adapters Stack adapters · skills Workflow skills
Components 15
Project Setup
- Kit installer
install.sh - Install checker
doctor.sh
SDD Workflow
- Workflow skills
core/ai-specs/skills - Phase agents
core/ai-specs/agents - Spec templates
core/ai-specs/templates - OpenSpec changes
openspec
Guardrails
- Lifecycle hooks
core/.claude/hooks - Session context
core/.claude/hooks/session-context.sh - Core standards
core/docs/base-standards.md - Task requirements
core/docs/openspec-tasks-mandatory-steps.md
Stack Adaptation
- Stack adapters
adapters - Dependency rules
adapters/fastify.dependency-cruiser.js - Frontend guidance
adapters/react.frontend-standards.md
Other components
- Development team
- AI copilot
Connections 18
- Development team → Kit installer: installs kit
README.md - Development team → Install checker: checks setup
README.md - Kit installer → Workflow skills: installs sources
README.md - Kit installer → Phase agents: installs sources
README.md - Kit installer → Spec templates: installs templates
README.md - Development team → OpenSpec changes: defines changes
README.md - Workflow skills → OpenSpec changes: guide spec work
README.md - AI copilot → Workflow skills: uses guidance
README.md - AI copilot → Phase agents: uses specialists
README.md - AI copilot → Lifecycle hooks: triggers safeguards
README.md - Lifecycle hooks → Session context: loads context
README.md - Lifecycle hooks → Core standards: enforce doctrine
README.md - Lifecycle hooks → Task requirements: validate tasks
README.md - Kit installer → Stack adapters: selects standards
README.md - Stack adapters → Dependency rules: includes rules
README.md - Stack adapters → Frontend guidance: provides guidance
README.md - AI copilot → OpenSpec changes: implements contract
README.md - Development team → AI copilot: reviews evidence
README.md