# Code Task Generator

Generates structured .code-task.md files from descriptions or PDD implementation plans.

- Repository: https://github.com/mikeyobrien/ralph-orchestrator (3190 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mikeyobrien/ralph-orchestrator --skill code-task-generator -g -a claude-code -y`
Codex: `npx skills add mikeyobrien/ralph-orchestrator --skill code-task-generator -g -a codex -y`
Cursor: `npx skills add mikeyobrien/ralph-orchestrator --skill code-task-generator -g -a cursor -y`
Gemini CLI: `npx skills add mikeyobrien/ralph-orchestrator --skill code-task-generator -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add mikeyobrien/ralph-orchestrator`

## Description

Generates structured .code-task.md files from descriptions or PDD implementation plans. Auto-detects input type, creates properly formatted tasks with Given-When-Then acceptance criteria.

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

# Code Task Generator

## Overview

Generate structured code task files from rough descriptions or PDD implementation plans. Auto-detects input type and creates properly formatted `.code-task.md` files. For PDD plans, processes one step at a time to allow learning between steps.

## Important Notes

These rules apply across ALL steps:

- **User approval required:** Present the task breakdown plan and get explicit approval before generating any files.
- **Tests are integrated:** Include unit test requirements in each task's acceptance criteria. Never create separate "add tests" tasks.
- **PDD mode references:** Always include the design document path as required reading. Only include research docs if directly relevant to the specific task.

## Parameters

- **input** (required): Task description, file path, or PDD plan path
- **step_number** (optional, PDD only): Specific step to process. Auto-determines next uncompleted step if omitted.
- **output_dir** (optional, default: `.ralph/tasks/`): Output directory for code task files
- **task_name** (optional, description mode only): Override auto-generated task name

**Constraints:**
- You MUST ask for all required parameters upfront in a single prompt
- You MUST support input as: direct text, file path, directory path (looks for plan.md), or URL

## Steps

### 1. Detect Input Mode

Check if input is a file with PDD plan structure (checklist + numbered steps). Set mode to "pdd" or "description" and inform the user.

### 2. Analyze Input

- **PDD mode:** Parse the plan, extract steps and checklist status, determine target step (from step_number or first uncompleted)
- **Description mode:** Identify core functionality, technical requirements, complexity level (Low/Medium/High), and technology domain

### 3. Structure Requirements

The rest: https://github.com/mikeyobrien/ralph-orchestrator/blob/HEAD/.claude/skills/code-task-generator/SKILL.md