# System

Five layers.
No overlap.
No drift.

```text
MISSION  means why Smith exists
RULES    means how Smith is built
SPECS    means what Smith must do
RESEARCH means evidence cache
ISSUES   means bug memory
PLANS    means temporary execution notes
```

## Ownership

- MISSION, RULES, specs: human-owned. Agents edit only after explicit request.
- Research, issues, plans: agents may create/update.

## XRefs

One direction only:

- Issues point to specs.
- Tests point to specs.
- Specs do not point to issues, tests, or plans.

## Naming

- Specs: `SMH-SPEC-XXXXXXXX-slug/index.md`
- Issues: `SMH-ISSUE-XXXXXXXX-slug/index.md`
- Plans: `SMH-PLAN-XXXXXXXX-slug/index.md`
- Research: `SMH-RESEARCH-XXXXXXXX-slug/index.md`

## Style

Terse.
Direct.
No hedging.
No duplicated source of truth.