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.