platonai Organize Task Files
Manages .full.md (evaluation outputs) and .issues.md (extracted issues) files across the Coworker task state machine pipelines.
When to Use
- "organize task files"
- "show me what tasks are in each pipeline stage"
- "find unpaired .full.md and .issues.md files"
- "find duplicate task files"
- "find empty issues files (zero issues found)"
- "move task files from X to Y"
- "clean up the issues draft directory"
How It Works
- Scans
coworker/tasks/(issues, main) for.mdtask files - Parses filenames with pattern
YYYYMMDD-HHMMSS-taskname.{full,issues}.mdor plaintaskname.md - Groups by task name, detects pairs/dupes/orphans, classifies by pipeline stage
Usage
Run the bundled script:
python3 coworker/skills/organize-task-files/scripts/organize.py COMMAND [OPTIONS]
Commands
| Command | Description |
|---|---|
summary |
Overview of all pipelines: file counts per stage, type breakdown |
list |
List all task files with full paths, grouped by pipeline stage |
pairs |
Match .full.md ↔ .issues.md pairs; flag orphans |
dupes |
Find duplicate task names across directories and stages |
empty |
Find .issues.md files with "0 issues found" |
move |
Move matching files between pipeline stages (dry-run by default) |
Options
| Flag | Description |
|---|---|
--dir DIR |
Only scan a specific directory (default: all task dirs) |
--dry-run |
Show what would happen without making changes (default for move) |
--force |
Actually perform moves (use with move) |
--json |
Output as JSON for scripting |
Examples
# Overview of all pipelines
python3 coworker/skills/organize-task-files/scripts/organize.py summary
# Find unpaired files in issues draft
python3 coworker/skills/organize-task-files/scripts/organize.py pairs --dir issues/draft
# List all duplicate task names
python3 coworker/skills/organize-task-files/scripts/organize.py dupes
# Find empty .issues.md files (zero issues)
python3 coworker/skills/organize-task-files/scripts/organize.py empty
# Preview moving empty issues files to a discard directory
python3 coworker/skills/organize-task-files/scripts/organize.py move --dir issues/draft --filter empty --target coworker/tasks/issues/review/done/discard
# Actually perform the move
python3 coworker/skills/organize-task-files/scripts/organize.py move --dir issues/draft --filter empty --target coworker/tasks/issues/review/done/discard --force
Pipeline Stages (for reference)
0draft → 1ready → 2working → 3done → 4review → 5approved → 6git-pushed
Plus parallel pipelines:
issues/draft/refine/(0ready → 1working → 2done → 0error)issues/github/commit/(ready → done → failed)issues/review/andissues/review/done/issues/local/done/andissues/local/wontfix/