Files

Bernardo Magri 82776d7da4 docs(webcam): portal/Flatpak IR gap is v4l2-only (#71 )

Ship the recommended document-only path: WirePlumber hideIrSensor acts
on the v4l2 monitor only; libcamera / xdg-desktop-portal / Flatpak
camera pickers can still list the internal IR sensor.

- HARDWARE.md §7: dual-sensor subsection (scope, workaround, deferred)
- ROADMAP § Webcam: ✓ #71; (b)/(c) stay hardware-gated
- README option row + HARDWARE-QUEUE T14s check for (b)/(c)
- Close BACKLOG #71; no libcamera rules

Verified: V0 (docs only).

2026-07-10 09:39:10 +01:00

BACKLOG.md

docs(agent): PROPOSED breadcrumbs for #64–#75 promotion

2026-07-10 09:29:34 +01:00

CONVENTIONS.md

docs: factual-drift pass + i2c option docs (#47 , #48 )

2026-07-09 19:09:00 +01:00

GOALS.md

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

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

HARDWARE-QUEUE.md

docs(webcam): portal/Flatpak IR gap is v4l2-only (#71 )

2026-07-10 09:39:10 +01:00

JOURNAL.md

docs(agent): promote agent-actionable PROPOSED → NEXT #64–#75

2026-07-10 09:29:01 +01:00

LOOP.md

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

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

MEMORY.md

fix(tools): identity audit exemptions + import hierarchy (#69 #70 )

2026-07-10 09:39:10 +01:00

README.md

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

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

README.md

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.

README.md Unescape Escape

Agent loop state

Files

Product / design docs (not a queue)

Claude Code only

Rules of thumb

README.md