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.
# 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.