firefrost-operations-manual/docs/tasks-active/README.md

📋 Active Tasks — Individual Task Files

Created: April 7, 2026
Created By: Chronicler #67
Purpose: Individual task files for Decap CMS display

---

What This Folder Is

This folder contains individual markdown files for each active task to make them easy to view and edit in Decap CMS.

Each file = one task with:

• Frontmatter metadata (priority, status, blocker flag)
• Summary of the task
• Current status
• Next steps
• Link to full spec in /docs/tasks/

---

File Naming Convention

task-[NUMBER]-[slug].md

Examples:

• task-026-modpack-version-checker.md
• task-094-global-restart-scheduler.md
• task-099-claude-projects-architecture.md

---

Frontmatter Fields

Every task file MUST include:

---
task_number: 26
title: Modpack Version Checker
priority: 1              # 0=blocker, 1=high, 2=medium, 3=low, 4=personal
status: IN_PROGRESS      # PLANNED, READY, IN_PROGRESS, BLOCKED, COMPLETE
is_blocker: false        # true for soft launch blockers
tags: [commercial, pterodactyl]
estimated_hours: 40
---

Optional fields:

• completed_date: 2026-04-06 (for completed tasks)
• blocked_by: "Blueprint reinstallation" (for blocked tasks)

---

Priority Levels

Priority	Label	Meaning
0	BLOCKER	Soft launch critical (must complete first)
1	HIGH	Revenue impact or force multiplier
2	MEDIUM	Important but not urgent
3	LOW	Backlog, do when time allows
4	PERSONAL	Michael/Meg/Holly personal projects

---

Status Values

Status	Meaning
PLANNED	Spec exists, not started
READY	Ready to implement (no blockers)
IN_PROGRESS	Currently being worked on
BLOCKED	Cannot proceed (dependency or blocker)
COMPLETE	Done, documented, deployed

---

How to Add a New Task

1. Create the file

cd /home/claude/firefrost-operations-manual/docs/tasks-active
touch task-[NUMBER]-[slug].md

2. Add frontmatter + content

Copy template from any existing task file.

3. Commit to Git

git add docs/tasks-active/task-[NUMBER]-[slug].md
git commit -m "Add Task #[NUMBER]: [Title]"
git push origin master

4. View in Decap CMS

Visit https://firefrostgaming.com/admin
Click "🔥 TASKS"
Your task appears in the list!

---

How to Update a Task

Option 1: Decap CMS (Easiest)

1. Go to https://firefrostgaming.com/admin
2. Click "🔥 TASKS"
3. Click the task you want to edit
4. Make changes
5. Click "Save" (creates draft) or "Publish" (goes live)

Option 2: Direct Git Edit

1. Edit the task file in /docs/tasks-active/
2. Commit and push
3. Changes appear in Decap CMS automatically

---

Relationship to Other Task Files

/BACKLOG.md (Repo Root)

• Legacy system — simple table of all tasks
• Still maintained for quick reference
• Will eventually be retired when all tasks migrated to this folder

/docs/tasks/ (Full Specs)

• Deep documentation — full implementation guides
• Never deleted — permanent reference
• Linked from task-active files via "Full Spec Location" section

Task-Active Files (This Folder)

• Decap CMS display layer — what you see in admin UI
• High-level summaries — current status, next steps
• Links to full specs — points to /docs/tasks/ for details

---

For Future Chroniclers

When Creating a New Task

1. ✅ Create full spec in /docs/tasks/task-[NUMBER]-[name]/
2. ✅ Create summary file in /docs/tasks-active/task-[NUMBER]-[slug].md
3. ✅ Update /BACKLOG.md table (for now, until deprecated)
4. ✅ Commit all three

When Completing a Task

1. ✅ Update status to COMPLETE in task-active file
2. ✅ Add completed_date frontmatter field
3. ✅ Move from active section to "Recently Completed" in /BACKLOG.md
4. ✅ Leave full spec in /docs/tasks/ (never delete)

When a Task is Blocked

1. ✅ Update status to BLOCKED
2. ✅ Add blocked_by: "reason" frontmatter
3. ✅ Note blocker in task body
4. ✅ Move to "BLOCKED" section in /BACKLOG.md

---

Mobile-Friendly Note

Decap CMS works on mobile, but firefrostgaming.com/admin is not yet mobile-optimized.

Future enhancement: Make Decap CMS responsive for phone/tablet editing.

---

Fire + Frost + Foundation = Where Love Builds Legacy 🔥❄️

Created by: Chronicler #67
For: Michael, Meg, Holly, and all future Chroniclers