unified-taskflow

Manages complex multi-phase tasks with anchors, checkpoints, and acceptance tracking.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill unified-taskflow-ooooooooooooooooooop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unified-taskflow
Source: https://github.com/ooooooooooooooooooop/personal-ai/tree/main/skills/unified-taskflow
Command: npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill unified-taskflow-ooooooooooooooooooop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Long, multi-phase tasks often lose alignment as context grows: goals drift, assumptions go unrecorded, and progress becomes unrecoverable across sessions. This Skill provides a heavyweight task management system that anchors intent, tracks checkpoints, and enforces acceptance criteria for genuinely complex work. ## Core Features & Use Cases - Grounding Anchor (anchor.md): Captures intent, critical constraints, scope, Done-when criteria, and assumptions with versioning, serving as the single source of truth against hallucination and drift. - Event-Driven Checkpoints with Re-grounding: Updates checkpoint.md on key events (file changes, subtask completion, new instructions) with item-by-item verification against the anchor, plus rolling compression of old records. - Lifecycle Scripts: Python scripts (task-lifecycle.py, session-catchup.py) create, suspend, resume, validate, archive, and summarize tasks in a .taskflow/ directory with schema validation and atomic writes. - 3-Strike DEADBAND Protocol: After three failures on the same problem, resets strategy to a materially different recovery route instead of silently retrying or prematurely escalating. - Use Case: When refactoring a 2000-line legacy module across multiple sessions, use this Skill to record the intent and constraints once, checkpoint progress after each extracted submodule, and resume cleanly in a new session without re-explaining the task. ## Quick Start Ask the agent to use unified-taskflow to manage your complex multi-phase task, and it will create an anchor and checkpoint files under .taskflow/ to track the work.

Frequently Asked Questions about unified-taskflow

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

FAQPage Schema
How do I manage a complex multi-phase task with an AI agent?

Use unified-taskflow to create a .taskflow directory containing an anchor.md with intent, constraints, and Done-when criteria, plus a checkpoint.md updated on key events. Run 'python scripts/task-lifecycle.py new <task-name>' to initialize the structure.

How to resume an AI agent task after a session ends?

Run 'python scripts/session-catchup.py' in the project directory to recover context from the previous session. It reads the active task's anchor.md and checkpoint.md, then suggests next steps including validation and re-grounding.

When should I not use unified-taskflow?

Do not use it for simple Q&A, single-file edits, small bug fixes, or routine refactoring. Tasks that task-mode-router or minimal-implementation can handle should not create a .taskflow directory; it is reserved for large, auditable, multi-stage work.

What happens when a task fails three times in a row?

The 3-Strike Protocol triggers DEADBAND: the current path assumption is discarded, re-grounding runs against the anchor, and a materially different recovery route is chosen. It does not automatically stop and escalate to the user unless legitimate stop conditions are met.

Does unified-taskflow support suspending and resuming tasks?

Yes. The lifecycle script supports suspend and resume commands, allowing one active plus one suspended task at a time. Suspended tasks stay in the active directory with their status marked in index.json, and resume restores them to active status.