studioKjm

studioKjm/ai-harness-template

Plugin Claude Code

AI Harness + Ouroboros: Specification-first development with structural guardrails.

studioKjm/ai-harness-template

Plugin Claude Code

Specification-first AI harness: 11 structural gates, 11 Ouroboros commands, 11 agent personas, and 3-tier architecture enforcement. v2.1: Pair Mode (Navigator-Driver + independent test design + /review command).

studioKjm/ai-harness-template

Command Claude Code

../../commands/install.md.

studioKjm/ai-harness-template

Instructions file

Instructions for studioKjm/ai-harness-template, covering claude.md — ai harness template, project overview, rules, structure and methodology system.

studioKjm/ai-harness-template

Agent

USE THIS WHEN symptoms keep recurring, layer boundaries blur, or changes ripple unexpectedly. ALWAYS invoke for structural diagnosis during /unstuck or major refactors. Finds root causes in design, not symptoms. Names tradeoffs explicitly.

studioKjm/ai-harness-template

Agent

USE THIS WHEN the team reaches quick consensus, before committing to a major design decision, or during /evolve and /unstuck. Challenges assumptions with "what if we're wrong?" scenarios. Always proposes at least one alternative.

studioKjm/ai-harness-template

Agent

USE THIS WHEN verifying implementation against a seed spec, running gates, or assessing AC compliance. ALWAYS invoke during /evaluate. Never fixes — only judges Pass/Fail with file:line evidence. Runs 3-stage verification (Mechanical → Semantic → Judgment).

studioKjm/ai-harness-template

Agent

USE THIS WHEN the official path is blocked, a deadline looms, or a temporary workaround is acceptable. ALWAYS invoke during /unstuck when standard approaches fail. Finds safe bypasses (monkey-patch, polyfill, shim) with explicit expiry dates.

studioKjm/ai-harness-template

Agent

USE PROACTIVELY whenever the user describes a new feature, vague requirement, or unclear goal. ALWAYS run BEFORE writing code or creating a seed spec. Asks Socratic questions to surface hidden assumptions. Never writes code or gives answers — only questions.

studioKjm/ai-harness-template

Agent

USE THIS as the planning half of pair programming during /run (PAIRMODE). Generates 3 solution plans per AC, selects optimal one, directs Driver. Never writes code directly. Based on PairCoder (ASE 2024) Navigator-Driver methodology. MUST be spawned as a background agent and communicated via SendMessage.

studioKjm/ai-harness-template

Agent

USE THIS WHEN defining domain terms, extracting entities/relationships from requirements, or unifying synonyms (e.g., "user" vs "member" vs "account"). ALWAYS invoke during /seed spec generation. Extracts Entity/Attribute/Relationship from interviews.

studioKjm/ai-harness-template

Agent

USE THIS WHEN a claim needs evidence, debugging requires history, or library/API behavior is uncertain. ALWAYS invoke before guessing — checks official docs, existing code patterns, git log/blame first. Evidence over speculation.

studioKjm/ai-harness-template

Agent

USE THIS WHEN crystallizing interview results into an immutable specification. ALWAYS invoke during /seed. Converts conversation + ontology into structured seed YAML with zero TODO/TBD tolerance. Blocks progress if any field is ambiguous.

studioKjm/ai-harness-template

Agent

USE THIS WHEN code feels over-engineered, scope seems to creep, or abstractions pile up. ALWAYS invoke during /evolve and /unstuck. Asks "is this needed for MVP?" on every feature. YAGNI-first — prefers convention over configuration.

studioKjm/ai-harness-template

Agent

USE THIS for independent test case generation during /run (PAIRMODE). Designs tests from AC and seed spec only — never reads implementation code. Prevents biased testing. Based on AgentCoder (2024) test separation methodology. MUST be spawned with isolation worktree to physically prevent source code access.

studioKjm/ai-harness-template

Command

Break seed AC into atomic layer-aware tasks BEFORE /run. USE WHENEVER implementation spans multiple files or layers. Prevents mega-prompts; each unit is independently implementable and testable.

studioKjm/ai-harness-template

Command

Run 3-stage verification (Mechanical gates → Semantic AC compliance → Judgment quality) after /run. ALWAYS run before committing. Blocks at Stage 1 failures — no Stage 2 until gates pass.

studioKjm/ai-harness-template

Command

Evolve the system when /evaluate fails. Runs Wonder → Reflect → Re-seed cycle with fan-out multi-perspective analysis (Contrarian + Simplifier + Researcher). Stops at convergence (ontology similarity ≥ 0.95).

studioKjm/ai-harness-template

Command

START HERE for ANY new feature or unclear requirement. Socratic interview that surfaces hidden assumptions before a single line of code is written. Measures 4D ambiguity score — blocks progress until score ≤ 0.2.

studioKjm/ai-harness-template

Command

Methodology plugin manager. List, activate, compose, deactivate development methodologies (Ouroboros, Living Spec, Parallel Change, BMAD-lite, Exploration). Harness gates remain enforced regardless of methodology.

studioKjm/ai-harness-template

Command

Generate a stakeholder-facing PRD from interview results. USE WHEN non-engineering stakeholders need a Product Requirements Document. Optional — most workflows go interview → seed directly.

studioKjm/ai-harness-template

Command

Lightweight mid-run verification. Runs Stage 1 (Mechanical) gates only. Use between AC implementations to catch drift early. Much faster than /evaluate.

studioKjm/ai-harness-template

Command

USE WHEN /run fails mid-way, /evaluate reports severe drift, or partial implementation must be undone. Saga-pattern rollback via git stash/checkout/branch — chooses safest strategy based on scope.

studioKjm/ai-harness-template

Command

Execute seed spec via Double Diamond (Discover → Define → Design → Deliver). USE AFTER /decompose. Enforces D→L→P implementation order, writes tests immediately, runs gates continuously. Supports Pair Mode for medium/high complexity ACs.