mde-task-lifecycle

Orchestrates plan, research, implement, test, and ship phases for repository tasks.

1|Updated Sep 15, 2026
One-click install
npx skills add https://github.com/amoai-tech/mdeai --skill mde-task-lifecycle-amoai-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mde-task-lifecycle
Source: https://github.com/amoai-tech/mdeai/tree/main/.claude/skills/mde-task-lifecycle
Command: npx skills add https://github.com/amoai-tech/mdeai --skill mde-task-lifecycle-amoai-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Moving a task from a written spec to shipped code involves many handoffs — planning, research, coding, testing, and bookkeeping — that are easy to do inconsistently or skip entirely. This Skill enforces a single five-phase lifecycle with explicit gates so every task either ships completely or fails closed, with no half-done artifacts left in the repository. ## Core Features & Use Cases - Five-phase orchestration: Routes work through planning, research, implementation, testing, and shipping modules, delegating each phase to specialist skills like mde-writing-plans, mdeai-executor, testing, and /deploy-check. - Phase gating and loop-backs: Defines skip rules per phase, blocks shipping until tests pass, and loops failures back to implementation or replanning when contradictions surface. - Three-record bookkeeping contract: Keeps tasks/todo.md, CHANGELOG.md, and prompt frontmatter status synchronized at close-out so every shipped task is traceable forward and backward. - Use Case: A developer says "work on task 17A" — the Skill loads the existing prompt, runs research and implementation phases, routes Vitest/Playwright testing, then updates the changelog, todo board, and prompt status before committing. ## Quick Start Ask the assistant to work on task 17A and run it through the full lifecycle from research to shipping.

Frequently Asked Questions about mde-task-lifecycle

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

FAQPage Schema
How do I run a task from spec to shipped code?

Invoke the lifecycle with a task ID, such as "work on task 17A". The Skill loads the existing prompt, runs research and implementation phases, routes testing through Vitest and Playwright, then updates todo.md, CHANGELOG.md, and the prompt status before committing.

How do I process a backlog of tasks automatically?

Say "process backlog" or "next P0" and the Skill reads tasks/prompts/INDEX.md, picks the next unstarted P0 task, and runs all five phases in order. Each phase hands off to specialist skills for planning, execution, testing, and shipping.

When should I not use this task lifecycle workflow?

Do not use it for writing new PRDs (use mde-writing-plans), debugging arbitrary bugs without a task ID (use systematic-debugging), authoring new skills (use mde-prompting), or one-off PRs and commits unrelated to a tracked task.

Can phases be skipped in the task lifecycle?

Planning can be skipped if a prompt already exists, research if the wiring plan is concrete and the change is trivial, and implementation for docs-only tasks. Testing is never skipped on code changes, and shipping is never skipped because it is the only durable proof of completion.

What happens when a test fails during the lifecycle?

A Phase 4 test failure loops work back to Phase 3 implementation until the build is green; the lifecycle never advances past a failing gate. If research uncovers a contradiction, the flow loops back to Phase 1 for replanning.

Does the workflow push commits to remote automatically?

No. Commits are always created during the shipping phase, but pushes happen only on explicit user request, per the repository's git protocol. Force-pushes to main are never allowed.