Initial commit

agents/README.md

@@ -0,0 +1,66 @@
+# 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.