task-flow-archive

Archives completed task folders, audits the work queue, and routes rules-review findings.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill task-flow-archive-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-flow-archive
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/task-flow-archive
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill task-flow-archive-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a task branch is finished, teams often leave stale task folders on disk, lose the owner's original decisions, and let post-merge review findings fall through the cracks. This Skill defines the exact closing procedure: how to take a task folder apart before the PR opens, how to audit the work queue, and where background rules-review findings must land so nothing is lost. ## Core Features & Use Cases - Task folder teardown: Splits a finished task folder into three outcomes — standing requirements promoted to the rules layer, the decision story moved to docs/archive/, and the rest deleted — executed as the last commit before the PR opens. - Work queue audit: Runs npm run check:board, npm run check:specs, and npm run check:docs to catch closed-task folders, abandoned drafts, and broken doc paths in the same turn. - Background rules review: Launches a closed-task review role right after the PR opens, gathers the digest first, and writes returned findings into a <plan name>-findings.md file next to the epic plan. - Use Case: After merging a feature branch, an agent archives grill.md to docs/archive/, deletes the task folder, runs the three audits, opens the PR as a draft, and launches the rules review in the background while starting the next task. ## Quick Start Take apart the finished task folder, run the work queue audits, and open the PR following the task-flow-archive pattern.

Frequently Asked Questions about task-flow-archive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive a completed task folder before opening a PR?

Take the folder apart as the last commit of the branch: move standing requirements to the rules layer, copy grill.md into docs/archive with a telling name, delete the rest, then run the audits and open the PR. The delivery guard refuses PRs opened with the folder still in place.

What files should be kept when closing a task folder?

Keep grill.md in docs/archive because it holds the owner's unrecoverable answers, and keep progress.md only if it records decisions with reasons. Delete plan.md since the code and domain spec answer its questions after rollout.

Where do rules-review findings go after a task is merged?

Findings are written into a file named <plan name>-findings.md next to the epic plan, not into the task folder, because the review runs in the background and the folder may already be gone. Work outside an epic shows findings to the owner in the same turn.

When should the rules review of closed work be launched?

Launch it in the background immediately after the PR opens, with the digest gathered beforehand while the task is fresh. The turn continues with the next task rather than waiting, and returned findings are accepted in a single turn.

What happens if a task folder is deleted without archiving?

Deleting without archiving loses grill.md first, which is the only record of why the owner set the task that way. The delivery guard requires the branch to add an archive record, preventing silent deletion.

How are findings files split when they grow too long?

Check the file length before appending; if it exceeds the limit, start a new part named <plan name>-findings-<KEY>-<number>.md after the task that started it. Ordinal names clash when multiple working trees lead one epic.