datarim-doctor

What problem does it solve?

Datarim operational files can drift over time—breaking the expected thin-index formats, losing canonical task descriptions, or accumulating deprecated sections like progress logs and archive blocks. This Skill provides a rigorous, data-loss-safe self-heal that validates the repository layout and migrates it back to the canonical schema.

Core Features & Use Cases

• Schema conformance and validation: Enforces the canonical one-liner index formats for tasks and backlog entries, plus strict contracts for active context mirroring.
• 6-pass, idempotent migration: Converts legacy block-style task descriptions into per-task description files, rewrites operational indexes, retires deprecated files/sections, and migrates archive history into documentation.
• Conflict handling with safety guarantees: Resolves archive-file conflicts under a configurable policy and ensures atomicity with pre-write backups and restore-on-error.
• Use Case: Fix a repository that has accumulated manual edits to tasks.md/backlog.md/activeContext.md, including legacy headings and archive sections, so that commands like /dr-archive and /dr-status work reliably again.

Quick Start

Run datarim-doctor in fix mode to validate and migrate the Datarim repository back to the canonical schema.