CLAUDE.md · diff

git:20260927.c2bc6a2 to git:20261008.20a13ff

0 added, 4 removed. Audit A to A.

# Claude Code Instructions
@AGENTS.md
## Claude Code Specifics
For non-trivial tasks, delegate to specialized agents via Task tool:
- `Task(subagent_type="orchestrator")` for multi-step coordination
- `Task(subagent_type="Explore")` for codebase exploration
- Specialized agents (implementer, architect, analyst, etc.) for focused work
### Installation Locations
| Type | Agents | Skills |
|------|--------|--------|
| Global | `~/.claude/agents/` | `~/.claude/skills/` |
| Per-repo | `.claude/agents/` | `.claude/skills/` |
ADR-064 retired `.claude/commands/`. Skills are the single user-invocable
surface, and a blocking validator refuses a command file under any plugin root.
### Default Behavior
For non-trivial tasks: `Task(subagent_type="orchestrator", prompt="...")`
- ## Memory
-
- Start with `/memory-search`; the `memory` skill's router covers deeper tiers and `search_memory.py`. Raw `mcp__serena__read_memory` is the last resort.
-
## Path-scoped instructions
Before editing any file, read matching rules in `.claude/rules/*.md`; Claude Code reads that tree at runtime. Since ADR-109 B2 the edit location is `templates/rules/<name>.md`; `uv run python build/scripts/build_all.py` renders, mirrors, and binplaces it. A rule's `paths` frontmatter is the scope key; `check_rule_scope_keys.py` refuses any other. Universal rules live in `universal.md`.
The same run ships the Copilot copies under `.github/instructions/` and `src/copilot-cli/instructions/`.
## Skill routing
Explicit skill invocations still win: when the request names an available skill or uses that skill's slash command, invoke that skill first. Concrete requests that name no skill go through `/autoplan` below.
`/autoplan` is the canonical intent router for concrete requests that name no skill, per ADR-078. It routes to skills, lifecycle commands, and agent handoffs (for example orchestrator for multi-step work), not skills alone. Keep the routing table in `.claude/skills/autoplan/SKILL.md`; do not duplicate it here.
Explicit routing rules not owned by autoplan:
- Retro trigger → invoke retrospective skill
## Lifecycle skills
Dev lifecycle phases. ADR-064 retired `.claude/commands/`, so these are skills
like every other user-invocable surface; `/spec` and the rest still type the same
because Claude Code fires a `user-invocable` skill by name:
- Define requirements, "what should we build" → spec
- Plan work, break down tasks, estimate → plan
- Implement, code, build features → build
- Test, prove it works, debug failures → test
- Review code, check my diff, architecture review → review
- Ship, deploy, push, create PR → ship