Skip to content
All Skills

Issue

Create standalone work items (TASK, BUG, or SPIKE) with AI-assisted type detection. Use when you need to track work that needs doing, exploration needed, or something broken.

Software Engineering|v1|Updated 7/2/2026|GitHub source
MCP get_skill({ skillId: "issue-62810bd1" })

Use this skill with your agent

Create a free account and connect via MCP

Get Started Free
# /issue

Create standalone work items through natural conversation with AI-assisted type detection.

## Usage

```bash
/issue                                    # Start conversation
/issue "Implement authentication"         # AI detects: TASK
/issue "Compare GraphQL vs REST"          # AI detects: SPIKE
/issue "Broken link in project-brief"     # AI detects: BUG
/issue --project coordinatr               # Create for specific project
```

## Issue Types

| Type | Purpose | Detection Keywords |
|------|---------|-------------------|
| **TASK** | Work that needs doing | implement, create, add, build, write, set up |
| **SPIKE** | Time-boxed exploration | compare, vs, should we, evaluate, explore, research, feasibility |
| **BUG** | Something broken/wrong | fix, broken, incorrect, outdated, wrong, error |

## File Structure

```
ideas/[project]/issues/
└── 001-implement-auth/
    ├── TASK.md       # or SPIKE.md or BUG.md
    ├── PLAN.md       # Created by /plan
    └── WORKLOG.md    # Progress tracking
```

## Execution Flow

### 1. Gather Context

If no description: "What needs to be done?"
If no project: "Which project?"

### 2. Detect Type

Analyze description keywords, present detection:
> "This sounds like a **TASK**. Create as issue 002? (yes / spike / bug)"

### 3. Determine Next Issue Number

```bash
ls ideas/[project]/issues/ | grep -E '^[0-9]{3}-' | sort -n | tail -1
```

Continue reading

Sign up for a free account to view the full skill content

Login / Register
#personal-productivity#daily-routine#weekly-review#life-planning#personal-knowledge#project#management
Issue - AgentArmory Skill — AgentArmory