# Plan Harder

Use when user specfically says 'plan harder'.

- Repository: https://github.com/am-will/codex-skills (1040 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-07-14
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add am-will/codex-skills --skill plan-harder -g -a claude-code -y`
Codex: `npx skills add am-will/codex-skills --skill plan-harder -g -a codex -y`
Cursor: `npx skills add am-will/codex-skills --skill plan-harder -g -a cursor -y`
Gemini CLI: `npx skills add am-will/codex-skills --skill plan-harder -g -a gemini-cli -y`

## Description

Use when user specfically says 'plan harder'.

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

# Planner Agent

Create detailed, phased implementation plans for bugs, features, or tasks. 
You make phased implementation plans with sprints and atomic tasks.

## Process

### Phase 0: Research

1. **Investigate the codebase:**
   - Architecture and patterns
   - Similar existing implementations
   - Dependencies and frameworks
   - Related components

2. **Analyze the request:**
   - Core requirements
   - Challenges and edge cases
   - Security/performance/UX considerations

### Phase 1: Clarify Requirements

Use request_user_input to resolve ambiguities. Ask up to 10 targeted questions:
- Scope boundaries (in/out of scope)
- Technology/architectural constraints
- Priorities (critical vs nice-to-have)
- Edge case handling
- Success criteria

### Phase 2: Create Plan

#### Structure
- **Overview**: Brief summary and approach
- **Sprints**: Logical phases that build on each other
- **Tasks**: Specific, actionable items within sprints

#### Sprint Requirements
Each sprint must:
- Result in **demoable, runnable, testable** increment
- Build on prior sprint work
- Include demo/verification checklist

#### Task Requirements
Each task must be:
- **Atomic and committable** (small, independent)
- Specific with clear inputs/outputs
- Independently testable
- Include file paths when relevant
- Include dependencies for parallel execution
- Include tests or validation method

**Bad:** "Implement Google OAuth"
**Good:**
- "Add Google OAuth config to env variables"
- "Install passport-google-oauth20 package"
- "Create OAuth callback route in src/routes/auth.ts"
- "Add Google sign-in button to login UI"

### Phase 3: Save
Save the file

Generate filename from request:
1. Extract key words
2. Convert to kebab-case
3. Add `-plan.md` suffix

Examples:
- "fix xyz bug" → `xyz-bug-plan.md`
- "implement google auth" → `google-auth-plan.md`

### Phase 4: Gotchas

The rest: https://github.com/am-will/codex-skills/blob/HEAD/skills/plan-harder/SKILL.md