From qe-framework
Migrates TASK_REQUEST/VERIFY_CHECKLIST files from project root into .qe/tasks/ and .qe/checklists/ directories and updates CLAUDE.md conventions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/qe-framework:Mmigrate-tasksThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Migrates existing `TASK_REQUEST_*.md` and `VERIFY_CHECKLIST_*.md` files in the project root into the `.qe/tasks/` and `.qe/checklists/` directory structure, and updates `CLAUDE.md` to match the latest conventions.
Migrates existing TASK_REQUEST_*.md and VERIFY_CHECKLIST_*.md files in the project root into the .qe/tasks/ and .qe/checklists/ directory structure, and updates CLAUDE.md to match the latest conventions.
project-root/
├── CLAUDE.md
└── .qe/
├── tasks/
│ ├── pending/ ← 🔲 Not yet started
│ ├── in-progress/ ← 🔶 In progress
│ ├── completed/ ← ✅ Done
│ └── on-hold/ ← ⏸️ On hold
└── checklists/
├── pending/
├── in-progress/
├── completed/
└── on-hold/
TASK_REQUEST_*.md and VERIFY_CHECKLIST_*.md files.qe/tasks/ or .qe/checklists/CLAUDE.md to determine task status for each UUIDIf no files need migration:
No files to migrate in the project root.
All files are already in the .claude/ directory structure, or no TASK_REQUEST/VERIFY_CHECKLIST files exist.
→ Proceed directly to Step 2 (CLAUDE.md update check)
Read the status of each UUID from the task list table in CLAUDE.md to determine the target directory.
| CLAUDE.md Status | Target Directory |
|---|---|
| 🔲 (or no status) | pending/ |
| 🔶 | in-progress/ |
| ✅ | completed/ |
| ⏸️ | on-hold/ |
CLAUDE.md is missing or the UUID's status cannot be found, default to pending/VERIFY_CHECKLIST are checked (- [x]), classify as completed/ regardless of statusShow the migration plan to the user and obtain approval.
Preview Format:
## Migration Plan
**Target Files: N**
| File | Current Location | Destination | Status |
|------|-----------------|-------------|--------|
| TASK_REQUEST_a1b2c3d4.md | root | .qe/tasks/pending/ | 🔲 |
| VERIFY_CHECKLIST_a1b2c3d4.md | root | .qe/checklists/pending/ | 🔲 |
| TASK_REQUEST_e5f6g7h8.md | root | .qe/tasks/completed/ | ✅ |
| VERIFY_CHECKLIST_e5f6g7h8.md | root | .qe/checklists/completed/ | ✅ |
**CLAUDE.md Update:** Updates the file rules section to the latest convention.
Proceed?
Do not continue until user approval is received.
mkdir -p .qe/tasks/{pending,in-progress,completed,on-hold}, etc.)mv)Check whether the "File Rules" section in CLAUDE.md is in the old format, and replace it with the latest convention.
Old Format Indicators:
### File Name Rules section lists TASK_REQUEST_{UUID}.md without a directory pathDirectory columnReplacement Target: From ## File Rules up to (but not including) the next ## section
New Format:
## File Rules
### Directory Structure
\```
project-root/
├── CLAUDE.md
└── .qe/
├── tasks/
│ ├── pending/ ← Immediately after creation (not yet started)
│ ├── in-progress/ ← Work in progress
│ ├── completed/ ← Work complete
│ └── on-hold/ ← Work on hold
└── checklists/
├── pending/
├── in-progress/
├── completed/
└── on-hold/
\```
### File Name Rules
- Task request: `.qe/tasks/{status}/TASK_REQUEST_{UUID}.md`
- Verification checklist: `.qe/checklists/{status}/VERIFY_CHECKLIST_{UUID}.md`
- One task shares the same UUID across both files.
- `{status}` is one of: `pending`, `in-progress`, `completed`, `on-hold`.
### Task Status
| Status | Directory | Meaning |
|--------|-----------|---------|
| 🔲 Not started | `pending/` | Work not yet begun |
| 🔶 In progress | `in-progress/` | Currently being worked on |
| ⏸️ On hold | `on-hold/` | Temporarily paused |
| ✅ Complete | `completed/` | All VERIFY_CHECKLIST items checked. **No further reference needed.** |
### Completion Criteria
- ✅ Complete when **all checkboxes in VERIFY_CHECKLIST are checked**
- Completed files are moved to the `completed/` directory
- Completed task files **do not need to be referenced again.**
Note:
## Task List table or other sections (to prevent data loss)## ✅ Migration Complete
**Files Moved:** N
- tasks: A (pending: X, in-progress: Y, completed: Z, on-hold: W)
- checklists: B
**CLAUDE.md Updated:** File rules section updated (or "Already up to date")
**Note:** Completed (✅) task files are stored in .qe/tasks/completed/ and do not need to be referenced again.
pending//Qgenerate-specCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub inho-team/qe-framework --plugin qe-framework