# claude-code-harness | Chachamaru | Knowledge Base | Instagit Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle GitHub Stars: 2k Repository: https://github.com/Chachamaru127/claude-code-harness --- ## Articles ### [How the Compaction Hook Detects WIP Tasks Before Context Compaction in Claude-Code-Harness](/Chachamaru127/claude-code-harness/how-does-the-compaction-hook-detect-wip-tasks-before-context-compaction-in-claude-code-harness) Learn how the compaction hook in Claude-Code-Harness detects WIP tasks before context compaction. Discover the pre compact save phase scan for specific markers and system message re injection. - Tags: internals - Published: 2026-05-28 ### [How Agent Frontmatter Patterns Configure Worker and Reviewer Sub-Agents in Claude-Code-Harness](/Chachamaru127/claude-code-harness/how-do-agent-frontmatter-patterns-work-with-worker-reviewer-sub-agents-in-claude-code-harness) Learn how agent frontmatter patterns configure worker and reviewer sub-agents in Claude-Code-Harness. Discover YAML frontmatter for isolated Claude Code sessions with tool permissions and runtime constraints. - Tags: how-to-guide - Published: 2026-05-28 ### [What Is the Elicitation Hook in Claude Code Harness?](/Chachamaru127/claude-code-harness/what-is-the-elicitation-hook-and-how-does-it-improve-user-prompt-handling-in-claude-code-harness) Discover the elicitation hook in Claude Code Harness. Learn how this two-stage system captures user input, logs requests, and prevents automation deadlocks for smoother Breezing sessions. - Tags: deep-dive - Published: 2026-05-28 ### [How to Debug Hook Timeouts and Failures in Claude Code Harness Execution](/Chachamaru127/claude-code-harness/how-to-debug-hook-timeouts-and-failures-in-claude-code-harness-execution) Debug hook timeouts and failures in Claude Code Harness execution by checking configuration files, timeout settings, and JSON output. Resolve common issues fast. - Tags: how-to-guide - Published: 2026-05-28 ### [How the Auto-Cleanup Hook Detects Stale Files in claude-code-harness](/Chachamaru127/claude-code-harness/how-does-the-auto-cleanup-hook-handle-stale-file-detection-and-removal-in-claude-code-harness) Learn how the auto-cleanup hook in claude-code-harness detects stale files by comparing line counts and emitting JSON warnings. Understand its role alongside session-end hooks for artifact removal. - Tags: how-to-guide - Published: 2026-05-28 ### [Understanding loop-session.lock.d vs Regular Session Locking in Claude-Code-Harness](/Chachamaru127/claude-code-harness/what-is-the-difference-between-loop-session-lock-d-and-regular-session-locking-in-claude-code-harness) Discover the differences between loop-session.lock.d and legacy session locking in Claude-Code-Harness. Learn how meta.json enhances idempotency and WIP warnings for improved session management. - Tags: deep-dive - Published: 2026-05-28 ### [How the quality-pack hook automatically generates PR evidence in claude-code-harness](/Chachamaru127/claude-code-harness/how-does-the-quality-pack-hook-automatically-generate-pr-evidence-in-claude-code-harness) Discover how the quality-pack hook in claude-code-harness automatically generates PR evidence for code quality checks. Elevate your Pull Request verification process today. - Tags: how-to-guide - Published: 2026-05-28 ### [Memory-Bridge Hook in Claude-Code-Harness: Event Logging and Session Context Integration](/Chachamaru127/claude-code-harness/what-is-the-memory-bridge-hook-and-how-does-it-integrate-with-session-context-in-claude-code-harness) Discover the memory-bridge hook in Claude-Code-Harness. This Go handler ensures fail-safe event logging and session context integration for persistent context across sessions. - Tags: deep-dive - Published: 2026-05-28 ### [How Worktree Hooks Enable Isolated Branch-Based Development in Claude-Code-Harness](/Chachamaru127/claude-code-harness/how-do-worktree-hooks-enable-isolated-branch-based-development-in-claude-code-harness) Discover how Claude-Code-Harness uses Worktree hooks for isolated branch-based development. Ensure complete filesystem isolation for each worker with WorktreeCreate and WorktreeRemove agents. - Tags: how-to-guide - Published: 2026-05-28 ### [How to Configure hooks.json to Add Custom PreToolUse Guards in Claude Code Harness](/Chachamaru127/claude-code-harness/how-to-configure-hooks-json-to-add-custom-pretooluse-guards-in-claude-code-harness) Learn to configure hooks.json in Claude Code Harness with custom PreToolUse guards. Block or allow tool execution by defining matcher patterns and hook chains. - Tags: how-to-guide - Published: 2026-05-28 ### [SSOT Pattern in claude-code-harness: Architecture and Enforcement](/Chachamaru127/claude-code-harness/what-is-the-ssot-single-source-of-truth-pattern-and-how-is-it-enforced-in-claude-code-harness) Learn the SSOT pattern in claude-code-harness. Discover how configuration, contracts, and policies are managed with automated synchronization and CI validation for a single source of truth. - Tags: architecture - Published: 2026-05-28 ### [How TDD Enforcement Hooks Validate Test-First Development in claude-code-harness](/Chachamaru127/claude-code-harness/how-do-the-tdd-enforcement-hooks-validate-test-first-development-in-claude-code-harness) Discover how claude-code-harness enforces test first development using TDD enforcement hooks. Learn how it validates test frameworks, ensures correct edit order, and requires red-log evidence for task completion. - Tags: how-to-guide - Published: 2026-05-28 ### [How harness-mem Provides Cross-Session Memory Persistence in claude-code-harness](/Chachamaru127/claude-code-harness/how-does-harness-mem-provide-cross-session-memory-persistence-in-claude-code-harness) Learn how harness-mem enables cross-session memory persistence in claude-code-harness. Discover its unified SQLite database and state files for seamless session recovery. - Tags: deep-dive - Published: 2026-05-28 ### [Difference Between Supported, Internal-Compatible, and Candidate Tool Tiers in Claude-Code-Harness](/Chachamaru127/claude-code-harness/what-is-the-difference-between-supported-internal-compatible-and-candidate-tool-tiers-in-claude-code-harness) Understand supported, internal-compatible, and candidate tool tiers in Claude-Code-Harness. Learn the differences in testing and compatibility for your projects. - Tags: deep-dive - Published: 2026-05-28 ### [How to Migrate From an Older Harness Version Using the Doctor Command in Claude-Code-Harness](/Chachamaru127/claude-code-harness/how-to-migrate-from-an-older-harness-version-using-the-doctor-command-in-claude-code-harness) Easily migrate from older Harness versions with the harness doctor command. Get a non-destructive compatibility report for plugins, Codex skills, OpenCode, and harness-mem before upgrading. - Tags: migration-guide - Published: 2026-05-28 ### [How Breezing Parallel Execution Mode Works with Sub-Agents in claude-code-harness](/Chachamaru127/claude-code-harness/how-does-the-breezing-parallel-execution-mode-work-with-sub-agents-in-claude-code-harness) Discover how the breezing parallel execution mode in claude-code-harness leverages sub-agents like Lead, Worker, and Advisor to concurrently execute tasks and merge results efficiently. - Tags: internals - Published: 2026-05-28 ### [Claude Code Harness 3-Layer Architecture: Understanding the Skill/Workflow/Profile System](/Chachamaru127/claude-code-harness/what-is-the-architecture-of-the-3-layer-skill-workflow-profile-system-in-claude-code-harness) Explore the Claude Code Harness 3-Layer Architecture: Profiles, Workflows, and Skills. Understand how this system separates concerns for efficient AI code execution and organization. - Tags: architecture - Published: 2026-05-28 ### [How the PreToolUse Hook Guardrail Detects Hardcoded Secrets in Claude Code Harness](/Chachamaru127/claude-code-harness/how-does-the-pretooluse-hook-guardrail-in-claude-code-harness-detect-hardcoded-secrets-and-credentials) Discover how the PreToolUse hook guardrail in claude-code-harness detects hardcoded secrets. It scans code diffs for credentials, preventing exposure before execution. - Tags: how-to-guide - Published: 2026-05-28 ### [How to Configure claude-code-harness to Integrate with Codex CLI Instead of Claude Code](/Chachamaru127/claude-code-harness/how-to-configure-claude-code-harness-to-integrate-with-codex-cli-instead-of-claude-code) Integrate claude-code-harness with Codex CLI. Follow simple steps to install Codex CLI and add the codex flag to delegate tasks, bypassing Claude Code for enhanced functionality. - Tags: how-to-guide - Published: 2026-05-28 ### [How the Chachamaru claude-code-harness Permission System Prevents Unauthorized File Modifications](/Chachamaru127/claude-code-harness/how-does-chachamaru-claude-code-harness-permission-system-prevent-unauthorized-file-modifications) Discover how the Chachamaru claude-code-harness permission system uses multi-layer defense to block unauthorized file modifications and protect your filesystem. - Tags: security - Published: 2026-05-28