Mark ROADMAP item 7 (placement guide) done; refresh Current state

This commit is contained in:
Keysat
2026-06-15 17:29:47 -05:00
parent d9850f8ad8
commit 7ed43fcb59
2 changed files with 31 additions and 32 deletions
+21 -16
View File
@@ -92,7 +92,7 @@ should carry this so any vendor's agent surfaces pending items at session start:
in `adapters/claude/`, symlinked into `~/.claude`). The repo dogfoods its own standard: 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. 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 — - `/roundup` writes a tracked `STATUS.md` snapshot each run (overwritten, committed + pushed —
diffable over time); latest snapshot dated 2026-06-14. diffable over time); latest snapshot dated 2026-06-15.
- `/new-project` is the inverse of `/retrofit`: workshops a captured `(new)` idea into a - `/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 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 gate is deferred to a future `/harden`. Now carries a **form-factor gate** (is this even a
@@ -101,10 +101,12 @@ should carry this so any vendor's agent surfaces pending items at session start:
**placement** step that walks `guides/placement.md`, the falsifiable-exit "substance rule," **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 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). architectural decisions live in its `AGENTS.md` `## Decisions` section (no separate ADR file).
- `guides/placement.md` is a new shared reference (where a project should run / which model / - `guides/placement.md` is a shared reference (where a project should run / which model /
what data layer), ported from that skill. **Its infra facts are UNVERIFIED** — generated what data layer). **Its infra facts were verified with me 2026-06-15** (ROADMAP item 7 done):
one-shot from chat history — and need a review pass with me (ROADMAP item 7); the file and x86 StartOS 0.4.0 box + full service list; the two-Spark role split (LLM vs audio/speech,
`how-i-work.md` both flag this. 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** — - **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 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. scoping package, folding its SPEC/DECISIONS into the new AGENTS.md `## Decisions` scheme.
@@ -113,14 +115,17 @@ should carry this so any vendor's agent surfaces pending items at session start:
- Cross-repo git-hygiene audit done: 9 repos audited, no leaks, 6 remediated + pushed; the - 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 canonical `.claude/` block is now **deny-by-default** (in `portability.md`; full detail in
git log + ROADMAP item 6). git log + ROADMAP item 6).
- Last session: corrected a stale repo name (`Workout-log``proof-of-work`) across - This session: ran `/roundup` (STATUS.md snapshot 2026-06-15); verified & corrected
`STATUS.md`/`ROADMAP.md` after a reviewer pass, and deleted the dead non-git `Workout-log` `guides/placement.md` with me and committed it (ROADMAP item 7 done); captured a
folder (crash logs only). Nothing in progress — committed and pushed; tree clean. `(ten31-database)` networking-doc fix to `INBOX.md`. **Paused mid-task:** a `how-i-work.md`
- **Next steps:** (1) verify & correct `guides/placement.md`'s infra facts with me (ROADMAP consolidation pass — analysis is done (promote 3 gap rules: instruction-file structure,
item 7 — cheap, unblocks trustworthy placement in `/new-project`); (2) the cross-repo verify-by-running, sensitive-data-stays-local; plus a selective trim of now-global
quality-gate standard + `/harden` (ROADMAP item 1 — also unblocks `/new-project`'s deferred duplicates from repo AGENTS.md files) and awaits my go-ahead before any edits.
quality-gate step); (3) the non-git-folder sweep under `~/Projects` (item-6 residual; - **Next steps:** (1) decide the paused `how-i-work.md` consolidation (which of the 3 gap
`Workout-log` cleared, count now ~14). rules to promote; how aggressive to trim repos given the self-containment tradeoff); (2) the
- Queued elsewhere / specced-not-built: the `ten31-transcripts` mini-retrofit waits in cross-repo quality-gate standard + `/harden` (ROADMAP item 1 — also unblocks `/new-project`'s
`INBOX.md` for that repo's `/triage`; the SessionStart hook (item 3) and inbox-line bootstrap deferred quality-gate step); (3) the non-git-folder sweep under `~/Projects` (item-6 residual;
threading (item 4) remain on the ROADMAP. count ~13).
- 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.
+10 -16
View File
@@ -131,20 +131,14 @@ allow-by-default and would have *un-ignored* `premier-gunner`'s password-bearing
"scratch, don't track" decision. "scratch, don't track" decision.
- **`start-os`** is an external upstream (Start9Labs/start-os) — out of scope, no action. - **`start-os`** is an external upstream (Start9Labs/start-os) — out of scope, no action.
## 7. Verify & correct the placement guide ## 7. Verify & correct the placement guide ✅ DONE (2026-06-15)
**Why:** `guides/placement.md` was ported from a one-shot `idea-workshop` skill that was Walked the "Infrastructure facts" section with the owner and corrected it against the real
generated from chat history and **never verified** against the actual setup. Its *decision setup (cross-checked against the project repos + a Spark-control topology dump). Fixes: **x86**
sequence* and *substance rule* are sound; its **infrastructure facts** (Start9 services, StartOS **0.4.0** box + full service inventory (Gitea, Nextcloud, Home Assistant, CLN + RTL,
Spark/Qwen3 model lineup, embeddings/TTS, network/access, data-layer defaults) are Open WebUI, Vaultwarden, Synapse, and every Claude-built app); the two-Spark **role split**
provisional and almost certainly need correcting. The file carries an "UNVERIFIED" banner (LLM Spark = vLLM; audio/speech Spark = Parakeet / Kokoro / Sortformer + TitaNet + bge-m3 +
pointing here until that's done. Qdrant, and it hosts matrix-bridge); **don't hardcode a model — query the Spark Control
gateway** for the live one (daily driver Qwen3.6, hot-swappable); networking reduced to LAN /
**What it touches if wrong:** `/new-project` (Phase 2 walks it for placement) and WireGuard / StartTunnel (Proton VPN + Tor were legacy, dropped). UNVERIFIED banner replaced
`how-i-work.md` (one-line pointer), so stale facts propagate into every new repo's placement with a "verified 2026-06-15" note; decision steps 4 and 6 aligned. Commit `ee5c8bb`.
decision. Worth a focused pass.
**To do:** walk the "Infrastructure facts" section with the user section by section — confirm
or correct each (running Start9 services, the Spark gateway endpoint + Qwen3 details, TTS/
embeddings, WireGuard/iOS access, data-layer defaults) — then drop the UNVERIFIED banner and
update the "last generated" line to a real "last verified" date.