SDLC Harness

Multi-agent SDLC harness — decompose features into tasks, execute via LLM agents, track everything in a knowledge graph, and enforce quality gates.

Built on opencode, providers are swappable through a clean adapter interface.

Features

• Agent-based SDLC — Architect, Coder, QA, and Stack Analyst agents collaborate through structured phases
• Knowledge graph — SQLite-backed property graph traces every feature, task, decision, and artifact
• Quality gates — Automated verification between phases with configurable criteria
• Fork-retry resilience — Failed tasks auto-fork sessions and retry up to configurable limits
• Provider-agnostic — Opencode adapter included; extend with your own backend
• Health-aware — Detects existing servers or auto-starts one on demand
• Interactive mode — Run with no args for a guided menu

Quick start

# Install
npm install -g @madhavmadupu/sdlc-harness

# Run a feature
sdlc-harness run "Add user authentication"

Requirements

• opencode v1.15+ (npm install -g opencode-ai)
• Node.js 22+

Usage

CLI

sdlc-harness run "Feature title"     Run a feature through the SDLC
sdlc-harness status                  Check system health
sdlc-harness doctor                  Diagnose and fix issues
sdlc-harness init                    Initialize a project
sdlc-harness                         Interactive mode

Run options

sdlc-harness run "Add login" --model opencode/gpt-4 --db ./my-project.db

| Option | Description | |---|---| | --model <model> | Model override (e.g. opencode/gpt-4) | | --id <id> | Explicit feature ID | | --desc <text> | Feature description | | --db <path> | Knowledge graph database path | | --server <url> | opencode server URL |

Architecture

┌─ HARNESS BRAIN ─────────────────────────────────────┐
│  Orchestrator    Agent roles    Policy / gates       │
│  Knowledge graph (SQLite) + reasoning store          │
└────────────────────────┬────────────────────────────┘
                         │ normalized events
┌─ PROVIDER SEAM ───────┴────────────────────────────┐
│  OpencodeBackend adapter (one interface)             │
└────────────────────────┬────────────────────────────┘
                         │ HTTP + SSE
┌─ OPENCODE SERVER ──────┴────────────────────────────┐
│  Sessions · Event stream · Diff · Permissions        │
│  Provider routing (any LLM)                          │
└─────────────────────────────────────────────────────┘

Documentation

| Section | Contents | |---|---| | Getting started | Installation, first feature, CLI overview | | Architecture | System design, components, data flow | | Knowledge graph | Schema, queries, graph traversal | | Agent roles | Agent definitions, prompts, responsibilities | | CLI reference | Full CLI commands, options, and environment variables | | Contributing | Setup, testing, pull request guide |

Development

npm install
npm run typecheck
npm test
npm run build

License

MIT — see LICENSE.