using-superharness

What problem does it solve?

Superharness prevents ad-hoc, unsafe, or unverified AI-driven code changes by mechanically enforcing a disciplined software engineering workflow at session start and throughout task execution. It closes gaps where agents might skip tests, drift from requirements, or declare work done without verification.

Core Features & Use Cases

• Session-start injection: Automatically injects project conventions and the dispatch protocol into every AI session so the agent follows predefined rules before doing work.
• Process enforcement: Enforces TDD, requirement clarification, two-stage review, QA validation, task isolation via git worktrees, and trace logging to maintain auditability.
• Convention discovery & task tracking: Scans the codebase to populate .superharness/spec/ and tracks task state and traces in .superharness/tasks/ for reproducible development.
• Use Case: Start a new feature development session and have the agent generate a vetted plan, implement via failing tests first, run dual reviews, and produce verifiable merge-ready commits.

Quick Start

Invoke the using-superharness skill at session start to inject project conventions, enable TDD enforcement, run skill checks, and orchestrate the full development workflow.