Files
firefrost-operations-manual/docs/tasks-active/README.md
Claude 3dbbc069f7 Create tasks-active system for individual task management in Decap CMS
- New folder: docs/tasks-active/ with individual task files
- Each task = separate markdown file with frontmatter metadata
- Migrated 6 key tasks (26, 87, 93, 94, 98, 99) as examples
- Added comprehensive README with workflow documentation

Task Files Created:
- task-026-modpack-version-checker.md (P1, IN_PROGRESS)
- task-087-arbiter-lifecycle-handlers.md (P0, COMPLETE, BLOCKER)
- task-093-trinity-codex.md (P1, PLANNED)
- task-094-global-restart-scheduler.md (P1, PLANNED)
- task-098-discord-channel-automation.md (P2, PLANNED)
- task-099-claude-projects-architecture.md (P1, READY)

Benefits:
- Decap CMS shows individual tasks instead of two giant files
- Sortable by priority (blockers first)
- Filterable by status, blocker flag, priority
- Mobile-friendly individual entries
- Links to full specs in /docs/tasks/
- Easy to add/edit/complete tasks via UI

For Future Chroniclers:
- README documents full workflow
- Template structure established
- Integration with existing /docs/tasks/ specs
2026-04-07 21:54:43 +00:00

184 lines
4.4 KiB
Markdown

# 📋 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:
```yaml
---
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
```bash
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
```bash
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