Setup & Strategy

/toolkit-init

Setup

Initialize your project with AI Toolkit structure. Creates CLAUDE.md, docs/, pm/ directories, and 51 template files.

Interactive (2 questions)

/project-brief

Strategy

Create your project vision through interactive Q&A. Defines what you're building, target audience, and success metrics.

Usage: /project-brief [--force] [--review]

Specification & Planning

/spec

Planning

Create feature specifications with acceptance criteria. Living documents that adapt as you discover requirements.

Usage: /spec [--update SPEC-###] [--epic PROJ-###]

/adr

Architecture

Create Architecture Decision Records for technical decisions. Quick Mode or Deep Mode for thorough analysis.

Usage: /adr ["topic"]

/issue

Planning

Create work items with AI-assisted type detection. Creates TASK, BUG, or SPIKE based on description keywords.

Usage: /issue "description"

/plan

Planning

Create PLAN.md with phase-based breakdown. TDD phases for tasks, reproduction-first for bugs, exploration for spikes.

Usage: /plan ###

Implementation

/implement

Execution

Execute implementation phases with TDD enforcement. AI writes code, runs tests, enforces quality gates.

Usage: /implement ### PHASE or --next or --full

/advise

Execution

Get implementation guidance without automated code generation. AI guides, you write the code.

Usage: /advise ### PHASE or --next

/complete

Completion

Finish work items per workflow requirements. Validates phases complete, tests passing, acceptance criteria met.

Usage: /complete ###

Quality & Debugging

/quality

Quality

Multi-dimensional quality assessment. Security, performance, testing, code quality, and documentation analysis.

Usage: /quality [--focus AREA]

/troubleshoot

Debugging

Systematic debugging with 5-step loop. Research first, one hypothesis at a time, validate before claiming fixed.

Usage: /troubleshoot [### | "description"]

/sanity-check

Validation

Mid-work validation with deep reflection. Catches drift before it becomes expensive to fix.

Usage: /sanity-check

Research

/research

Research

Deep research on topics with persistent documentation. Creates reusable research docs in docs/project/research/.

Usage: /research "topic to research"

Development Support

/branch

Git

Unified branch operations with git-workflow enforcement. Create, merge, delete, switch, and status.

Usage: /branch create|merge|delete|switch|status

/commit

Git

Branch-aware git commits with automatic issue references and conventional commit messages.

Usage: /commit [message]

/worklog

Tracking

Add timestamped work log entries. Track manual changes and communicate with AI across sessions.

Usage: /worklog "your comment"

/sync-progress

Tracking

Analyze git changes and update plan to reflect progress. Syncs state after manual changes.

Usage: /sync-progress

/refresh

Context

Silently refresh AI context by reading project configuration, guidelines, and recent commits.

Usage: /refresh

Jira Integration

/jira-import

Jira

Import Jira issue for local work with PLAN.md creation.

Usage: /jira-import PROJ-###

/jira-promote

Jira

Promote local exploration issue to Jira for team visibility.

Usage: /jira-promote ###

/jira-comment

Jira

Add AI-suggested comments to external Jira issues based on work context.

Usage: /jira-comment PROJ-###

/jira-epic

Jira

Create Jira epics through natural language conversation.

Usage: /jira-epic [PROJ-### | --spec SPEC-###]

Documentation & Status

/docs

Docs

Unified documentation management. Sync, validate, health check, update, and generate documentation.

Usage: /docs --sync|--validate|--health|--update|--generate

/project-status

Status

Project status dashboard with intelligent context analysis.

Usage: /project-status [--ai-format] [--detailed]

/ui-design

Design

Create and iterate on HTML UI mockups with parallel design exploration.

Usage: /ui-design

Versioning & Releases

/changelog

Release

Check and update CHANGELOG.md with undocumented changes.

Usage: /changelog

/release

Release

Release new version following semantic versioning guidelines.

Usage: /release

Command Parameter Patterns

  • No Parameters - Conversational commands that ask questions: /project-brief, /adr, /toolkit-init
  • Required Arguments - Precise operations on specific targets: /plan 001, /implement 001 1.2
  • Optional Arguments - Context-aware commands: /spec, /troubleshoot
  • Subcommands - Multiple related operations: /branch create|merge|delete|switch