bernardo/Nomarchy
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Nomarchy/agent
History
Bernardo Magri 374f70c76f
All checks were successful
Check / eval (push) Successful in 4m15s
Details
Lock bump / bump (push) Successful in 1m28s
Details
docs(backlog): re-measure #146 — zero genuine hypridle zombies post-fix 
Re-ran the measurement per the entry's own recipe on the dev box (user
journal persistent to 2026-05-01, full window). Post-linger-fix
(2026-07-16 ~18:00 on) every `Disconnected from pollfd id 1` is a clean
teardown bracketed by a logind `Session N logged out` + a systemd
`Stopped hypridle` within <=11s (07-16 20:13, 07-17 17:04, 07-18 13:35,
07-19 16:46). Zero genuine zombies. Live daemon healthy (ss Recv-Q 0,
NRestarts=0, active, ExecMainPID==pid). Caveat: all four were deliberate
logouts, no compositor crash post-fix yet, so the crash path is confirmed
by argument not observation, and 4 days < the "few weeks" bar. Set an
explicit close condition (~2026-08-10 if still 0). Not closing today.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 19:48:00 +01:00
..
BACKLOG.md
docs(backlog): re-measure #146 — zero genuine hypridle zombies post-fix
2026-07-20 19:48:00 +01:00
CONVENTIONS.md
feat(themes): kiln + kiln-clay — the third exclusive pair, brand new
2026-07-18 13:05:24 +01:00
DELEGATION.md
docs(agent): vendor-neutral agent docs — AGENTS.md entry, agent/ SoT, .claude shims
2026-07-11 08:58:25 +01:00
GOALS.md
refactor(#107): theme-state.json → state.json, theme-sync → state-sync
2026-07-15 11:26:59 +01:00
HARDWARE-QUEUE.md
refactor(display): extract the shared display-transition + keyboard tools (#150)
2026-07-20 19:17:57 +01:00
JOURNAL-ARCHIVE.md
chore(agent): QA sweep + journal rotate (queue empty)
2026-07-11 10:40:57 +01:00
JOURNAL.md
fix(gtk): scope the #98 button-label pin to dialogs — it was repainting the bar
2026-07-19 11:04:49 +01:00
LOOP.md
chore(agent): sync-sweep rule on task completion + apply it; zram user docs
2026-07-11 09:20:54 +01:00
MEMORY.md
docs: #127 CLOSED — the brick was hypridle eating its own resume path
2026-07-17 08:05:09 +01:00
README.md
chore(agent): drop .claude/skills — AGENTS.md carries the routing
2026-07-11 09:06:32 +01:00
THEME-DESIGN.md
feat(terminal): Kitty only — drop Ghostty (#95)
2026-07-15 09:51:27 +01:00
VERIFICATION.md
feat(flake): #134 — unstable.<pkg> in the downstream, one input, no hand pins
2026-07-17 15:16:29 +01:00

README.md

Agent instructions + loop state

Everything an AI agent needs to work on Nomarchy, vendor-neutral and git-tracked. Protocol: LOOP.md. Entry point for every harness: repo-root AGENTS.md.

Instructions (how to work)

File Who writes Role
LOOP.md Human One-iteration protocol (orient → pick → work → verify → commit → record) + the V0–V3 ladder
VERIFICATION.md Human (agents propose) Enforcement: preflight, honesty rules, visual protocol, hardware-blocked checks, reporting
DELEGATION.md Human (agents propose) Capability tiers, scout/runner roles, token economy, parallel fan-out
GOALS.md Human (agents propose) Pillars, quality bars, non-goals
CONVENTIONS.md Human (agents propose) How to write code/menu/state while shipping
THEME-DESIGN.md Human (agents propose) Theme/visual design instructions

State (what's happening)

File Who writes Role
BACKLOG.md Both Prioritized queue — only executable work list
JOURNAL.md Agents Append-only iteration log (read last 3–5 entries; older → JOURNAL-ARCHIVE.md)
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

Harness adapters (vendor-specific, thin)

Shared content never lives in an adapter — adapters only register/route into the files above, in whatever format their harness requires.

Path Harness Role
../AGENTS.md any Entry point (CLAUDE.md is a symlink to it)
../.claude/settings.json Claude Code Tool permissions
../.claude/agents/ Claude Code nomarchy-scout / nomarchy-runner role defs (contracts in DELEGATION.md)

Do not put backlog items, vision text, or policy under an adapter directory — it is not shared with other agent runners.

Rules of thumb

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