Template: Scenario
Reusable формат для описания cross-functional flows — последовательности действий с участием multiple agents + human touchpoints.
Скопируй в 04-Processes/Scenario-<slug>.md или включи в existing process doc.
Когда использовать
- Cross-functional flow (несколько agents / departments involved)
- Есть явная последовательность stages
- Есть HITL checkpoints
- Нужно явно документировать failure modes
Если это single-agent task — достаточно Template-Task. Если это quality check loop — достаточно Agent-Judge default process.
Frontmatter
---
title: "Scenario — [Name]"
type: scenario
status: proposed|active|deprecated
tags: [scenario, ...]
---Секции
Summary
1-2 предложения. Что этот scenario делает, когда запускается, чем заканчивается.
Trigger
Что запускает scenario:
- Event (e.g.
hypothesis.proposed) - Schedule (e.g. weekly)
- Human request
- Другой scenario (chain)
Agents / Departments involved
List, в каком order первые появляются:
- Agent-CEO — scenario initiator / orchestrator
- Agent-IntelDirector — research coordination
- Agent-MarketResearcher — executor
- …
Stages
Таблица: step | actor | action | criticality.
| # | Stage | Actor | Action | Criticality |
|---|---|---|---|---|
| 1 | … | … | … | L1/L2/L3/… |
HITL Checkpoints
Где human approval / interaction обязателен:
- Stage N: [описание checkpoint, why human needed]
Decision Points
Branching: “если X → path A, иначе path B”.
Failure modes
Что идёт не так + mitigation:
- Failure: [описание]
- Detection: [как понимаем что сломалось]
- Mitigation: [что делать]
- Recovery: [как возвращаемся в good state]
KPI
Measurable metrics для оценки scenario успеха:
- Success rate
- Duration (p50, p95)
- Cost per run
- Specific domain metrics
SLA
End-to-end expectation:
- Target: X hours от trigger до completion
- Per-stage max duration
- Escalation если exceeded
Open Questions
Нерешённые детали.
References
Связанные documents.
Example: Hypothesis-to-Validation (Synth Nova-native)
Заполненный пример для существующего Synth Nova flow.
Summary
От proposed гипотезы до first validation data (target ≤72h per Manifesto). Gate для “разрабатывать дальше vs kill / pivot”.
Trigger
Human (Max Nova) через Agent-CEO emit-ит hypothesis.proposed event с
формой из Template-Hypothesis.
Agents / Departments involved
- Agent-CEO — decomposition, department selection
- Agent-IntelDirector или Agent-NicheEvaluationDirector — routing по типу гипотезы
- Executor tier — specific research / data gathering
- Agent-Judge — quality check on outputs
Stages
| # | Stage | Actor | Action | Criticality |
|---|---|---|---|---|
| 1 | Hypothesis intake | Agent-CEO | Parse intent, decompose | L1 |
| 2 | Department routing | Agent-CEO | Select Director | L1 |
| 3 | Child task creation | Agent-CEO | Create tasks с success_criteria, kill_criteria | L2 |
| 4 | Task distribution | Director | Assign to Executors | L1 |
| 5 | Data gathering | Executors | Execute research | L1-L2 |
| 6 | Quality check | Agent-Judge | Review findings | L1 |
| 7 | Aggregation | Director | Combine results, confidence assessment | L2 |
| 8 | Persevere/Pivot/Kill recommendation | Agent-CEO | Synthesize, recommend | L2 (propose) |
| 9 | Human decision | Founder | Accept / reject recommendation | L3 decision by human |
| 10 | Outcome labeling | HITL-Gateway | Capture decision + reasoning | L1 |
| 11 | Memory persistence | Memory-Model | Store full trace | L1 |
HITL Checkpoints
- Stage 9: Founder decision mandatory. Agents не могут autonomously kill hypothesis — это product/strategy decision.
- Escalation anytime: если confidence < 0.7 на Stage 5-8 → early escalate к Founder с partial data.
Decision Points
- После Stage 7, based на aggregated confidence:
- High confidence (>0.85) + favorable data → propose “persevere”
- Moderate (0.7-0.85) → propose “pivot with refinement”
- Low (<0.7) → propose “kill” с reasoning
- Very low or kill_criteria met → auto-recommend “kill” без Chamber
Failure modes
-
Failure: Research data contradictory / insufficient
- Detection: Agent-Judge flags low confidence, inter-source disagreement
- Mitigation: Expand research scope, add sources, extend budget
- Recovery: Return к Stage 5 с expanded task spec
-
Failure: Budget exceeded mid-scenario
- Detection: Running cost > 80% allocated
- Mitigation: Agent-CEO assesses — complete with current data vs expand budget (Founder approval) vs abort
- Recovery: Partial results к Founder, explicit note “budget-constrained”
-
Failure: Stale data in memory
- Detection: Memory refs older than configurable TTL
- Mitigation: Re-research, invalidate stale refs
- Recovery: Re-run affected stages
-
Failure: External tool unavailable (web search, etc.)
- Detection: Tool call failures > retry threshold
- Mitigation: Fallback tool OR partial completion с gap noted
- Recovery: Retry with exponential backoff, if still fail → escalate
KPI
- Primary: Time from trigger к Founder decision (target ≤72h per Manifesto)
- Validation confidence delivered (target ≥0.70 or explicit note low confidence)
- Cost per hypothesis (target reducing QoQ)
- Human intervention rate outside planned Stage 9 (target <30%)
- Kill-criteria hit rate (measure если criteria well-calibrated)
SLA
- End-to-end: 72h target, 120h hard limit (after → auto-escalate partial)
- Stage 5 (research) max: 48h
- Stage 9 (Founder decision) max: 24h (via HITL-Gateway)
Open Questions
- Persistent intent tracking (см. Agent-CEO open questions)
- Handling sub-hypotheses (can generate within scenario)
- Cross-hypothesis learning — sharing insights
References
- Manifesto — 72h target, Build-Measure-Learn
- Build-Measure-Learn
- Hypothesis-Driven-Development
- Lean-Startup
- Template-Hypothesis
- Agent-CEO
- Agent-Judge
- Process-HypothesisValidation (existing)
- Process-Failure-Patterns
- Process-OutcomeLabeling
- Rules-Criticality
- HITL-Gateway
Rules for scenario authors
- Один scenario = one coherent flow. Если описываешь “everything about research” — разделяй на multiple scenarios.
- Actor per stage — explicit. Не “the team” — конкретный agent или Founder.
- Criticality per stage. Помогает verify что routing consistent с Rules-Criticality.
- Failure modes обязательны. Scenario без failure modes = incomplete.
- KPI measurable. “Good outcomes” — не KPI. Duration, success rate, cost — KPI.
- Update when reality changes. Scenario — live document, как и остальной vault.
Связанные документы
- Template-Task, Template-Hypothesis, Template-ADR, Template-Role
- Rules-Criticality — classification stages
- HITL-Gateway — checkpoint destination
- Process-Failure-Patterns — cross-scenario patterns
- Reference-Org-Blueprint — section §4 Cross-Functional Scenarios