CLAUDE.md · diff

git:20260924.79ccef7 to git:20261023.65cbba1

2 added, 0 removed. Audit A to A.

# secondmate — project instructions

## Audit trail (auto-loaded each session)

@audit/INDEX.md

That index is generated and bounded (most recent entries only) — never hand-edit it. Full history is

one file per task under `audit/flow/` and `audit/decision/`; look it up on demand with

`bin/audit-log.py list|search|show`, never by loading it in bulk.

## Docs must stay in sync with code

Before every `git push`, update `README.md` and `docs/ARCHITECTURE.md` to reflect any changes to:

- `bin/` scripts (new scripts, changed flags, changed defaults)

- `skills/secondmate/SKILL.md` (new phases, changed patterns, updated commands)

- `.claude-plugin/plugin.json` (version bumps)

- Herdr integration patterns (pane/agent/worktree usage)

Specifically keep current:

- Version badge in README

- "What's inside" component table (add/remove/update rows for bin/ changes)

- "How it works" mermaid diagram (if the flow changes)

- Config vars table (`SM_*` env vars)

- Manual install selfcheck command (add new `--selfcheck` calls)

- ARCHITECTURE roles table, flowchart, stage-by-stage descriptions, component map

**Never push without checking these.** If a bin script changed, the README table must reflect it. If the skill changed, the ARCHITECTURE stages must reflect it.

+ Before relying on memory for this check, run the `drift-report` skill (`skills/drift-report/SKILL.md`) — it checks these same docs against the real `bin/` scripts for you.