diff --git a/AGENTS.md b/AGENTS.md index 158e281..9ed2f78 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -87,52 +87,31 @@ should carry this so any vendor's agent surfaces pending items at session start: ## Current state -- **The fleet is built and live.** Commands `/capture`, `/triage`, `/roundup`, - `/new-project`, `/handoff`, `/retrofit`, `/full-eval` (substance in `guides/`, thin wrappers - in `adapters/claude/`, symlinked into `~/.claude`). The repo dogfoods its own standard: - inbox-check line, deny-by-default `.gitignore`, relative symlinks, capture→triage→roadmap loop. -- `/roundup` writes a tracked `STATUS.md` snapshot each run (overwritten, committed + pushed — - diffable over time); latest snapshot dated 2026-06-16. -- **Design system built (2026-06-16, ROADMAP item 8).** `/design` (main-thread command) runs - the inspiration-first design round-trip → a vendor-neutral on-disk contract (`design/DESIGN.md` - nine-section brief + `design/tokens.tokens.json` DTCG tokens); `design-checker` (read-only - subagent) audits a repo's UI against its own contract. Claude Design (cloud-only/experimental) - is the interchangeable front-end, never a dependency — its export is inline-hardcoded HTML/CSS, - so Phase-C token distillation is agent-mediated (research-verified 2026-06-16). `/new-project` - now scaffolds `design/` for user-facing projects. -- `/new-project` is the inverse of `/retrofit`: workshops a captured `(new)` idea into a - standards-compliant repo and publishes to Gitea via a manual-create gate; the stack quality - gate is deferred to a future `/harden`. Now carries a **form-factor gate** (is this even a - standalone repo, or a feature/skill/agent of something that exists? — bail + reroute if so), - a **worth-building gate** at sign-off (build effort + ongoing tax → BUILD/PARK/ADOPT), a - **placement** step that walks `guides/placement.md`, the falsifiable-exit "substance rule," - and a posture section — all harvested from a retired `idea-workshop` skill. A new project's - architectural decisions live in its `AGENTS.md` `## Decisions` section (no separate ADR file). -- `guides/placement.md` is a shared reference (where a project should run / which model / - what data layer). **Its infra facts were verified with me 2026-06-15** (ROADMAP item 7 done): - x86 StartOS 0.4.0 box + full service list; the two-Spark role split (LLM vs audio/speech, - Qdrant on the audio Spark, matrix-bridge hosted there); route via the Spark Control gateway - and query the active model rather than hardcoding one; LAN/WireGuard/StartTunnel networking. - UNVERIFIED banner dropped. -- **The upgraded `/new-project` flow has had its first live end-to-end run** — - scaffolded `~/Projects/matrix-bridge` (a Matrix→Claude Code bridge bot) from a prior - scoping package, folding its SPEC/DECISIONS into the new AGENTS.md `## Decisions` scheme. - The form-factor gate (worthy of its own repo) and the placement step worked cleanly in - practice; portability-checker passed. Good worked example of the flow. -- Cross-repo git-hygiene audit done: 9 repos audited, no leaks, 6 remediated + pushed; the - canonical `.claude/` block is now **deny-by-default** (in `portability.md`; full detail in - git log + ROADMAP item 6). -- This session: ran `/roundup` (STATUS.md snapshot 2026-06-15); verified & corrected - `guides/placement.md` with me and committed it (ROADMAP item 7 done); captured a - `(ten31-database)` networking-doc fix to `INBOX.md`; and resolved the `how-i-work.md` - consolidation — promoted the **instruction-file-structure** convention and added a - **promote-without-trim** principle (commit `f7e9e29`), and decided against any fleet-wide - trimming (per-repo AGENTS.md files aren't bloated, and in-repo copies aid self-containment). -- **Next steps:** (1) the cross-repo quality-gate standard + `/harden` (ROADMAP item 1 — also - unblocks `/new-project`'s deferred quality-gate step); (2) the non-git-folder sweep under - `~/Projects` (item-6 residual; count ~13); (3) first live `/design` run + `design-checker` - backfill on a user-facing repo, which will also confirm what Claude Design's export actually - contains and let us tune Phase-C distillation (ROADMAP item 8 remaining options). -- Queued elsewhere / specced-not-built: the `ten31-transcripts` mini-retrofit and a new - `(ten31-database)` networking-doc fix wait in `INBOX.md` for those repos' `/triage`; the - SessionStart hook (item 3) and inbox-line bootstrap threading (item 4) remain on the ROADMAP. +- **Fleet built and live** — commands `/capture /triage /roundup /new-project /handoff + /retrofit /full-eval /design`; subagents incl. `design-checker` (substance in `guides/`, thin + wrappers in `adapters/claude/`, symlinked into `~/.claude`). The repo dogfoods its own standard. + Finished-work detail (`/new-project` upgrade, `placement.md` verification, git-hygiene audit) + lives in git log + ROADMAP items 5–7. Latest `/roundup` snapshot: `STATUS.md` 2026-06-16. +- **Design system shipped this session (ROADMAP item 8).** `/design` (main-thread) runs the + round-trip → a vendor-neutral on-disk contract (`design/DESIGN.md` nine-section + + `design/tokens.tokens.json` DTCG); `design-checker` (read-only subagent) audits a repo's UI + against its own contract; `/new-project` scaffolds `design/` for user-facing projects. The + on-ramp handles fresh / import / extract / refine with a document-vs-redesign posture and a + **Phase-D learning loop** (Field notes accrete in `guides/design.md`). The guide is + **vendor-agnostic about the harness** — Claude Design is the named default visual tool, not an + assumption; the contract never depends on a proprietary export. +- **First live pilot ran end-to-end:** keysat backfill (import, document-as-is). Contract + committed to `keysat-root` (`532229d`); the prior Claude Design system relocated to keysat's + `design/_imports/` as provenance; `design-checker` produced a clean backlog (3 gold-as-fill / + pill-radius blockers + token gaps) → in keysat ROADMAP **and** captured to `INBOX.md` (P2). +- Also this session: deleted `start-os` (it was a pristine external Start9 upstream clone — none + of our work); fixed `premier-gunner`'s stale "set a real password" next-step (already set). +- **Next steps:** (1) **backfill design into recaps.cc / recap** — the extract→reconcile + **Case B** path (organic aesthetic, no prior guidelines), the on-ramp not yet tested; + (2) cross-repo quality-gate standard + `/harden` (ROADMAP item 1); (3) non-git-folder sweep + under `~/Projects` (~13). +- **Open:** a *fresh* Claude Design run is still needed to confirm what its export actually + contains and tune Phase-C distillation — keysat was an import of a prior artifact, not a live + export; the related Field-note seeds stay marked "confirm on first live run." +- Queued in `INBOX.md` for other repos' `/triage`: keysat design cleanup (P2), + `ten31-transcripts` mini-retrofit, `ten31-database` networking-doc + oversized-icon items.