Task

Task Creator

Quickly add new tasks to MASTER_PLAN.md with automatic sequential ID generation.

Triggers

• /master-plan:task - Main command
• "add task", "new task", "create task", "track this", "log a bug"

Workflow

Step 1: Find MASTER_PLAN.md

Search for the plan file in order:

1. docs/MASTER_PLAN.md
2. MASTER_PLAN.md
3. master-plan.md
4. docs/master-plan.md

If not found: Create docs/MASTER_PLAN.md using the template structure (see "Initial Setup" section below).

Step 2: Generate Next Task ID

Read the MASTER_PLAN.md file and find all existing task IDs:

1. Scan for all occurrences matching (TASK|BUG|FEATURE|ROAD|IDEA|ISSUE|INQUIRY)-(\d+)
2. Extract the numeric part from each match
3. Find the highest number
4. Next ID = highest + 1

CRITICAL: IDs are sequential across ALL types. If TASK-42 and BUG-43 exist, the next ID is 44 regardless of type.

Immediately output to user:

Using task number: [ID]

This must happen BEFORE asking any questions.

Step 3: Gather Task Information

Use AskUserQuestion to collect:

1. Task Type (header: "Type")

• TASK — New feature or improvement
• BUG — Bug fix
• FEATURE — Major new feature
• INQUIRY — Investigation (not a fix, just understanding something)

1. Priority (header: "Priority")

• P0 — Critical / Blocker
• P1 — High priority
• P2 — Medium priority (Recommended)
• P3 — Low priority / Backlog

Then ask in plain text: "What's the task title? (Keep it concise, under 50 chars)"

Optionally ask: "Any additional description? (Or just press enter to skip)"

Step 4: Add to MASTER_PLAN.md

4a. Add to Roadmap Table (if one exists)

Look for a markdown table with task IDs. Insert a new row:

| **[TYPE]-[ID]** | **[Title]** | **[Priority]** | PLANNED | - |

4b. Add Detailed Section

Add a new ### section at the appropriate place (typically at the end of the active work area, before completed tasks):

### [TYPE]-[ID]: [Title] (PLANNED)
**Priority**: [Priority]
**Status**: PLANNED (YYYY-MM-DD)

[Description if provided]

**Tasks**:
- [ ] [First step — infer from context or ask user]

For P0/P1 tasks, add a note that this is high priority.

Step 5: Confirm

Output to user:

Task added to MASTER_PLAN.md:
- **ID**: [TYPE]-[ID]
- **Title**: [Title]
- **Priority**: [Priority]
- **Status**: PLANNED

Use `/master-plan:next` to start working on it, or `/master-plan:done [ID]` when complete.

Initial Setup

If no MASTER_PLAN.md exists, create docs/MASTER_PLAN.md with this structure:

# MASTER PLAN

> Project task tracking and roadmap.

## Roadmap

| ID | Title | Priority | Status | Dependencies |
|----|-------|----------|--------|--------------|

## Active Work

## Completed

Also create the docs/ directory if it doesn't exist.

ID Format Reference

| Prefix | Usage | |--------|-------| | TASK-XXX | Features and improvements | | BUG-XXX | Bug fixes | | FEATURE-XXX | Major features | | ROAD-XXX | Roadmap items | | IDEA-XXX | Ideas for later | | ISSUE-XXX | Known issues | | INQUIRY-XXX | Investigations |

Important Rules

1. NEVER reuse existing task IDs — Always scan the file first
2. IDs are global — Sequential across all types (TASK, BUG, etc.)
3. Use strikethrough (~~ID~~) only when marking tasks DONE
4. Keep titles concise — Under 50 characters
5. P0 tasks should always get an immediate detailed section

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: endlessblink
• Source: endlessblink/master-plan
• License: MIT

Install and usage instructions live in the source repository linked above.