Plan of Work
Plan of Work
Problem framing (SCQH) and the "why" live in MOTIVATION.md. This file is the plan of work: streams, dependencies, next actions.
Decisions locked
- Run Streams 1 and 2 in parallel — build + comms are different work modes, no shared state.
- Stream 1 validates on the TOY example first (remote-work productivity), not a real application.
- Stream 3 (Second Renaissance LTP) deferred until a toy example works end-to-end.
- Stream 4 (Discord bot wiring) dropped this round.
- Skill form — Claude Code skills live in a dedicated top-level
skills/dir (so they're usable by Codex too) and are symlinked into.claude/when needed.
Stream map & dependencies
Stream 1 (build) ─┐ parallel, independent
Stream 2 (comms) ─┘
Stream 3 (2R experiment) ── DEFERRED until Stream 1 toy works
Stream 4 (infra polish) ── DROPPED this round
Stream 5 (goal alignment) ── pilot #1 done on a toy tree; real pilot next
Follow-up plans
- Discord MCP agent access — planned in docs/plans/2026-07-06-discord-mcp-agent-access.md. Goal: use the existing Discord bot with an off-the-shelf MCP server so Claude/Codex can read Discord messages without building a custom integration.
Key unlock: claim-tree-annotation.md already contains a gold-standard toy case — a hand-authored tree for "Does remote work increase productivity?", a source doc (Bloom 2015 Ctrip study), and 3 target annotations mapped to nodes. This is the test fixture for Stream 1. No new data needed to start.
Stream 1 — Product / prototype
- 1a. Tree-gen skill — input claim/question → claim tree. Validate against the hand-authored remote-work tree.
- 1b. Annotation-mapping skill — source doc + tree → fragments mapped to nodes + relation label (supports / complicates / limits) + link back. Validate against the 3 gold annotations.
- 1c. Local Project LTP dashboard — implemented on the toy fixture: a localhost-only, read-only viewer for the six LTP views, evidence, assumptions, the current constraint, next action, and optional throughput history.
- 1c.1. Automatic 2R Research throughput — implemented: the dashboard build semantically diffs committed revisions of the canonical Second Renaissance model and attributes created, updated, and deleted stable nodes to the 2R Research Circle, with a revision-level audit trail.
- 1d. Editable claim/evidence UI — after the read-only model contract proves useful on a new case, evolve the scripted demo into a live app that persists a tree, accepts documents, and accumulates confirmed annotations.
Internal parallelization: 1a → 1b is the natural order, but 1b can start immediately against the gold tree. So 1a and 1b run in parallel; 1c waits on both.
Skills live in skills/ (see skills/README.md).
Stream 5 — Goal alignment (individual → collective)
Given an individual's LTP model and a collective one (e.g. Second Renaissance),
suggest specific, human-confirmed cross-tree links — never auto-merged. Scoped
directly from the project's own 2r-research-circle model (RC-4, UDE-5,
NBR-2, INJ-5, OBS-5/IO-5), which had already diagnosed this exact
feature and prescribed a manual-pilot-then-AI-vs-steward-comparison order.
- 5a.
goal-alignmentskill — done, pilot #1 only. Runs on a synthetic toy individual tree (examples/individual-swe-notes/) against the real Second Renaissance tree; reviewable in the dashboard's new "Alignment pilots" section. Seeskills/goal-alignment/VERIFICATION.md. - 5b. Real pilot — point
project-ltpat an actual individual's notes repo (not the toy example) and rerungoal-alignmentagainst it. - 5c. The actual
IO-5step — an independent human/steward mapping on the same pair of trees, compared against the AI-suggested one, with errors and corrections recorded, before trusting the matching further.
Stream 2 — Narrative / comms
- 2a. Background post — synthesise background + personal story. Blocked on inputs: Jun 6 transcript/recording, written material shared with David, old issue-tree diagrams. Gather these first.
- 2b. Four-step diagram — clean Mermaid of material → tree → doc → annotation. No dependency; start now from
claim-tree-annotation.md.
Immediate next actions
| Stream | Action | Blocker |
|---|---|---|
| 1a | Extend tree-gen beyond the verified gold fixture with one new claim | none |
| 1b | Exercise annotation mapping on one new source document | none |
| 1c | Run Project LTP on a new project and open its model in the local dashboard | none — toy dashboard is verified |
| 1d | Decide the first editable workflow after observing 1c on a real model | evidence from 1c |
| 2a | Gather Jun 6 transcript + old issue-tree diagrams | find the files |
| 2b | Draft clean Mermaid 4-step diagram | none — start now |
| 5b | Run goal-alignment on a real individual's notes repo | need a real notes repo, not the toy example |
| 5c | Run the IO-5 AI-vs-steward comparison on that real pilot | needs 5b done + a steward reviewer with standing over the target tree |
Verification
- Stream 1 — run each skill on the toy input; diff structured output against the gold data in
claim-tree-annotation.md. "Good enough" = tree covers the same major sub-questions; annotation-mapping places each of the 3 fragments on the correct node with a sensible relation. For the dashboard, compile the bundled frontend, run the localhost boundary tests and semantic-throughput generator tests, load all model data from YAML, and browser-check overview, tree selection, progressive disclosures, and responsive layout. Then eyeball on one new doc/project to check the workflow generalises. - Stream 2 — 2b: render Mermaid, confirm it reads cleanly. 2a: draft reviewed by Rufus, then shared with David for a "does this capture it" check.
- Stream 5 — pilot #1 (toy tree) passes on mechanical checks only (schema-valid, all entity IDs resolve, confidence not uniformly high) — see
skills/goal-alignment/VERIFICATION.md. Not yet run: the real pilot (5b) or theIO-5AI-vs-steward comparison (5c); don't treat pilot #1 as evidence the matching works on real data.