Luigit
repositories / smith

smith

There are many coding harnesses - but this one is fast

owned by admin

.system/SYSTEM.md

Raw
Rendered preview

System

Five layers. No overlap. No drift.

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.