Reference
Agent Selection Cheat Sheet
Compressed from documentation.md and usage.md in the sita-agentic-marketplace repo. Print this, keep it by the keyboard.
Two entry points
| Entry point | Use when |
|---|---|
| Orchestrator | The work is feature-sized: needs planning, maybe design, implementation, tests, and review together. |
| Individual agent | You already know which single job you need (plan / design / code / test / review). |
Individual agents
| Agent | Call it when… | It refuses to… |
|---|---|---|
| Planner | You need to think through a structural/architectural change before coding. | Write code — it only describes. |
| Designer | UI/UX, layout, accessibility, or SITA design-language work is involved. | Write implementation code. |
| Coder | The "what" is already decided; you need it implemented. | Make architectural/design decisions. |
| Unit Tester | Code changed and needs test coverage or a gap analysis. | Fix production code itself. |
| Code Reviewer | Changes exist (yours or AI-generated) and need a structured quality check. | Write or fix code — only reviews. |
Orchestrator stages
| # | Stage | Agent used | Output |
|---|---|---|---|
| 1 | Plan | Planner | Implementation plan: steps, file assignments, edge cases, risks |
| 2 | Design (if UI involved) | Designer | Component hierarchy, layout, interaction states, accessibility |
| 3 | Implement | Coder | Code changes + build verification (2 retries on failure) |
| 4 | Test | Unit Tester | Unit tests + pass/fail results + coverage gap analysis (2 retries) |
| 5 | Review | Code Reviewer | Severity-rated findings + APPROVED / REQUEST CHANGES (2 cycles) |
| 6 | Report | Orchestrator | Consolidated summary of files changed, stage results, open issues |
A stage gate follows stages 1–5: you approve, request a re-run, or abort. Prefix your very first prompt with --yolo to skip every gate and run end-to-end unattended.
Install, in three commands
gh extension install github/gh-copilot gh auth login /plugin marketplace add https://dev.azure.com/SITA-PSE/SITA%20Agentic/_git/sita-agentic-marketplace /plugin install sita-agentic-toolkit-vscode@SITA-Agentic-Toolkit-Marketplace
Prompt template (usage.md)
Agent: <agent name> Goal: <what you want done> Scope: <files/folders/features in scope> Out of scope: <what must not change> Acceptance criteria: - <expected result> Validation: - <tests/checks> Output: - <format>