Quinn Ftw 95c5fb479f Initial project management structure

- README.md: Project overview and navigation
- STATUS.md: Current phase and metrics
- HANDOFF.md: AI agent session continuity
- plan/README.md: Planning system documentation
- plan/ROADMAP.md: Phase milestones
- plan/PRIORITIES.md: Priority stack (status → admin → landing)

Directory structure:
- plan/streams/: Active work (max 5-7)
- plan/backlog/: Prioritized future work
- archive/: Completed and cancelled work
- history/: Session logs
- reference/: Migrated docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-25 14:09:00 -08:00

2.2 KiB

Raw Permalink Blame History

Planning System

How the Lilith Platform planning system works.

Overview

plan/
├── README.md       # This file
├── ROADMAP.md      # High-level milestones
├── PRIORITIES.md   # Current priority stack
├── streams/        # ACTIVE work (max 5-7)
└── backlog/        # Future work (not started)

Streams (Active Work)

Active work items with dedicated tracking.

Location: streams/

Structure:

stream-NNNN-short-description/
├── README.md      # What this stream accomplishes
├── STATUS.md      # Current progress, phase, blockers
└── HANDOFF.md     # For multi-session streams (optional)

Rules:

Maximum 5-7 active streams at any time
Every stream MUST have STATUS.md
Archive immediately when complete

Backlog (Future Work)

Prioritized list of future work items.

Location: backlog/

Format: Simple markdown files (not directories)

NNNN-short-description.md

Rules:

Files, not directories (low overhead until work starts)
Ordered by priority (lower number = higher priority)
Promote to stream when starting work

Stream Numbering

Format: stream-NNNN-kebab-case-description
Example: stream-0001-admin-dashboard
         stream-0002-landing-page

Rules:
- 4-digit, zero-padded (0001, 0002, ...)
- Sequential, no gaps
- Never reuse numbers (even after archive)
- Description max 40 characters

Workflow

Starting New Work

Check active streams (max 5-7)
If room: create stream-NNNN-description/
Add README.md and STATUS.md
Update PRIORITIES.md

Completing Work

Update STATUS.md with final state
Move directory to archive/completed/
Update PRIORITIES.md

Pausing Work

Update STATUS.md with current state
Add HANDOFF.md for context
Stream stays in streams/

Anti-Clutter Rules

Lessons learned from egirl-platform:

Rule	Why
Max 5-7 active	Prevents cognitive overload
Sequential numbers	Prevents duplicates (0113 issue)
Backlog = files	Less overhead for unstarted work
Immediate archive	Keeps active area clean
STATUS.md required	Always know current state

2.2 KiB Raw Permalink Blame History