Update workflow instructions for design review outcomes
Clarified workflow routing based on design review outcomes.
This commit is contained in:
167
design-orchestration.md
Normal file
167
design-orchestration.md
Normal file
@@ -0,0 +1,167 @@
|
||||
---
|
||||
name: design-orchestration
|
||||
description: >
|
||||
Orchestrates design workflows by routing work through
|
||||
brainstorming, multi-agent review, and execution readiness
|
||||
in the correct order. Prevents premature implementation,
|
||||
skipped validation, and unreviewed high-risk designs.
|
||||
---
|
||||
|
||||
# Design Orchestration (Meta-Skill)
|
||||
|
||||
## Purpose
|
||||
|
||||
Ensure that **ideas become designs**, **designs are reviewed**, and
|
||||
**only validated designs reach implementation**.
|
||||
|
||||
This skill does not generate designs.
|
||||
It **controls the flow between other skills**.
|
||||
|
||||
---
|
||||
|
||||
## Operating Model
|
||||
|
||||
This is a **routing and enforcement skill**, not a creative one.
|
||||
|
||||
It decides:
|
||||
- which skill must run next
|
||||
- whether escalation is required
|
||||
- whether execution is permitted
|
||||
|
||||
---
|
||||
|
||||
## Controlled Skills
|
||||
|
||||
This meta-skill coordinates the following:
|
||||
|
||||
- `brainstorming` — design generation
|
||||
- `multi-agent-brainstorming` — design validation
|
||||
- downstream implementation or planning skills
|
||||
|
||||
---
|
||||
|
||||
## Entry Conditions
|
||||
|
||||
Invoke this skill when:
|
||||
- a user proposes a new feature, system, or change
|
||||
- a design decision carries meaningful risk
|
||||
- correctness matters more than speed
|
||||
|
||||
---
|
||||
|
||||
## Routing Logic
|
||||
|
||||
### Step 1 — Brainstorming (Mandatory)
|
||||
|
||||
If no validated design exists:
|
||||
|
||||
- Invoke `brainstorming`
|
||||
- Require:
|
||||
- Understanding Lock
|
||||
- Initial Design
|
||||
- Decision Log started
|
||||
|
||||
You may NOT proceed without these artifacts.
|
||||
|
||||
---
|
||||
|
||||
### Step 2 — Risk Assessment
|
||||
|
||||
After brainstorming completes, classify the design as:
|
||||
|
||||
- **Low risk**
|
||||
- **Moderate risk**
|
||||
- **High risk**
|
||||
|
||||
Use factors such as:
|
||||
- user impact
|
||||
- irreversibility
|
||||
- operational cost
|
||||
- complexity
|
||||
- uncertainty
|
||||
- novelty
|
||||
|
||||
---
|
||||
|
||||
### Step 3 — Conditional Escalation
|
||||
|
||||
- **Low risk**
|
||||
→ Proceed to implementation planning
|
||||
|
||||
- **Moderate risk**
|
||||
→ Recommend `multi-agent-brainstorming`
|
||||
|
||||
- **High risk**
|
||||
→ REQUIRE `multi-agent-brainstorming`
|
||||
|
||||
Skipping escalation when required is prohibited.
|
||||
|
||||
---
|
||||
|
||||
### Step 4 — Multi-Agent Review (If Invoked)
|
||||
|
||||
If `multi-agent-brainstorming` is run:
|
||||
|
||||
Require:
|
||||
- completed Understanding Lock
|
||||
- current Design
|
||||
- Decision Log
|
||||
|
||||
Do NOT allow:
|
||||
- new ideation
|
||||
- scope expansion
|
||||
- reopening problem definition
|
||||
|
||||
Only critique, revision, and decision resolution are allowed.
|
||||
|
||||
---
|
||||
|
||||
### Step 5 — Execution Readiness Check
|
||||
|
||||
Before allowing implementation:
|
||||
|
||||
Confirm:
|
||||
- design is approved (single-agent or multi-agent)
|
||||
- Decision Log is complete
|
||||
- major assumptions are documented
|
||||
- known risks are acknowledged
|
||||
|
||||
If any condition fails:
|
||||
- block execution
|
||||
- return to the appropriate skill
|
||||
|
||||
---
|
||||
|
||||
## Enforcement Rules
|
||||
|
||||
- Do NOT allow implementation without a validated design
|
||||
- Do NOT allow skipping required review
|
||||
- Do NOT allow silent escalation or de-escalation
|
||||
- Do NOT merge design and implementation phases
|
||||
|
||||
---
|
||||
|
||||
## Exit Conditions
|
||||
|
||||
This meta-skill exits ONLY when:
|
||||
- the next step is explicitly identified, AND
|
||||
- all required prior steps are complete
|
||||
|
||||
Possible exits:
|
||||
- “Proceed to implementation planning”
|
||||
- “Run multi-agent-brainstorming”
|
||||
- “Return to brainstorming for clarification”
|
||||
- "If a reviewed design reports a final disposition of APPROVED, REVISE, or REJECT, you MUST route the workflow accordingly and state the chosen next step explicitly."
|
||||
---
|
||||
|
||||
## Design Philosophy
|
||||
|
||||
This skill exists to:
|
||||
- slow down the right decisions
|
||||
- speed up the right execution
|
||||
- prevent costly mistakes
|
||||
|
||||
Good systems fail early.
|
||||
Bad systems fail in production.
|
||||
|
||||
This meta-skill exists to enforce the former.
|
||||
Reference in New Issue
Block a user