102 lines
5.7 KiB
Markdown
102 lines
5.7 KiB
Markdown
# Session 0001.0 — Transcript
|
|
|
|
> App: dev-claude-plugin
|
|
> Start: 2026-06-03T17-09 (PST) · End: 2026-06-03T17-10 (PST)
|
|
> Goal: Teach `wgl-coding-session-init` to propose the next roadmap goal and warn on an unclean baseline.
|
|
> Outcome: Shipped to `main` (plugin v0.2.0 → operator bumped to v0.3.0). First transcript for this app.
|
|
|
|
> Note on timing: this session did **not** run `wgl-coding-session-init`, so no ID
|
|
> was claimed at start. The ID was claimed retroactively at finalize; the start
|
|
> stamp is the claim time, not the true session start (which was earlier).
|
|
|
|
## Plan
|
|
|
|
1. In an app repo, make `wgl-coding-session-init`'s output a ready-to-run `/goal`
|
|
prompt naming the next milestone/phase from the app's roadmap.
|
|
2. Add a clean-baseline check: warn if there are changes not on `origin/main`,
|
|
and propose a course of action.
|
|
3. (later, from operator) Edit plugin **source only**; document that policy in
|
|
the plugin repo's `CLAUDE.md`. Operator owns pulling new plugin versions.
|
|
|
|
## Pre-session state
|
|
|
|
- `wiggleverse-dev-claude-plugin` at seed commit `633c1be` on `main`, plugin
|
|
version 0.1.0. Working tree carried in-flight (uncommitted) work from another
|
|
effort: a docs-first rewrite in `SKILL.md`, an untracked `DEPLOY-FLOTILLA.md`,
|
|
and an untracked `skills/wgl-dev-handbook/`.
|
|
- `wgl-coding-session-init/SKILL.md` claimed an ID, surfaced in-flight sessions,
|
|
and seeded a plan block, but had no notion of "what to work on next" and no
|
|
baseline-cleanliness check.
|
|
- `resolve-app.py` resolved only the **sessions** target from `app.json`; it had
|
|
no concept of the **roadmap** repo.
|
|
|
|
## Turn-by-turn arc
|
|
|
|
1. **Located the canonical source.** Four copies of the skill exist (repo source,
|
|
`~/.claude/skills`, plugin marketplace, plugin cache). Established the repo as
|
|
source of truth; the rest are downstream deploys.
|
|
2. **Studied the resolver + roadmap shape.** `app.json` expresses repo roles via
|
|
a `contains` controlled vocab that includes `"roadmap"`. The roadmap repo for
|
|
ohm is `ben/ohm-rfc` → `ROADMAP.md` (prose, with "shipped"/"operator wants
|
|
this next" markers and a wave/track dispatch model). Concluded "next item"
|
|
selection is agent judgment, not a parser.
|
|
3. **Extended `resolve-app.py`** to emit `ROADMAP_NAMESPACE/NAME/REMOTE/REPO_DIR`.
|
|
First cut located the local clone by a `<namespace>/<name>` path suffix and
|
|
came back empty — because a clone's parent dir need not mirror its origin
|
|
namespace (origin `ben/ohm-rfc` is checked out under `…/ben.stull/ohm-rfc`).
|
|
Fixed by prefiltering on the directory **basename** (`== name`) and verifying
|
|
by **origin**. Verified against ohm (resolves), ecomm (resolves to
|
|
`wiggleverse-ecomm-meta`), benstullbets (empty, no error).
|
|
4. **Added two steps to `SKILL.md`** — Step 7 (clean, pushed-`main` baseline
|
|
warning + proposed course of action) and Step 8 (propose the next
|
|
milestone/phase as a `/goal <…>, per <roadmap>/ROADMAP.md` line), plus a
|
|
description update and a docs-table row. Created `CLAUDE.md` documenting the
|
|
**source-only editing policy** + version-bump-on-ship.
|
|
5. **Dry-ran Step 8 against ohm.** Surfaced that ohm's `ROADMAP.md` has competing
|
|
structures (a formal wave plan ending at #13/v0.15.0 vs. later session notes
|
|
referencing v0.19/v0.20 shipped) and a **stale** pointer ("operator wants #30
|
|
next" — #30 is shipped). Hardened Step 8 with an *ambiguity → confirm-with-
|
|
operator* clause rather than asserting a single answer.
|
|
6. **Bumped + committed + pushed.** plugin.json 0.1.0 → 0.2.0; committed the
|
|
coherent unit (resolver + SKILL Steps 7/8 + `CLAUDE.md` + the coupled
|
|
`DEPLOY-FLOTILLA.md`, which `SKILL.md` references) as `e4b3226`, pushed over
|
|
SSH. Left `skills/wgl-dev-handbook/` untracked (unreferenced standalone skill).
|
|
7. **Finalize.** Operator landed `wgl-dev-handbook` + bumped to v0.3.0 (with a
|
|
description mentioning the handbook Q&A skill) and pushed. Updated memory.
|
|
Initially the plugin repo had no `app.json` so the transcript flow had no
|
|
home; operator added one on `main`, enabling this transcript.
|
|
|
|
## Cut state (end of session)
|
|
|
|
- `main` clean and pushed. Plugin **v0.3.0**.
|
|
- This session's change: commit **`e4b3226`** ("Session-init: propose next /goal
|
|
from roadmap + warn on unclean baseline") — `resolve-app.py`,
|
|
`wgl-coding-session-init/SKILL.md`, `CLAUDE.md`, `DEPLOY-FLOTILLA.md`,
|
|
plugin.json bump.
|
|
- `app.json` now lists this repo; sessions target `wiggleverse/session-history`
|
|
under `dev-claude-plugin/`, numeric. This is session **0001**.
|
|
- Memory updated: `project_dev_claude_plugin.md` + `MEMORY.md` index line.
|
|
|
|
## What lands on the operator's plate
|
|
|
|
- **Pull the new plugin version** (`/plugin marketplace update` + `/plugin
|
|
install`) to make Steps 7/8 live in running sessions — per `CLAUDE.md`, agents
|
|
don't touch deployed copies; the operator owns this.
|
|
- **Duplicate install**: a standalone `~/.claude/skills/` copy still shadows the
|
|
plugin's copies. Worth deduping someday.
|
|
- **Field-test Step 8** in a real app repo (ohm/ecomm) to sanity-check the
|
|
`/goal` line it produces on a prose roadmap.
|
|
|
|
## Prompt the operator can paste into the next session
|
|
|
|
```
|
|
Open the wiggleverse-dev-claude-plugin repo (~/git/wiggleverse.org/wiggleverse/
|
|
wiggleverse-dev-claude-plugin, v0.3.0). Read memory project_dev_claude_plugin.md
|
|
first. Session-init just gained Step 7 (clean-baseline warning) and Step 8
|
|
(propose next roadmap goal as a /goal prompt). Next: (a) field-test Step 8 by
|
|
running wgl-coding-session-init in a real app repo (ohm/ecomm) and sanity-check
|
|
the /goal line it produces; (b) dedupe the standalone ~/.claude/skills install
|
|
that still shadows the plugin's copies. Per CLAUDE.md, edit plugin source only
|
|
and bump plugin.json on ship.
|
|
```
|