Files

Bernardo Magri 02d7baeb7c

Check / eval (push) Successful in 3m7s

Details

docs: VISION for v1.0 + clarify docs/ vs agent/ vs .claude

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.

2026-07-09 09:33:51 +01:00

2.0 KiB

Raw Blame History

Agent loop state

Git-tracked state for autonomous and assisted work on Nomarchy. Protocol: LOOP.md. Entry for most harnesses: repo-root CLAUDE.md.

Files

File	Who writes	Role
LOOP.md	Human	One-iteration protocol (orient → pick → work → verify → commit → record)
GOALS.md	Human (agents propose)	Pillars, quality bars, non-goals
CONVENTIONS.md	Human (agents propose)	How to write code/menu/state while shipping
BACKLOG.md	Both	Prioritized queue — only executable work list
JOURNAL.md	Agents	Append-only iteration log (read last 3–5 entries)
MEMORY.md	Agents	Curated durable gotchas
HARDWARE-QUEUE.md	Agents append, human checks	On-hardware V3 tests only Bernardo can run

Product / design docs (not a queue)

File	Role
../docs/VISION.md	v1.0 product themes — agents slice into BACKLOG PROPOSED
../docs/ROADMAP.md	Design history + shipped log
../docs/README.md	Full docs map

Claude Code only

Path	Role
../.claude/settings.json	Tool permissions
../.claude/agents/	`nomarchy-scout` / `nomarchy-runner` subagent defs

Do not put backlog items or vision text under .claude/ — it is not shared with other agent runners.

Rules of thumb

Execute from BACKLOG only (NOW → NEXT; never PROPOSED without human triage).
Orient with GOALS + CONVENTIONS + MEMORY + last journal + BACKLOG; when the task is product-shaped, also read the relevant VISION §.
Record lasting design in ROADMAP ✓ when something ships that future humans should know; delete the BACKLOG line.
v1 branch is human-only — never advance from an agent session.

2.0 KiB Raw Blame History Unescape Escape