Files
firefrost-services/docs/code-bridge/archive/REQ-2026-04-14-task-description-hygiene.md

2.1 KiB

Code Bridge Request: Task Description Hygiene Pass (Task #163)

Date: 2026-04-14
From: Chronicler #89
Priority: Medium
Task: #163


What We Need

16 tasks in the database have empty descriptions. The descriptions exist in archived markdown files at docs/archive/tasks-index-archived-2026-04-11/ in the ops manual — they just never got migrated when tasks moved to PostgreSQL.

The Job

  1. Clone the ops manual on Dev Panel (or read via Gitea API)
  2. Scan docs/archive/tasks-index-archived-2026-04-11/ for all task-*.md files
  3. Parse each file — extract the task_number from frontmatter and the body content as the description
  4. For each task that exists in the database with an empty description, UPDATE it with the content from the markdown file
  5. Report what was backfilled and what's still missing

The 16 Empty Tasks

# Title
22 Netdata Deployment
23 Department Structure & Access Control
32 Terraria Branding Arc
48 n8n Rebuild
49 NotebookLM Integration
51 Ignis Protocol
81 Memorial Writing Assistant
89 DERP Protocol Review
97 Trinity Console Social Hub
99 Multi-Lineage Claude Architecture
100 Skill Index & Recommender System
104 Server-Side Mod Deployment Automation
105 Trinity Console Review Workflow
106 Minecraft Log Analyzer Bot
113 Claude Projects Architecture

Database Access

PGPASSWORD='FireFrost2026!Arbiter' psql -U arbiter -h 127.0.0.1 -d arbiter_db

Archive Location

Ops manual repo: firefrost-operations-manual Path: docs/archive/tasks-index-archived-2026-04-11/ Files follow pattern: task-NNN-slug.md

Approach

Could be a one-off script or done manually task by task. The markdown files have YAML frontmatter with task_number, then a body with overview, steps, etc. The full body (minus frontmatter) is the description. Truncate if needed — the database column is TEXT so length isn't a concern.

For any tasks that DON'T have a matching archived file, flag them so Michael can write descriptions manually.


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