Skip to content

ROADMAP.md

Latest commit

 

History

History
185 lines (118 loc) · 5.84 KB

ROADMAP.md

File metadata and controls

185 lines (118 loc) · 5.84 KB
Raw

ROADMAP.md

1. Project Center of Gravity

Core Purpose:
code --install-extension CardSorting.lumi-vscode

Primary Users / Operators:
Thank you for contributing to LUMI (CardSorting.lumi) — the calm coding companion VS Code extension in the LUMI monorepo.

Canonical Architecture:
Thank you for contributing to LUMI (CardSorting.lumi) — the calm coding companion VS Code extension in the LUMI monorepo.

Canonical Workflows:
Preserve flows — verify with Playwright; CI: GitHub Actions.

Primary Runtime / Operational Center:
Workspace project root — ROADMAP.md lives beside source, not in plugin install trees.

What This Project Must Not Become:
Uncontrolled scope changes to LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions without a documented center of gravity.

2. Roadmap Health

Status: Coherent

Phase: checkpoint

Summary:
Bootstrap steering surface for LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions.

Why This Status:

  • ROADMAP.md created from gathered evidence
  • Schema established for long-horizon steering

Primary Risk:
Limited cross-session steering until Now/Next items connect to center of gravity.

Primary Opportunity:
Document LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions center of gravity before expanding scope.

3. Strategic Narrative

code --install-extension CardSorting.lumi-vscode

4. Now

1. Complete ROADMAP bootstrap fill

Goal:
Replace remaining template phrases with project-specific facts for LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions.

Evidence:
bootstrap_fill_plan + project_fingerprint

Center-of-Gravity Impact:
Strengthens

2. What changed ChatToolbar is now a simple bar (no
dropdown). Toolbar icons handle all navig

Goal:
Verify or continue work tied to recent commit: 3bc4381 What changed ChatToolbar is now a simple bar (no

Details dropdown). Toolbar icons handle all navigation direct.

Evidence:
git.recent_commits

Center-of-Gravity Impact:
Neutral

3. Fixed the blocking diagnostics from your paste:

Goal:
Verify or continue work tied to recent commit: 5756775 Fixed the blocking diagnostics from your paste:.

Evidence:
git.recent_commits

Center-of-Gravity Impact:
Neutral

5. Next

6. Later

7. Discovery

8. Maintenance Gravity

Hotspots

Area Symptom Risk Recommended Action
Low

Repeated Friction

Documentation Gaps

Agent Confusion Points

9. Centralization & Code Soup Audit

Overall Code Soup Risk: Medium

Canonical Path Integrity

Assessment:
Code soup risk: Low — see code_soup_pre_audit.

Authority Boundaries

Assessment:
Runtime authority in repo manifests; ROADMAP.md stays in project workspace only.

Structural Drift

Assessment:
Recent changes from git evidence:

  • .github/workflows/publish.yml
  • README.md
  • docs/MAINTAINER.md
  • docs/docs.json
  • docs/papers/companion-brief.md
  • docs/troubleshooting/extension-wont-start.mdx
  • package-lock.json
  • package.json

Agent Coherence

Assessment:
Recent commits: 3bc4381 What changed ChatToolbar is now a simple bar (no

dropdown). Toolbar icons handle all navigation directly: Past chats Connected tools Account Preferences New chat stays on the left; title in the center toggles task details when a conversation is active. No more text list or overflow panel — just the icon row in the header. Reload the webview to see it.; 5756775 Fixed the blocking diagnostics from your paste:; f9ce89b readme

Centralization Recommendation

Converge duplicate modules (mcp.ts) or document which path is canonical.

10. Decision Log

2026-06-19 — Initial roadmap bootstrap

Decision:
Adopt ROADMAP.md at workspace root as the steering surface for LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions.

Reason:
Adopt ROADMAP.md as the long-horizon steering surface for LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions.

Impact:
Route LUMI — code --install-extension CardSorting.lumi-vscode — Playwright · GitHub Actions strategic work through Now/Next/Later — max 5 Now items.

Follow-up:
Run roadmap checkpoints after meaningful direction changes.

11. Recent Checkpoint

Date: 2026-06-30

Checkpoint Summary:
Threading the completion spine thesis through 6 existing docs so it's legible at every reading level. Updated philosophy, whitepaper, companion-brief, architecture/current, decision-engine, and migration docs with the four-stage spine (snapshot → decision → action contract → action guard), the before/after failure chain, and the thesis: "The agent receives a command, not a prose explanation to interpret."

Moved:

  • None

Added:

  • "The spine" section to docs/completion-lifecycle-decision-engine.md
  • Spine thesis to docs/papers/philosophy.md § VI
  • Four-stage table + before/after chain to docs/papers/whitepaper.md § 7.3
  • Completion spine callout to docs/papers/companion-brief.md
  • Updated safety pipeline diagram in docs/architecture/current.md
  • Spine summary at top of docs/completion-gate-lifecycle-migration.md

Updated:

  • ROADMAP.md checkpoint date 2026-06-19 → 2026-06-30

Archived:

  • None

Code Soup Risk: Medium
Code soup risk Low from pre-audit.

Recommended Next Move:
Continue refining documentation for clarity. Consider updating docs/parent-thread-execution-authority.md to reference the completion spine in the cold-path gate description.

12. Archive