# Task Breakdown

Use when a feature touches 4 or more files, involves multiple components, or has...

- Repository: https://github.com/darrenhinde/OpenAgentsControl (4967 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add darrenhinde/OpenAgentsControl --skill task-breakdown -g -a claude-code -y`
Codex: `npx skills add darrenhinde/OpenAgentsControl --skill task-breakdown -g -a codex -y`
Cursor: `npx skills add darrenhinde/OpenAgentsControl --skill task-breakdown -g -a cursor -y`
Gemini CLI: `npx skills add darrenhinde/OpenAgentsControl --skill task-breakdown -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add darrenhinde/OpenAgentsControl`

## Description

Use when a feature touches 4 or more files, involves multiple components, or has subtasks that could run in parallel.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Task Breakdown

## Overview
Break down complex features into atomic, verifiable subtasks with dependency tracking. Each subtask gets its own JSON file with clear acceptance criteria and deliverables.

**Announce at start:** "I'm using the task-breakdown skill to create an execution plan for [feature]."

## The Process

### Step 1: Analyze Feature

Identify these elements:
- Core objective and scope
- Technical risks and dependencies
- Natural task boundaries
- Tasks that can run in parallel

### Step 2: Create Task Plan

Write `.tmp/tasks/{feature}/task.json`:

```json
{
  "id": "jwt-auth",
  "name": "JWT Authentication System",
  "status": "active",
  "objective": "Implement JWT-based authentication with refresh tokens",
  "context_files": [
    ".opencode/context/core/standards/code-quality.md",
    ".opencode/context/core/standards/security-patterns.md"
  ],
  "reference_files": [
    "src/middleware/auth.middleware.ts"
  ],
  "exit_criteria": [
    "All tests passing",
    "JWT tokens signed with RS256"
  ],
  "subtask_count": 3,
  "completed_count": 0,
  "created_at": "2026-02-16T02:00:00Z"
}
```

**Rules:**
- Feature ID: kebab-case
- Objective: max 200 chars
- `context_files`: standards/conventions ONLY
- `reference_files`: project source files ONLY
- Exit criteria: binary pass/fail

### Step 3: Generate Subtasks

Write `.tmp/tasks/{feature}/subtask_01.json`, `subtask_02.json`, etc:

```json
{
  "id": "jwt-auth-01",
  "seq": "01",
  "title": "Create JWT service with token generation",
  "status": "pending",
  "depends_on": [],
  "parallel": true,
  "suggested_agent": "CoderAgent",
  "context_files": [
    ".opencode/context/core/standards/security-patterns.md"
  ],
  "reference_files": [],
  "acceptance_criteria": [
    "JWT tokens signed with RS256 algorithm",
    "Access tokens expire in 15 minutes"
  ],
  "deliverables": [
    "src/auth/jwt.service.ts",
    "src/auth/jwt.service.test.ts"
  ]
}
```

The rest: https://github.com/darrenhinde/OpenAgentsControl/blob/HEAD/plugins/claude-code/skills/task-breakdown/SKILL.md