From claude-impl-tools
Consolidates scattered legacy task files (docs/planning/06-tasks.md, task.md, etc.) into root TASKS.md with deduplication, Task ID extraction, and user confirmation.
npx claudepluginhub insightflo/claude-impl-tools --plugin claude-impl-toolsThis skill uses the workspace's default tool permissions.
Scans legacy task files (docs/planning/06-tasks.md, task.md, etc.) and consolidates them into the root `TASKS.md`.
Migrates single-file Markdown tasks to v3.0.0 folder structure with phased subfiles (task.md, research.md, etc.), parses content by headers, creates .bak backups. Auto or manual.
Archives completed tasks from TASKS.md to dated archive files when many [x] items clutter the view. Includes dry-run preview and verification checks.
Defines conventions for TASKS.md files: structure with optional sections, status symbols ([ ] todo, [/] ongoing, [x] done, [-] backlog), task descriptions, and testable acceptance criteria. Use for creating, editing, updating tasks or tracking progress.
Share bugs, ideas, or general feedback.
Scans legacy task files (docs/planning/06-tasks.md, task.md, etc.) and consolidates them into the root TASKS.md.
TASKS.md (with deduplication)┌─────────────────────────────────────────────────────────────┐
│ 1. Detection Phase │
├─────────────────────────────────────────────────────────────┤
│ • Check whether TASKS.md exists │
│ • Scan for legacy files (in priority order) │
│ • Count discovered checkbox items │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 2. Analysis Phase │
├─────────────────────────────────────────────────────────────┤
│ • Extract Task IDs (P*-T*, T*.*) │
│ • Classify by layer (T0–T3, P*) │
│ • Detect duplicates │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 3. User Confirmation │
├─────────────────────────────────────────────────────────────┤
│ • Output migration summary │
│ • User chooses: create / merge / cancel │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 4. Output Phase │
├─────────────────────────────────────────────────────────────┤
│ • Create or merge TASKS.md │
│ • Append Migration Report section │
└─────────────────────────────────────────────────────────────┘
Check for task files in the following priority order:
# Priority order
ls -la TASKS.md 2>/dev/null
ls -la docs/planning/06-tasks.md 2>/dev/null
ls -la docs/planning/tasks.md 2>/dev/null
ls -la docs/tasks.md 2>/dev/null
ls -la planning/tasks.md 2>/dev/null
ls -la .tasks.md 2>/dev/null
ls -la task.md 2>/dev/null
Fallback: If none of the above are found, search using the *tasks*.md pattern.
Extract checkbox items from discovered files:
Extracted targets:
- [ ] Incomplete task
- [x] Completed task
- [/] In progress (optional: normalize to - [ ] (in progress))
Task ID patterns:
P\d+(?:-[A-Z]\d+)?(?:-T\d+)? # P1-T1, P2-S1-T3
T\d+(?:\.\d+)+ # T0.1, T1.12, T3.4
Classification criteria:
| ID Pattern | Layer | Section |
|---|---|---|
T0.* | Skeleton | ## T0 — Skeleton |
T1.* | Muscles | ## T1 — Muscles |
T2.* | Muscles Advanced | ## T2 — Muscles (advanced) |
T3.* | Skin | ## T3 — Skin |
P*-* | Phase-based | ## P* — Project/Phase tasks |
| (no ID) | Uncategorized | ## Uncategorized |
Output the migration summary and ask the user to confirm:
## Migration Summary
### Discovered Files
| File | Tasks | Checked | Unchecked |
|------|-------|---------|-----------|
| docs/planning/06-tasks.md | 25 | 20 | 5 |
| task.md | 3 | 1 | 2 |
### ID Distribution
- T0.* (Skeleton): 5
- T1.* (Muscles): 12
- T2.* (Advanced): 3
- T3.* (Skin): 5
- P*-T* (Phase): 3
- No ID: 0
### Expected Result
- TASKS.md create/merge: 28 items
- Duplicates removed: 2
Confirm via AskUserQuestion:
TASKS.md structure:
# TASKS.md
> Canonical task file for this project.
> Migrated: {date}
## T0 — Skeleton
- [ ] T0.1: Project structure setup
- [x] T0.2: Routing configuration
## T1 — Muscles
- [ ] T1.1: Authentication feature implementation
- [ ] T1.2: API integration
## T2 — Muscles (advanced)
- [ ] T2.1: Caching layer
- [ ] T2.2: Error handling
## T3 — Skin
- [ ] T3.1: Apply animations
- [ ] T3.2: Responsive design
## P* — Project/Phase tasks
- [x] P1-T1: Design document complete
- [ ] P2-T1: Hook implementation
---
## Migration Report
| Source | Imported | Duplicates Skipped |
|--------|----------|-------------------|
| docs/planning/06-tasks.md | 25 | 2 |
| task.md | 3 | 0 |
**Total**: 28 tasks imported
**Date**: 2026-03-03
--dry-run to preview without making changes/tasks-migrate
# or
"Migrate 06-tasks.md to TASKS.md"
"Consolidate legacy task files"
/workflow-guide — Diagnose whether migration is needed/agile — Run a sprint after migration/recover — Reference when recovering task files