See AGENTS.md for full architecture, workflows, and conventions.
- TDD required: Write failing tests before implementing. See AGENTS.md for workflow.
- Always wait for user review before committing — never auto-commit.
- Development in worktrees: Use
anvil work <branch>for feature branches. - Lint before commit:
golangci-lint run ./...must pass (pinned to v2.1.2). - No ignored errors: Handle all errors explicitly; never
_, _ =. - No data races: Use proper synchronization for concurrent access.
Update CHANGELOG.md, commit, tag with an annotated vX.Y.Z tag, and push — the tag push triggers release.yml, which builds binaries and creates the GitHub release automatically.
Rules auto-load from .claude/rules/ for matching file types:
charm.md— Bubble Tea / Charm TUI patterns (**/*.go)go-cli.md— Cobra CLI patterns (**/*.go)