Handoff: refresh Current state — design system shipped, recaps.cc next

This commit is contained in:
Keysat
2026-06-16 12:56:31 -05:00
parent e069ae0a13
commit 123072f8ad
+28 -49
View File
@@ -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 57. 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.