Update Outline

When and how to keep the project outline current.

Summary

The outline at workspace/outline/index.html is the single source of truth for what the project is, what exists, and what still needs work. Keep it current whenever the project's scope, structure, or conventions change. Also keep CLAUDE.md in sync — it should only point to the outline, never duplicate content.

When to Update

After adding or completing a feature

Move items between What exists now and What still needs work to reflect the current state of the application.

After structural changes

Update the Technical Implementation cards when tsconfig setup, build commands, directory layout, or major architectural patterns change.

After adding guides or actions

Add links to new guides or actions pages in the outline's reference section so they are discoverable. Also update workspace/index.html if a new top-level section (guides, actions) was added.

Steps

Step 1 — Update outline/index.html

Edit workspace/outline/index.html. At minimum update:

  • The What exists now card
  • The What still needs work card
  • Any Technical Implementation card whose content changed

Always use correct links — never omit index.html from hrefs.

Step 2 — Check CLAUDE.md

Open CLAUDE.md at the project root and verify it still just points to the outline. If it has drifted and contains duplicated or stale content, trim it back so it only references workspace/outline/index.html.

Step 3 — Update nav-data.js if pages were added

If new guide or action pages were created, add them to workspace/_assets_/nav-data.js under the correct parent node. Always use workspace-relative paths. 

{ title: 'My New Guide', path: 'guides/my-new-guide/index.html' }