# CLAUDE.md - Powered by Skillsmith

> Auto-generated by [skillsmith](https://pypi.org/project/skillsmith/).
> Claude Code loads this file automatically at session start.
> See: https://docs.anthropic.com/en/docs/claude-code

## Context

- Read `AGENTS.md` first.
- Read `.agent/STATE.md`, `.agent/PROJECT.md`, `.agent/ROADMAP.md`, `.agent/project_profile.yaml`, and `.agent/context/project-context.md`.

## Workflow Protocol

1. Discuss: confirm intent, constraints, and edge cases.
2. Plan: required for non-trivial work; include verification steps.
3. Execute: make focused, reversible edits with clear ownership.
4. Verify: run tests/checks and confirm observed behavior.
5. Report: summarize changes, risks, and verification evidence.

## Delegation Policy

- Use subagents when specialization or parallel execution clearly helps.
- Avoid delegation for urgent blocking work that can be done directly.
- Keep one clear subtask per subagent and avoid overlapping write scope.

## Memory and Cost Policy

- Keep the default path library-first: `pip install skillsmith` must remain sufficient.
- Reuse cached retrieval context before expensive reasoning passes.
- Follow five layers for memory reliability: observer, reflector, session recovery, reactive watcher, pre-compaction safeguard.
- Require cache TTL and fingerprint invalidation for context reuse.
- Keep enterprise infrastructure optional, not required for core user workflows.

## Role Use

- `orchestrator`: set plan, assign role ownership, and gate completion.
- `researcher`: gather constraints and evidence before implementation starts.
- `implementer`: make focused edits and provide verification artifacts.
- `reviewer`: produce findings-first validation and regression checks.

## Role Handoff

- Include goal, scope, file list, verification run, and unresolved risks in each handoff.
- Prefer `researcher -> implementer -> reviewer -> orchestrator` for non-trivial tasks.

## Completion Bar

- Keep changes aligned with `.agent/PROJECT.md` and `.agent/ROADMAP.md`.
- Never mark done without concrete verification evidence.
- Prefer the simplest correct solution over unnecessary complexity.

## Skills and Commands

- Skills live in `.agent/skills/` (`SKILL.md` per skill).
- Run `skillsmith list` to view skills.
- Run `skillsmith add <name>` to add a skill.
- Run `skillsmith lint` to validate skill structure.
