Summary

This project, claude-code-harness, provides a structured, disciplined workflow for using Claude Code, transforming it into a reliable development partner. It addresses the need for higher quality, auditable AI-assisted code generation through an autonomous Plan→Work→Review→Release cycle. Targeted at developers, freelancers, and team leads, it enhances productivity while maintaining code integrity and safety.

How It Works

The harness enforces a 5-verb skill system (/harness-setup, /harness-plan, /harness-work, /harness-review, /harness-release) to standardize development operations. A core TypeScript guardrail engine, featuring 9 declarative rules, actively protects the codebase by preventing destructive actions, unauthorized Git operations, and secret exposure at runtime. This approach ensures a planned, guarded, reviewed, and rerunnable development process, moving beyond theoretical AI capabilities to practical, trustworthy execution.

Quick Start & Requirements

• Install: Add the plugin via Claude Code: /plugin marketplace add Chachamaru127/claude-code-harness and /plugin install claude-code-harness@claude-code-harness-marketplace. Initialize with /harness-setup.
• Prerequisites: Claude Code v2.1+ and Node.js 18+.
• Docs: Installation Guide, docs/github-harness-plugin-benchmark.md, docs/evidence/work-all.md.

Highlighted Details

• TypeScript Guardrail Engine: Implements 9 strict rules (R01-R09) to block dangerous commands (sudo, rm -rf /), sensitive file writes (.git/, .env), and force pushes.
• Advanced Integrations: Supports OpenAI Codex for parallel implementation, a 2-agent mode with Cursor, and AI-driven slide/video generation.
• Experimental Workflow: The /harness-work all command automates the full loop (Plan → Implement → Review → Commit), requiring validation of its success/failure contract before production use.

Maintenance & Community

Contributions are welcomed via issues and PRs, with a CONTRIBUTING.md file available. No specific community channels or contributor highlights are detailed.

Licensing & Compatibility

Licensed under the MIT License, permitting free use, modification, and commercialization.

Limitations & Caveats

The /harness-work all command is explicitly marked as an "Experimental workflow" requiring user validation. Integration with external tools like OpenAI Codex necessitates separate CLI setup and API key configuration.