67 lines
1.7 KiB
Markdown
67 lines
1.7 KiB
Markdown
# 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:
|
|
|
|
```typescript
|
|
// 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.
|