From b35e6993848f3d2fbd680cf3ae701efa8d8f45dd Mon Sep 17 00:00:00 2001 From: Keysat Date: Sun, 14 Jun 2026 12:35:25 -0500 Subject: [PATCH] Document capture/triage/roundup in README rhythm; capture ten31-transcripts retrofit Add the inbox loop (/capture, /triage, /roundup) to README's 'The rhythm' section. Capture the ten31-transcripts mini-retrofit to INBOX.md with step-by-step instructions for next triage. Reconcile ROADMAP item 6 + Current state: recap-relay remote added/pushed in a later session. --- AGENTS.md | 19 ++++++++++--------- INBOX.md | 1 + README.md | 6 +++++- ROADMAP.md | 5 +++-- 4 files changed, 19 insertions(+), 12 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a50a51f..5f4bb87 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -96,19 +96,20 @@ should carry this so any vendor's agent surfaces pending items at session start: - The cross-repo git-hygiene audit (ROADMAP item 6) is **DONE**: all 9 git repos under `~/Projects` audited (one read-only `portability-checker` each). No safety issues anywhere — zero tracked `.env`/`.DS_Store`/`*.local.json`, all in-repo symlinks relative. 6 repos - remediated (inbox-check line + canonical `.gitignore`) and pushed; `recap-relay` is - committed locally only (no git remote). + remediated (inbox-check line + canonical `.gitignore`) and **all pushed** (`recap-relay`'s + Gitea remote was added in a later session). - The audit drove a **standards change**: `portability.md`'s canonical `.claude/` block is now **deny-by-default** (`.claude/*` + an allow-list of the shared wiring). The old allow-by-default block would have un-ignored `premier-gunner`'s password-bearing `.claude/launch.json` — deny-by-default keeps stray scratch/secrets out by default. The two retrofit summaries were updated to match. - The inbox-check line + canonical `.gitignore` are threaded into the retrofit flow *and* now - live in the 6 remediated repos. Still missing from `ten31-transcripts` (needs a mini-retrofit) - and from the many **non-git folders** under `~/Projects` (unprotected work). + live in the 6 remediated repos. Still missing from `ten31-transcripts` (now **captured to + `INBOX.md`** with step-by-step instructions, for a mini-retrofit on its next `/triage`) and + from the many **non-git folders** under `~/Projects` (unprotected work). +- `/capture`, `/triage`, `/roundup` are now documented in README's "The rhythm" section. - Specced in `ROADMAP.md`, not built: the `new-project` bootstrap (item 5), the cross-repo - quality-gate standard (item 1), and the SessionStart hook (item 3). Item 6 residuals: - `ten31-transcripts` mini-retrofit, a Gitea remote for `recap-relay`, the non-git-folder sweep. -- Next session: (1) work the item-6 residuals — `ten31-transcripts` mini-retrofit and a remote - for `recap-relay`; (2) build the `new-project` bootstrap (item 5); (3) add `/capture`, - `/triage`, `/roundup` to README's "The rhythm" section. + quality-gate standard (item 1), and the SessionStart hook (item 3). Open item-6 residuals: + the `ten31-transcripts` mini-retrofit (queued in the inbox) and the non-git-folder sweep. +- Next session: (1) build the `new-project` bootstrap (item 5); (2) the non-git-folder sweep + (item-6 residual). The `ten31-transcripts` retrofit is queued in the inbox for that repo. diff --git a/INBOX.md b/INBOX.md index 76751a2..3b2d9d5 100644 --- a/INBOX.md +++ b/INBOX.md @@ -31,3 +31,4 @@ Example: ## Items +- [ ] (ten31-transcripts) [chore][P1] Mini-retrofit — repo is an active Xcode/Swift app but has NO `.claude/` dir. Do, in order: (1) add the portable inbox-check line to `AGENTS.md`, tagged `(ten31-transcripts)`; (2) create `.claude/settings.json` (at minimum `{}`) so shared project config/hooks become committable; (3) bring `.gitignore` to the canonical block in `standards/portability.md` → "What git tracks" — the deny-by-default `.claude/*` + allow-list, **plus** `.env.*` and `!.env.example` (both currently missing); (4) judgment call — only if the flat `docs/NN_*.md` files are genuinely subsystem-scoped, reorganize them into `docs/guides/` + `.claude/rules/` relative symlinks with one index line each in AGENTS.md. The `CLAUDE.md → AGENTS.md` symlink is already correct; no secrets are currently tracked. Full context: `standards` ROADMAP item 6 residuals — from the cross-repo git-hygiene audit, 2026-06-14 diff --git a/README.md b/README.md index 6f57c94..c5fef0c 100644 --- a/README.md +++ b/README.md @@ -41,4 +41,8 @@ The governing question: **would a different agent need this to work on the repo? ## The rhythm (canonical homes elsewhere) -One session = one task. Close every session with `/handoff` (updates Current state in AGENTS.md, commits, pushes). `/compact` is for mid-task overflow only, never to extend a finished chat. Dropped or closed by accident? `claude -c` resumes the latest session in that folder. Full daily rhythm: retrofit-playbook.md, Part 5. +One session = one task. Close every session with `/handoff` (updates Current state in AGENTS.md, commits, pushes). `/compact` is for mid-task overflow only, never to extend a finished chat. Dropped or closed by accident? `claude -c` resumes the latest session in that folder. + +Between tasks, ideas flow through the inbox: `/capture` logs an idea or bug for any repo to `INBOX.md` from wherever you are (no routing decision at capture time); `/triage`, run inside a project, drains that repo's items into its Current state or `ROADMAP.md`; and `/roundup` reads every repo's AGENTS.md/ROADMAP plus the inbox and compiles one priority-grouped to-do list across all projects (reports only — deciding focus stays with you). Canonical home: `AGENTS.md` → "The capture → triage → roadmap loop." + +Full daily rhythm: retrofit-playbook.md, Part 5. diff --git a/ROADMAP.md b/ROADMAP.md index dc41f52..9c1405d 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -124,8 +124,9 @@ allow-by-default and would have *un-ignored* `premier-gunner`'s password-bearing - **`ten31-transcripts` (MAJOR) — needs its own mini-retrofit.** Despite the name it's an active Xcode/Swift app with no `.claude/` at all. Scaffold `.claude/settings.json`; decide whether to reorganize its flat `docs/NN_*.md` into `docs/guides/` + `.claude/rules/` symlinks. - Too big for the mechanical pass. -- **`recap-relay` has no git remote** — committed locally only; create a Gitea repo + push. + Too big for the mechanical pass — **captured to `INBOX.md`** (tagged `(ten31-transcripts)`) + with step-by-step instructions, for pickup on the next `/triage` in that repo. +- **`recap-relay` remote** ✅ Gitea `origin` added + pushed in a later session. - **`premier-gunner/s9pk/.gitignore`** lacks the secrets/Claude lines (low priority; the root `.gitignore` covers `.env` tree-wide already). - **Many non-git folders under `~/Projects` are unprotected work** (discount-watcher,