harness-kit CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Memory Policy

Never use MEMORY.md files. Do not create, read, update, or reference any MEMORY.md files in this repository. All persistent project context belongs in CLAUDE.md files (root and per-project). If you need to store learnings, use /hk-compound to write to docs/patterns/ instead.

Git Safety: No Stash

Never run ANY git stash command in the main repo checkout or any shared context. Multiple agents work in parallel on this repo; stash operations there create invisible shared state that causes silent data loss across concurrent sessions. Use branches, temporary commits, or disk-anchored files instead; check for uncommitted changes with git status or git diff.

Exception — isolated task worktrees: an agent running inside its own task worktree (.odin/worktrees/...) may use stash on its own work; the stash is scoped to that worktree and cannot affect other sessions. Prefer temporary commits anyway (a crashed run loses stashed work), but stash use inside an isolated worktree is NOT a rule violation and must not, on its own, fail a review.

Design Principles

Simplicity is a feature. Between two correct approaches, pick the one with fewer moving parts. The goal is code so straightforward it looks obvious — that's the hardest thing to achieve, not the easiest. Extra abstraction layers, wrapper functions, and extensibility points are costs that need justification, not defaults to reach for. When a shortcut is the right call, take it — but you should be able to say in one sentence why it won't cause problems later. If you can't, do it properly.

Default First: Every feature should work out of the box with sensible defaults. Configuration, agent assignments, and settings should be suggestive — provide a good default that the user can override, rather than requiring upfront configuration. The system picks reasonable choices automatically; the user intervenes only when they want something different.