task-development-workflow
TDD-first development workflow with structured planning, task tracking, and PR-based code review. Use when building software projects that require clarification phases, planning approval gates, Trello task management, test-driven development, Git branching policies, and PR feedback loops with reviewers.
Best use case
task-development-workflow is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
TDD-first development workflow with structured planning, task tracking, and PR-based code review. Use when building software projects that require clarification phases, planning approval gates, Trello task management, test-driven development, Git branching policies, and PR feedback loops with reviewers.
Teams using task-development-workflow should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/task-development-workflow/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How task-development-workflow Compares
| Feature / Agent | task-development-workflow | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
TDD-first development workflow with structured planning, task tracking, and PR-based code review. Use when building software projects that require clarification phases, planning approval gates, Trello task management, test-driven development, Git branching policies, and PR feedback loops with reviewers.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
SKILL.md Source
# Task Workflow
A structured development workflow enforcing quality through planning, TDD, and code review.
## Workflow Overview
```
Clarify → Plan → Approve → Implement (TDD) → PR → Review → Merge → Next Task
```
## Phase 1: Clarification
Before any implementation, ask questions to clarify:
- Business requirements and goals
- UI/UX flow expectations
- Architecture decisions
- Technical constraints
- Ambiguous requirements
**Do not proceed until requirements are clear.**
## Phase 2: Planning & Approval
1. Present a detailed plan with task breakdown
2. Keep tasks small and focused
3. **Wait for explicit approval** before starting
4. No implementation without approval
## Phase 3: Task Tracking Setup
Set up Trello board (or similar) with columns:
- 📝 Backlog
- 📋 To Do
- 🔨 In Progress
- 🔍 Review
- ✅ Done
All tasks must be tracked on the board.
## Phase 4: Implementation (Per Task)
For each task:
1. **Move card** to "In Progress"
2. **Write tests first** (TDD):
- Define expected behavior in tests
- Run tests (should fail)
- Implement the feature
- Run tests (should pass)
3. **Commit** after task completion
4. Tests may be skipped **only with explicit approval**
## Phase 5: Branching & PR Policy
**Rules:**
- Never push directly to `main`
- Never change the default branch — `main` must always remain default
- Create feature branches for each task
**After task completion:**
1. Open PR from task branch → `main`
2. Include Trello task link in PR description
3. Move card to "Review"
4. Notify Reviewer with both Trello link and PR link
## Phase 6: PR Feedback Loop
When CR comments arrive:
1. Move task back to "In Progress"
2. Address all review comments
3. Push fixes
4. Notify Reviewer to re-review (include both links)
Repeat until approved.
## Phase 7: Merge Gate
- **Only pick the next task after current PR is merged**
- Move completed card to "Done"
- Then proceed to next task from "To Do"
## Flow Diagram
```
Backlog → To Do → In Progress → Review → Done
↑ │
└─── CR ─────┘
```
## New Project Bootstrap
For new projects:
1. Create repository with initial README
2. Push to remote
3. Then begin implementation tasks
## Key Principles
- **Quality over speed** — TDD catches bugs early
- **Small tasks** — easier to review and merge
- **Clear communication** — always notify reviewers
- **No shortcuts** — follow the process every timeRelated Skills
n8n Workflow Mastery — Complete Automation Engineering System
You are an expert n8n workflow architect. You design, build, debug, optimize, and scale n8n automations following production-grade methodology. Every workflow you create is complete, functional, and follows the patterns in this guide.
Executive Coaching & Leadership Development Engine
Complete executive coaching system — leadership assessment, 360° feedback, coaching engagements, leadership development plans, team effectiveness, executive presence, and succession planning. Use for leadership coaching, executive development programs, team building, performance breakthroughs, and career transitions.
n8n-workflow-automation
Designs and outputs n8n workflow JSON with robust triggers, idempotency, error handling, logging, retries, and human-in-the-loop review queues. Use when you need an auditable automation that won’t silently fail.
task-decomposer
Decomposes complex user requests into executable subtasks, identifies required capabilities, searches for existing skills at skills.sh, and creates new skills when no solution exists. This skill should be used when the user submits a complex multi-step request, wants to automate workflows, or needs help breaking down large tasks into manageable pieces.
swarm-workflow-protocol
Multi-agent orchestration protocol for the 0x-wzw swarm. Defines spawn logic, relay communication, task routing, and information flow. Agents drive decisions; humans spar.
agentic-workflow-automation
Generate reusable multi-step agent workflow blueprints. Use for trigger/action orchestration, deterministic workflow definitions, and automation handoff artifacts.
tasknotes
Manage tasks in Obsidian via TaskNotes plugin API. Use when user wants to create tasks, list tasks, query by status or project, update task status, delete tasks, or check what they need to do.
workflow-agent
选择并改写 ComfyUI 工作流模板，输出可直接提交到 ComfyUI API 的完整 JSON。当需要准备渲染任务、选择模型、调整参数时触发。
byt-workflow
YouTube video translation workflow, download audio, launch Doubao, play audio, capture translation
banner-youtube-translate-workflow
Complete workflow: download YouTube audio, launch Doubao, play audio, capture translation. Activates when user needs full video translation.
ayao-workflow-agent
Multi-agent workflow orchestrator for coding, writing, analysis, and image tasks via tmux-driven Claude Code and Codex agents. Use when: (1) user requests a feature/fix that should be delegated to coding agents, (2) managing parallel coding tasks across front-end and back-end, (3) monitoring active agent sessions and coordinating review, (4) user says 'start task', 'assign to agents', 'swarm mode', or references the ayao-workflow-agent playbook. NOT for: simple one-liner edits (just edit directly), reading code (use read tool), or single quick questions about code.
dify-workflow
Use when creating, editing, debugging, or validating Dify workflow DSL for self-hosted Dify. Start from an exported workflow of the target instance, edit minimally, and verify by re-importing.