1/**
  2 * Subagent Commands - Slash commands for common subagent workflows
  3 * 
  4 * Provides easy-to-use slash commands that invoke the subagent tool:
  5 * - /scout <query> - Fast reconnaissance with scout agent
  6 * - /implement <query> - Full workflow: scout → planner → worker
  7 * - /scout-and-plan <query> - Planning workflow: scout → planner
  8 * - /review-code <query> - Review workflow: scout → reviewer
  9 */
 10
 11import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 12
 13export default function (pi: ExtensionAPI) {
 14	// /scout - Quick reconnaissance
 15	pi.registerCommand("scout", {
 16		description: "Quick codebase reconnaissance with scout agent",
 17		handler: async (args, ctx) => {
 18			if (!args.trim()) {
 19				ctx.ui.notify("Usage: /scout <query>", "error");
 20				return;
 21			}
 22
 23			// Send a message that will cause the AI to use the subagent tool
 24			ctx.ui.notify("Dispatching scout agent...", "info");
 25			pi.sendUserMessage(`Use the subagent tool to run the scout agent with this task: ${args}`);
 26		},
 27	});
 28
 29	// /implement - Full workflow
 30	pi.registerCommand("implement", {
 31		description: "Full implementation workflow: scout → planner → worker",
 32		handler: async (args, ctx) => {
 33			if (!args.trim()) {
 34				ctx.ui.notify("Usage: /implement <query>", "error");
 35				return;
 36			}
 37
 38			ctx.ui.notify("Starting implementation workflow...", "info");
 39			pi.sendUserMessage(
 40				`Use the subagent tool with chain mode to implement: ${args}\n\n` +
 41				`Chain:\n` +
 42				`1. scout agent: find all code relevant to: ${args}\n` +
 43				`2. planner agent: create implementation plan using {previous}\n` +
 44				`3. worker agent: implement the plan from {previous}`
 45			);
 46		},
 47	});
 48
 49	// /scout-and-plan - Planning workflow
 50	pi.registerCommand("scout-and-plan", {
 51		description: "Planning workflow: scout → planner (no implementation)",
 52		handler: async (args, ctx) => {
 53			if (!args.trim()) {
 54				ctx.ui.notify("Usage: /scout-and-plan <query>", "error");
 55				return;
 56			}
 57
 58			ctx.ui.notify("Starting planning workflow...", "info");
 59			pi.sendUserMessage(
 60				`Use the subagent tool with chain mode for planning: ${args}\n\n` +
 61				`Chain:\n` +
 62				`1. scout agent: find all code relevant to: ${args}\n` +
 63				`2. planner agent: create implementation plan using {previous}`
 64			);
 65		},
 66	});
 67
 68	// /review-code - Review workflow
 69	pi.registerCommand("review-code", {
 70		description: "Code review workflow: scout → reviewer",
 71		handler: async (args, ctx) => {
 72			if (!args.trim()) {
 73				ctx.ui.notify("Usage: /review-code <query>", "error");
 74				return;
 75			}
 76
 77			ctx.ui.notify("Starting code review...", "info");
 78			pi.sendUserMessage(
 79				`Use the subagent tool with chain mode to review: ${args}\n\n` +
 80				`Chain:\n` +
 81				`1. scout agent: find all code relevant to: ${args}\n` +
 82				`2. reviewer agent: review the code from {previous}`
 83			);
 84		},
 85	});
 86
 87	// /oracle - Deep analysis and debugging
 88	pi.registerCommand("oracle", {
 89		description: "Deep analysis, debugging, and architecture investigation with oracle agent",
 90		handler: async (args, ctx) => {
 91			if (!args.trim()) {
 92				ctx.ui.notify("Usage: /oracle <question or problem>", "error");
 93				return;
 94			}
 95
 96			ctx.ui.notify("Dispatching oracle agent...", "info");
 97			pi.sendUserMessage(`Use the subagent tool to run the oracle agent with this task: ${args}`);
 98		},
 99	});
100
101	// /research - Technical research with web search
102	pi.registerCommand("research", {
103		description: "Technical research with web search, GitHub, and Stack Overflow via researcher agent",
104		handler: async (args, ctx) => {
105			if (!args.trim()) {
106				ctx.ui.notify("Usage: /research <topic or question>", "error");
107				return;
108			}
109
110			ctx.ui.notify("Dispatching researcher agent...", "info");
111			pi.sendUserMessage(`Use the subagent tool to run the researcher agent with this task: ${args}`);
112		},
113	});
114
115	// /subagent-help - Show available agents
116	pi.registerCommand("subagent-help", {
117		description: "Show available subagents and usage",
118		handler: async (_args, ctx) => {
119			const help = `
120# Subagent Extension Help
121
122## Available Slash Commands
123
124- \`/scout <query>\` - Quick reconnaissance (uses Haiku, fast & cheap)
125- \`/implement <query>\` - Full workflow: scout → planner → worker
126- \`/scout-and-plan <query>\` - Planning only: scout → planner
127- \`/review-code <query>\` - Code review: scout → reviewer
128- \`/oracle <query>\` - Deep analysis, debugging, architecture investigation
129- \`/research <query>\` - Technical research with web search
130
131## Available Agents
132
133- **scout** (Haiku) - Fast recon, returns compressed context
134- **planner** (Sonnet) - Creates implementation plans
135- **reviewer** (Sonnet) - Code review
136- **worker** (Sonnet) - General purpose, full capabilities
137- **oracle** (Opus) - Deep analysis, debugging, architecture decisions
138- **researcher** (Sonnet) - Technical research with web/GitHub/SO search
139
140## Direct Tool Usage
141
142You can also ask the AI to use the subagent tool directly:
143
144**Single agent:**
145> Use scout to find all authentication code
146
147**Parallel:**
148> Run scouts in parallel: find DB schemas, find API endpoints
149
150**Chain:**
151> Chain: scout finds auth code, then planner suggests improvements
152
153## Examples
154
155\`\`\`
156/scout find all Tekton Task definitions
157/implement add Redis caching to session store
158/scout-and-plan refactor authentication module
159/review-code check security in auth handlers
160\`\`\`
161
162## Agent Details
163
164Location: ~/.pi/agent/agents/*.md
165`;
166			ctx.ui.notify("Subagent help displayed", "info");
167			console.log(help);
168		},
169	});
170}