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.