Commit graph

1 commit

Author SHA1 Message Date
Nexus Dev
14dd8dbfa5 docs(nexus): add codebase map and project status orientation docs
Two orientation files for future sessions that may not have the full
conversation history loaded.

CODEBASE-MAP.md — factual scan of the tree:
  1. ui/src/ directory tree with one-line descriptions
  2. Full App.tsx route map with ACTIVE / LEGACY / REDIRECT /
     PLACEHOLDER status per route
  3. Component inventory for frame/, assistant/, studio/, projects/,
     settings/ with phase attribution and file status
  4. Context + hook map (13 contexts, 39 hooks)
  5. API surface (34 files in src/api/)
  6. CSS token map for dark and light modes with direct brand refs
  7. Known issues — grep for TODO/FIXME/PHASE 11 DATA GAP/placeholder
  8. Migration status verified against git log

PROJECT-STATUS.md — narrative status:
  1. Current milestone (v1.7 Content Generation + parallel overhaul)
  2. Design system phases 1-7 status (1-3 DONE, 4-7 PENDING)
  3. Layout overhaul phases 8-16 status (8-15 DONE, 16a mid-flight,
     16b pending)
  4. Known placeholders — Phase 11 TabPlaceholders and Wave 2.5
     TODO(phase-11.5) proxies in Projects.tsx
  5. Blocked work — phase 11.5 per-project scoping tickets,
     ChatMessageList migration hazard
  6. Dead code inventory with ALIVE/DELETED markers
  7. Route status — active, redirect, legacy pending deletion
  8. Pending decisions from migration plan and layout spec
  9. Ordered next actions — wait for 16a, review, dispatch 16b,
     full test sweep

Both docs reference git commits and file paths so a fresh session
can cross-check against the actual tree without replaying the wave
history.

NOTE: This commit was originally attempted earlier and got tangled
with Phase 16a's staged deletions in a shared-working-tree race.
Phase 16a's subagent detected the mixed commit and reset it cleanly.
This is the re-commit using git commit -o <specific paths> to
scope strictly to the doc files, avoiding any in-flight phase 16a
work. See memory feedback_parallel_dispatch_shared_files for the
pattern.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 15:57:01 +00:00