02d7baeb7c
All checks were successful
Check / eval (push) Successful in 3m7s
Add docs/VISION.md (product themes, v1.0 bar, agent slice hints) and README maps under docs/ and agent/. Point ROADMAP, BACKLOG, LOOP, CLAUDE, HARDWARE, and the root README at the split: VISION = intent, BACKLOG = executable queue, ROADMAP = design history, .claude = harness only. Mark v1.0 track in BACKLOG PROPOSED for human triage.
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# Nomarchy — agent entry point
|
|
|
|
Nomarchy is a NixOS-based distro: rock-stable, fully reproducible, themed
|
|
from one JSON, configured through a menu that writes into the user's own
|
|
flake checkout. Read the README for the architecture.
|
|
|
|
## Where things live (read this first)
|
|
|
|
| Path | Role |
|
|
|------|------|
|
|
| **`agent/`** | Loop state — **only executable queue is `BACKLOG.md`** |
|
|
| **`docs/VISION.md`** | Product themes toward **v1.0** (not a queue) |
|
|
| **`docs/ROADMAP.md`** | Design history + shipped log |
|
|
| **`docs/README.md`** | Full documentation map |
|
|
| **`agent/README.md`** | Map of loop files |
|
|
| **`.claude/`** | Claude Code only (permissions + subagents) — not the backlog |
|
|
|
|
## If you're here to work autonomously (the loop)
|
|
Follow **`agent/LOOP.md`** — one iteration: orient → pick one BACKLOG
|
|
item → work → verify → commit+push on `main` → record. All loop state is
|
|
git-tracked in `agent/`.
|
|
|
|
## Rules that apply to every session, loop or not
|
|
- **Honesty rule** (`docs/TESTING.md`): for visual/interactive changes,
|
|
evaluation is not rendering — state the tier you reached. Cheap first:
|
|
`nix flake check --no-build`.
|
|
- **Conventions** (`agent/CONVENTIONS.md`): in-flake state, menu
|
|
placement, Waybar parity with whole-swaps, toggle-vs-package discipline,
|
|
template as SoT for opt-in comments (`templates/downstream`).
|
|
- **Git:** direct commits on `main`, pushed; **`v1` is human-only** —
|
|
never touch it. Never `nix flake update` unless the task is a lock bump.
|
|
No formatter — match aligned hand-formatting.
|
|
- Layout: `hosts/` machine · `modules/` distro · `themes/` data ·
|
|
`pkgs/` code · `tools/` maintainer · `agent/` loop · `docs/` human docs.
|
|
|
|
## Delegation
|
|
|
|
Push mechanical work down; keep judgment. Brief every child cold.
|
|
|
|
| Model | Best for | Delegate? | Effort |
|
|
|---|---|---|---|
|
|
| Haiku | bulk mechanical | never | low |
|
|
| Sonnet | scoped research | when it helps | medium |
|
|
| Opus 4.8 | multi-step reasoning | on clear benefit | xhigh |
|
|
| Fable 5 | judgment, taste | by default | medium |
|
|
|
|
Fable goes xhigh only for the hardest calls. Skip high.
|
|
|
|
## Escalation
|
|
|
|
An Opus parent can spawn a Fable child for one hard call. Work above your
|
|
tier? Return it — don't burn tokens.
|