# Agent Utilities

Reference prompts for utility functions used across agents.

## Prompts

### todowrite-prompt.md
**Purpose:** Task list management for tracking progress.

Use for:
- Complex multi-step tasks (3+ steps)
- User provides multiple tasks
- Tracking progress on implementation
- Breaking down large features

States: `pending`, `in_progress`, `completed`

---

### askuserquestion-prompt.md
**Purpose:** Interactive clarification during execution.

Use for:
- Gathering user preferences
- Clarifying ambiguous instructions
- Getting decisions on implementation choices
- Offering direction choices

---

### conversation-summarization-prompt.md
**Purpose:** Compacting long conversations for context management.

Creates detailed summaries preserving:
- Primary request and intent
- Key technical concepts
- Files and code sections
- Errors and fixes
- Problem-solving steps
- Pending tasks

---

### session-title-prompt.md
**Purpose:** Generate concise session titles and git branch names.

Output format:
- Title: 3-6 words, no quotes
- Branch: kebab-case, 2-4 words (e.g., `add-user-auth`)

---

### security-review-prompt.md
**Purpose:** Comprehensive security analysis of code changes.

Reviews for:
- Authentication/authorization flaws
- Injection vulnerabilities (SQL, command, XSS)
- Secrets exposure
- Path traversal
- SSRF vulnerabilities
- Cryptographic issues

Only reports exploitable vulnerabilities with clear attack paths.