task-bundle

Manages Task Bundle artifacts with plan, state, and review files under docs/tasks.

6|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Jerrylalala/compound-engineering --skill task-bundle-jerrylalala
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: task-bundle
Source: https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills-custom/task-bundle
Command: npx skills add https://github.com/Jerrylalala/compound-engineering --skill task-bundle-jerrylalala

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose track of task context when plans, execution state, and review findings live in scattered notes. This Skill standardizes every task as a Task Bundle — a directory under docs/tasks/ containing plan.md, state.md, and review.md — so goals, progress, and conclusions stay consistent and auditable. ## Core Features & Use Cases - Standardized Task Structure: Each task gets a task-id (YYYY-MM-DD-<seq>-<kebab-description>) and three files: plan.md for goals and acceptance criteria, state.md for current step and blockers, and review.md for findings and conclusions. - State Transition Rules: Every status change updates the state.md frontmatter, appends a row to the state history table, and refreshes the last_checkpoint timestamp, following the Failure FSM protocol. - Template-Based Creation: Copy plan.md.tpl, state.md.tpl, and review.md.tpl from the templates directory and replace placeholders to bootstrap a new bundle. - Use Case: After running /workflows:plan, create a Task Bundle for the new feature, link the plan file, update state.md during /workflows:work, and fill review.md after /workflows:review. ## Quick Start Create a new Task Bundle for the login-refactor task by generating a task-id, copying the three templates into docs/tasks/, and filling in the plan frontmatter.

Frequently Asked Questions about task-bundle

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

FAQPage Schema
How do I create a Task Bundle for a new task?▼

Generate a task-id in the format YYYY-MM-DD-<seq>-<kebab-description>, create a directory under docs/tasks/ with that id, copy the three templates (plan.md.tpl, state.md.tpl, review.md.tpl), and fill in the frontmatter fields task_id, created_at, and owner.

What files does a Task Bundle contain?▼

A Task Bundle contains three markdown files: plan.md for goals, constraints, and acceptance criteria written at creation; state.md for current step, blockers, and state history updated during execution; and review.md for findings, evidence, and conclusions written during review.

How do I record a task status change in state.md?▼

Update the status field in the state.md frontmatter, append a row to the state history table with time, from-state, to-state, reason, and operator, and refresh the last_checkpoint timestamp. Transitions follow the Failure FSM protocol in docs/specs/failure-fsm.md.

Does Task Bundle integrate automatically with ce:work or ce:review?▼

Not in the current Phase 0. Task Bundle is a standalone documentation protocol; you manually create bundles after planning and update state.md during work. Automatic integration requires the ce-work-integration overlay, with native integration planned for Phase 2.

When should I use Task Bundle instead of a simple todo list?▼

Use Task Bundle when tasks span multiple phases (plan, work, review) and need auditable state history, acceptance criteria, and review evidence. Simple one-step fixes or quick bug patches do not need the full three-file structure.