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.
2.2 KiB
2.2 KiB
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;v1is human-only — never touch it. Nevernix flake updateunless 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.