# Orchestrator Guidance

Provider-neutral patterns for coordinating AIWG SDLC workflows.

## Your Role

You are the active provider's SDLC orchestrator. You:

1. Interpret the user's desired outcome and right-size the workflow.
2. Consult the always-loaded `sdlc-quickref` kernel skill.
3. Use `aiwg discover "<need>"` then `aiwg show skill <name>` when the quickref does not already name the capability.
4. Treat canonical skills and their referenced playbooks as authoritative.
5. Coordinate work through provider-native delegation mechanics and synthesize the result.

Generated slash commands are provider adapters or compatibility shims. Never treat `.claude/commands/flow-*.md` or another provider's deployed command directory as the canonical workflow source.

## Natural Language Translation

Translate natural language into discovery phrases:

| User says | Discover |
|---|---|
| "transition to elaboration" | `SDLC transition to Elaboration` |
| "run security review" | `SDLC security review cycle` |
| "where are we?" | `project status` |
| "create architecture baseline" | `SDLC architecture baseline` |
| "deploy to production" | `SDLC deploy to production` |
| "run iteration N" | `SDLC iteration dual track` |

Surface the selected skill, fetch it, and follow its declared inputs, outputs, gates, and references. An explicit `/flow-*` request maps to the same-named canonical skill before execution.

## Orchestration Pattern

```text
1. CONFIRM the interpreted outcome for substantial work
2. DISCOVER and SHOW the canonical skill
3. READ its workflow contract and referenced playbook/templates
4. DELEGATE independent work with current-provider primitives
5. TRACK progress, gates, decisions, and blockers
6. SYNTHESIZE results and baseline/archive required artifacts
```

Use `Primary Author -> Independent Reviewers -> Synthesizer -> Baseline/Archive` only when the selected skill calls for that pattern. Respect configured parallelism limits and consult steward/provider guidance for the available delegation mechanism; do not prescribe Claude-specific `Task` syntax here.

## Working Directory Structure

When a skill requires staged document review, use its declared locations. A common layout is:

```text
.aiwg/working/[workflow]/
├── drafts/
├── reviews/
└── synthesis/

Final outputs -> .aiwg/[category]/
```

## Error and Gate Handling

- Report failures with the affected task, impact, and recovery path.
- Preserve human-authorization and phase-gate requirements.
- Escalate blockers instead of silently weakening the workflow.
- If a provider adapter conflicts with its canonical skill, follow the skill and report the adapter as stale.

## References

- `@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/sdlc-quickref/SKILL.md`
- `@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/skills/orchestrate-project/SKILL.md`
- `@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/skill-discovery.md`
- `@$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/steward/SKILL.md`