tibursocampos/agent-dev-toolkit / core/skills/orchestrate-analyze
orchestrate-analyze
VerifiedOrchestrated Delivery O1: triage a feature, spawn conditional Agent specialists, write FEATURE.md + CONTINUITY + US/TS under features/NNN-slug/. No app code. Use when invoking /orchestrate-analyze.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 18.5 KB |
| reference.md | markdown | 1.8 KB |
| references/arch-confirm.md | markdown | 4.0 KB |
| references/boundaries-handoff.md | markdown | 3.5 KB |
| references/command.md | markdown | 3.5 KB |
| references/intent-classification.md | markdown | 5.2 KB |
| references/memory-bank-gate.md | markdown | 881 B |
| references/must-not.md | markdown | 4.4 KB |
| references/process-common.md | markdown | 3.8 KB |
| references/spawn-map.md | markdown | 3.7 KB |
| references/story-synthesis.md | markdown | 18.8 KB |
| references/triage.md | markdown | 5.0 KB |
references/boundaries-handoff.md
View on GitHub## Boundaries vs refine-story / sdd-spec / O2
| Aspect | `refine-story` (Backlog Refine) | `orchestrate-analyze` (O1) | `sdd-spec` (Classic SDD) | `orchestrate-deliver` (O2) |
|--------|--------------------------------|---------------------------|----------------------------|
| Purpose | One informal item + scorecard + mode envelope/Q&A | Multi-agent triage + US/TS backlog | Full PRD one story | PRD+PLAN per approved story |
| Output | STORY or `docs/backlog/` + envelope / `REFINE/qa-history.md` | FEATURE + CONTINUITY + STORY×N after the open-question gate | `…/PRD/*.md` | `…/PRD/` + `…/PLAN/` |
| Specialists | None | Conditional Agent (`needs_*`) | None | sdd contracts per story |
| App code | No | No | No | No |
| When | Informal single item | Complex / multi-story / brownfield | Ready for one PRD and no open question | After O1 **sim**, with a closed FEATURE and story folders already created |
Escalate **to O1** from refine when: multiple stories, unclear `needs_*`, brownfield needs parallel specialists.
Escalate **to sdd-spec** when: single story clear enough for PRD without O2 batching **and** no question is open, including `MINOR` (`open_question`).
### Refine envelopes / READY (O1 light)
When receiving a refine handoff or routing early to `/refine-story`, consume — do **not** duplicate taxonomy:
| Topic | Pointer |
|-------|---------|
| Mode isolation (`feature` \| `tech` \| `split`) | `skills/refine-story/references/mode-isolation.md` |
| Interaction envelope + Q&A history | `skills/refine-story/references/interaction-envelope.md`, `qa-history.md` |
| READY / NEEDS_CLARIFICATION dual-plane | `skills/_shared/sdd-artifacts/readiness-severity.md` (006 SoT; do not rewrite Assert PS1) |
Handoff strings use **portable** feature/story paths only (`STORAGE.md` § Portable path). READY ≠ SESSION `step_confirmed`. Requirement challenge stays in `requirement-review`; do not add a parallel skill.
Do **not** write PRD/PLAN inside O1. Do **not** claim `sdd-develop` one-step contract changed.
Scorecard: reuse `skills/refine-story/references/scorecard-rubric.md` (universal + type-specific; output shape `scorecard-template.md`). Map totals to STORY 1-5: 80+ -> 5, 60-79 -> 4, 40-59 -> 3, else ≤2.
Story sizing: `skills/_shared/backlog-item-types/story-sizing.md` — load at synthesis; merge/split before human gate; FEATURE table **Rationale** column required.
Product artifact quality gates: FEATURE depth (Problem/Goals/Non-goals), promotion anti-task-shatter, cap ≤4 US/TS — see `references/story-synthesis.md` § Product artifact quality gates. Do not hand off to O2 until those gates pass, the FEATURE has **no** open question (`open_question`, including `MINOR`), story folders already exist, and backlog **sim**.
O2 handoff requires a closed FEATURE and stories already created. A feature that stopped at step 8c is not an O2 handoff.
---
## Canonical handoff strings
```text
/orchestrate-deliver - <portable-feature-path>
```
```text
/orchestrate-analyze - <portable-feature-path>
```
```text
/refine-story
```
(Prefer explicit mode + portable story path when known. When the handoff is orchestrated, pass `mode=feature` or `mode=tech`. Do not leave the mode for `refine-story` to ask.)
```text
/developer
```
```text
/sdd-spec - <portable-story-path>
```
O2 **series vs parallel** is chosen inside `orchestrate-deliver` - document the choice to the user; do not implement O2 in this skill.
After O2 (for awareness only):
```text
/sdd-develop - <portable-plan-path> - Step N
/orchestrate-develop - <portable-feature-path>
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |