From fd585ca3e0da2b6b4c9a5289952fb6be332ba7ce Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 7 Apr 2026 21:57:51 +0000 Subject: [PATCH] Document tasks-active system in Project Instructions Added comprehensive task management section explaining: - Individual task files in /docs/tasks-active/ (replaces BLOCKERS.md + BACKLOG.md) - YAML frontmatter structure (task_number, priority, status, blocker flag) - Decap CMS integration at firefrostgaming.com/admin - Workflow for creating/completing tasks - Priority levels (1-4) and blocker criteria For future Chroniclers: This is the NEW task tracking system as of April 7, 2026. All task operations should use /docs/tasks-active/ files, not the old BACKLOG.md. --- docs/reference/PROJECT-INSTRUCTIONS.md | 38 ++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) 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: