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:
bashpython3 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
bash# 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/


