git404hub

what is harness-sdd fr?

betta-tech/harness-sdd — explained in plain English

Analysis updated 2026-05-18

46PythonAudience · developerComplexity · 2/5Setup · easy

tl;dr

An example repository showing how to structure a project so AI coding agents like Claude Code can build features with human approval at each step.

vibe map

mindmap
  root((harness-sdd))
    What it does
      Structures repo for AI agents
      Specs before code
      Human approval gates
    Tech stack
      Python
      Claude Code
    Use cases
      Template for AI dev
      Learn harness engineering
      Oversight workflow
    Audience
      Developers
      PM founders
    Concepts
      Spec agent
      Implementation agent
      Review agent

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Use as a template for structuring a repository so AI agents can work with human oversight

VIBE 2

Learn a workflow where specs are written and approved before any code changes

VIBE 3

See how separate spec, implementation, and review agents coordinate through files

VIBE 4

Build a simple command-line notes tool as a working example of the pattern

what's the stack?

PythonClaude Code

how it stacks up fr

betta-tech/harness-sddemmimal/control-layererlichliu/deepseek-vision
Stars464646
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

The example app itself is a trivial Python CLI tool, the value is in the repository structure.

in plain english

This repository is an example project that demonstrates a structured approach to using AI coding agents, specifically Claude Code, to develop software autonomously while keeping a human in control of important decisions. The actual application inside it is a simple command-line notes tool in Python, but that is deliberately trivial, the point is to show how the repository itself is organized to guide AI agents effectively. The core idea, which the project calls "Harness Engineering," is that a repository should be set up so that an AI agent can understand what to build, how to build it, and how to verify its own work, all from the files in the repository rather than from conversation history that gets lost. This is achieved through a structured workflow: before any code is written, the AI produces specification documents covering what a feature must do, what technical decisions were made, and a checklist of implementation steps. A human must approve these documents before the agent touches any code. After implementation, a separate reviewer agent checks that every requirement maps to an actual test. Multiple specialized sub-agents handle different roles, one for writing specs, one for implementing, one for reviewing, and they communicate by writing files to disk rather than passing messages through the chat, which makes the process resilient to context window limits and system restarts. Progress files are kept updated throughout so the state of the work is always visible. This is useful as a template or learning resource for developers who want to use AI agents for real development work with oversight and traceability built in. It is written in Python.

prompts (copy fr)

prompt 1
Explain how this repository's Harness Engineering approach keeps a human in control of AI-written code.
prompt 2
Show me how the spec, implementation, and review agents communicate through files here.
prompt 3
How would I adapt this structured workflow for my own project with Claude Code?
prompt 4
What do the specification documents need to contain before an agent starts coding?

Frequently asked questions

what is harness-sdd fr?

An example repository showing how to structure a project so AI coding agents like Claude Code can build features with human approval at each step.

What language is harness-sdd written in?

Mainly Python. The stack also includes Python, Claude Code.

How hard is harness-sdd to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is harness-sdd for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.