← Project Log
Decision

DEC-0010: Documentation Consolidation

Date: 2026-03-22 Decision by: Human + Cursor Status: Active

Context

The docs/ directory had accumulated 34 files with no organization — canonical design documents mixed with one-time delegation prompts, superseded proposals, ephemeral task lists, and temporary working files from Perplexity's agent-workspace. The agent-workspace/ directory contained both valuable design docs and throwaway handoffs.

Decision

Reorganize docs/ into a clear structure:

Structure

docs/
├── README.md                    # Index with categorized links
├── _archive/                    # Superseded and ephemeral files
│   └── README.md                # Why each file was archived
├── series/                      # All series and track architecture plans
│   ├── series-*.md
│   ├── track-*.md
│   ├── eastern-traditions-series.md
│   ├── western-canon-series.md
│   ├── capstone-episode.md
│   └── new-episodes-eros-body.md
├── editorial-guidance.md        # Governing editorial document
├── editorial-assessment-march-2026.md
├── design-vocabulary.md         # Visual identity system
├── imagery-corpus-strategy.md   # Imagery architecture
├── imagery-population-plan.md   # Imagery execution plan
├── imagery-targets-by-episode.md # Per-episode imagery targets (promoted from agent-workspace)
├── repo-architecture.md         # Repository and KB design
├── infrastructure.md            # Services and deployment
├── production-pipeline.md       # Episode production pipeline v2 (promoted from agent-workspace)
├── ai-optimization.md           # AI access layer (promoted from agent-workspace)
├── corpus-digitization-plan.md  # RAG corpus plan
├── episode-experience-spec.md   # Episode experience spec
├── implementation-spec-ai-tools.md # AI tools spec
├── strategy.md                  # Strategic blueprint
└── backlog.md                   # Prioritized backlog

Actions Taken

  • Archived 8 files from docs/: wave2 prompts (3), editorial-positions (superseded), apophatic-interface spec (superseded), portrait-acquisition-list (completed), S7-S8 proposal (superseded), weekend-scanning-list (date-bound)
  • Archived 7 files from agent-workspace/: S1E1 handoffs (2), agent-prompts, ai-surface-brainstorm, external-llm-prompts, imagery-pipeline-postmortem, ux-refresh-plan
  • Promoted 3 files from agent-workspace/ to docs/: production-pipeline-v2 → production-pipeline.md, ai-optimization.md, wave2-episode-imagery-analysis → imagery-targets-by-episode.md
  • Moved 14 series/track plans to docs/series/
  • Created README indexes for docs/, docs/_archive/, and agent-workspace/_archive/

Principle

Canonical design documents live in docs/. Ephemeral working files live in agent-workspace/ until they prove durable enough to promote. One-time prompts and superseded docs go to _archive/ with a documented reason.

0:00
0:00