diff --git a/docs/reference/PROJECT-INSTRUCTIONS.md b/docs/reference/PROJECT-INSTRUCTIONS.md index 791e00b..3a235bc 100644 --- a/docs/reference/PROJECT-INSTRUCTIONS.md +++ b/docs/reference/PROJECT-INSTRUCTIONS.md @@ -214,6 +214,44 @@ Michael is building Firefrost Gaming, a sophisticated Minecraft server hosting c - **Dify-Qdrant config**: Must use `QDRANT_URL` in full URL format, not separate host/port variables - **Commit immediately**: All work committed before session ends - this safety net has proven critical +### Task Management System (April 7, 2026) + +**System:** Individual task files in `/docs/tasks-active/` (replaced BLOCKERS.md + BACKLOG.md) + +**Structure:** +- **One file per task** (e.g., `task-026-modpack-version-checker.md`) +- **YAML frontmatter:** task_number, title, priority, status, is_blocker, estimated_hours, tags +- **Body:** Quick summary + links to full spec in `/docs/tasks/[task-name]/` + +**Decap CMS Integration:** +- **Location:** firefrostgaming.com/admin → 🔥 TASKS +- **Features:** Sortable by priority/blocker/status, filterable, mobile-friendly +- **Workflow:** Click task → edit just that task (not entire list) + +**When Creating New Tasks:** +1. Create file in `/docs/tasks-active/task-NNN-slug.md` +2. Fill frontmatter (priority 1-4, status, blocker true/false) +3. Write 2-3 sentence summary in body +4. Link to full spec in `/docs/tasks/[task-name]/README.md` (optional, for complex tasks) +5. Decap CMS auto-commits to Git + +**When Completing Tasks:** +1. Change status to "COMPLETE" in frontmatter +2. Add `completed_date: "YYYY-MM-DD"` +3. Move file to `/docs/tasks-archive/` (or leave in place with COMPLETE status) + +**Priority Levels:** +- **1 = High** (revenue impact, force multipliers) +- **2 = Medium** (important but not urgent) +- **3 = Low** (backlog, do when time allows) +- **4 = Personal** (Trinity member projects) + +**Blocker Flag:** +- Set `is_blocker: true` ONLY if blocks soft launch or major milestone +- Most tasks are NOT blockers + +**See:** `/docs/tasks-active/README.md` for full system documentation + ### If Git Access Fails If you cannot access git.firefrostgaming.com: