Replace paseo-orchestrator skill with paseo-orchestrate

Copy the orchestrate skill from ~/.agents/skills into the repo as paseo-orchestrate, replacing the old paseo-orchestrator.
2026-04-12 22:02:13 +07:00
parent a161a12a42
commit 609d11ee8d
12 changed files with 1128 additions and 246 deletions
@@ -0,0 +1,43 @@
+# Research Phase
+
+Deploy researchers to gather information before planning. The number and focus of researchers scales with complexity order (see triage.md).
+
+## Researcher Deployment
+
+Each researcher gets a narrow mandate. Examples:
+
+- **Codebase area:** "Read all files in `packages/server/src/server/session/`. Map the types, interfaces, and data flow. Report what you find."
+- **Test coverage:** "Read all test files related to X. What's tested? What's not? What patterns do the tests follow?"
+- **External docs:** "Search the Expo docs for Y. Find the recommended approach. Report back."
+- **Reference implementation:** "Read the cmux project at ~/dev/cmux. How does it handle Z? Report the pattern."
+- **Web research:** "Search for how other projects solve X. Find 2-3 reference implementations. Summarize the approaches."
+- **Scripts/probing:** "Write and run a small script to test whether X behaves as expected. Report the results."
+
+## Launching Researchers
+
+Use the Paseo **create agent** tool with `background: true` and `notifyOnFinish: true`:
+
+```
+title: "researcher-<scope>"
+agentType: <resolved from providers.research>
+model: <resolved from providers.research>
+background: true
+notifyOnFinish: true
+initialPrompt: "You are a researcher.
+
+Read the plan at ~/.paseo/plans/<task-slug>.md for the objective.
+
+<specific research mandate>
+
+Include in your findings: relevant files, types, interfaces, patterns, gotchas, and anything surprising. Do NOT suggest solutions or edit files."
+```
+
+## Collecting Findings
+
+Wait for all researchers to complete (you'll be notified). Use the Paseo **get agent activity** tool to read their findings. Synthesize into a research summary that feeds the planning phase.
+
+If a researcher's findings raise new questions (in default mode), go back and ask the user before proceeding to planning.
+
+## Always Archive
+
+Archive every researcher as soon as its findings are collected.