taskmanager

The taskmanager skill is a structured task and state management system built around a SQLite database that serves as the single source of truth for all project tasks, milestones, analyses, and memories. It is designed to transform product requirements (PRDs) into a clear, hierarchical task tree with explicit dependencies and manageable complexity. Instead of relying on informal planning or scattered notes, it enforces a disciplined, database-driven workflow where every task, state change, and memory is tracked and persisted. This ensures consistency, traceability, and integrity across planning and execution phases.

The skill provides strict level-by-level task expansion. When given PRD content—either from a markdown file or a direct prompt—it first generates top-level tasks (conceptual epics mapped to valid database types such as feature, chore, analysis, or spike). It then recursively expands each task only as needed, ensuring that every task becomes clear, meaningful, and actionable without over-fragmentation. It enforces controlled field values (such as status, priority, complexity_scale, and moscow) through database constraints, preserving hierarchical relationships via parent_id. It also integrates structured memory handling, requiring relevant active memories—especially those with higher importance—to be considered before major planning or refactoring decisions.

Typical use cases include structured feature planning, refactoring initiatives, cross-cutting architectural changes, and long-running product development efforts that require reliable task lineage and state tracking. The primary users are developers, technical leads, and AI-driven agents who need disciplined task orchestration tied directly to a persistent database. It is especially suited for projects that demand reproducibility, auditability, and incremental, complexity-aware task breakdown.