bernardo/Nomarchy

Fork 0

Files

History

Bernardo Magri 374f70c76f

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

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 instructions + loop state

Instructions (how to work)

State (what's happening)

Product / design docs (not a queue)

Harness adapters (vendor-specific, thin)

Rules of thumb

README.md