StackShift Agents

Custom AI agents for StackShift tasks. These agents are included with the plugin so users don't need external dependencies.

Available Agents

stackshift:technical-writer

Purpose: Generate technical documentation and specifications

Use cases:

Creating feature specifications in specs/
Writing constitution.md
Generating implementation plans
Creating comprehensive documentation

Specialization:

Clear, concise technical writing
Markdown formatting
GitHub Spec Kit format compliance
Acceptance criteria definition
Implementation status tracking

stackshift:code-analyzer

Purpose: Deep codebase analysis and extraction

Use cases:

Extracting API endpoints from code
Identifying data models and schemas
Mapping component structure
Detecting configuration options
Assessing completeness

Specialization:

Multi-language code analysis
Pattern recognition
Dependency detection
Architecture identification

How They Work

StackShift agents are automatically available when the plugin is installed. Skills can invoke them for specific tasks:

// In a skill
Task({
  subagent_type: 'stackshift:technical-writer',
  prompt: 'Generate feature specification for user authentication...'
})

Benefits

✅ Self-contained - No external dependencies ✅ Optimized - Tuned for StackShift workflows ✅ Consistent - Same output format every time ✅ Reliable - Don't break if user doesn't have other plugins

Agent Definitions

Each agent has:

AGENT.md - Agent definition and instructions
Specific tools and capabilities
Guidelines for output format
Examples of usage

These follow Claude Code's agent specification format.