fix-issue

# Fix Issue

Systematic issue resolution with 5-7 parallel agents.

## Quick Start

```bash
/fix-issue 123
/fix-issue 456
```

## Phase 1: Understand the Issue

```bash
# Get full issue details
gh issue view $ARGUMENTS --json title,body,labels,assignees,comments

# Check related PRs
gh pr list --search "issue:$ARGUMENTS"
```

## Phase 2: Create Feature Branch

```bash
git checkout dev
git pull origin dev
git checkout -b issue/$ARGUMENTS-fix
```

## Phase 3: Memory Check

```python
mcp__memory__search_nodes(query="issue $ARGUMENTS")
```

## Phase 4: Parallel Analysis (5 Agents)

| Agent | Task |
|-------|------|
| Explore #1 | Root cause analysis |
| Explore #2 | Impact analysis |
| backend-system-architect | Backend fix design |
| frontend-ui-developer | Frontend fix design |
| code-quality-reviewer | Test requirements |

All 5 agents run in ONE message, then synthesize fix plan.

## Phase 5: Context7 for Patterns

```python
mcp__context7__get-library-docs(libraryId="/tiangolo/fastapi", topic="relevant")
mcp__context7__get-library-docs(libraryId="/facebook/react", topic="relevant")
```

## Phase 6: Implement the Fix (2 Agents)

| Agent | Task |
|-------|------|
| backend/frontend | Implement fix |
| code-quality-reviewer | Write tests |

Requirements:
- Make minimal, focused changes
- Add proper error handling
- Include type hints
- DO NOT over-engineer

## Phase 7: Validation

```bash
# Backend
cd backend
poetry run ruff format --check app/
poetry run ruff check app/
poetry run ty check app/
poetry run pytest tests/unit/ -v --tb=short

# Frontend
cd frontend
npm run format:check
npm run lint
npm run typecheck
npm run test
```

## Phase 8: Commit and PR

```bash
git add .
git commit -m "fix(#$ARGUMENTS): [Brief description]"
git push -u origin issue/$ARGUMENTS-fix
gh pr create --base dev --title "fix(#$ARGUMENTS): [Brief description]"
```

## Summary

**Total Parallel Agents: 7**
- Phase 4 (Analysis): 5 agents
- Phase 6 (Implementation): 2 agents

**Agents Used:**
-