AgentSkillsCN

Phoenix Workflow Orchestrator

Phoenix 工作流编排器

SKILL.md
--- frontmatter
status: ACTIVE
last_updated: 2026-01-19

Phoenix Workflow Orchestrator

Overview

Master routing skill for the 9 Phoenix domain skills. Use this skill to determine which Phoenix specialist skill to activate based on the task type. Consolidates Phoenix validation, calculation, and reporting workflows.

Triggers

Activate this skill when you see:

  • •"phoenix" OR "truth case" OR "validation"
  • •"waterfall" OR "xirr" OR "fees" OR "carry"
  • •"capital allocation" OR "exit recycling" OR "reserves"
  • •"monte carlo" OR "graduation" OR "moic"
  • •"brand" OR "reporting" OR "Press On Ventures"
  • •"precision" OR "numeric drift" OR "Decimal.js"

Phoenix Skill Inventory

SkillPhasePrimary Use
phoenix-truth-case-orchestrator0Run suite, triage failures
phoenix-precision-guard1ANumeric precision, Decimal.js
phoenix-waterfall-ledger-semantics1BWaterfall/carry calculations
phoenix-xirr-fees-validator1BXIRR and fee calculations
phoenix-capital-exit-investigator1ACapital allocation, recycling
phoenix-docs-sync1AJSDoc and docs alignment
phoenix-advanced-forecasting2Monte Carlo, graduation, MOIC
phoenix-reserves-optimizer2Reserve sizing optimization
phoenix-brand-reporting3Brand-consistent UI/reports

Decision Tree

code
Phoenix Task
    |
    v
Is this about running truth cases?
    |
    +-- YES --> phoenix-truth-case-orchestrator
    |           Command: /phoenix-truth
    |
    +-- NO --> Continue
    |
Is this about numeric precision or floating-point issues?
    |
    +-- YES --> phoenix-precision-guard
    |           (parseFloat → Decimal.js, tolerance issues)
    |
    +-- NO --> Continue
    |
Is this about waterfall/carry/clawback calculations?
    |
    +-- YES --> phoenix-waterfall-ledger-semantics
    |           Agent: waterfall-specialist
    |
    +-- NO --> Continue
    |
Is this about XIRR or fee calculations?
    |
    +-- YES --> phoenix-xirr-fees-validator
    |           Agent: xirr-fees-validator
    |
    +-- NO --> Continue
    |
Is this about capital allocation or exit recycling?
    |
    +-- YES --> phoenix-capital-exit-investigator
    |           Agent: phoenix-capital-allocation-analyst
    |
    +-- NO --> Continue
    |
Is this about documentation alignment (JSDoc, calculations.md)?
    |
    +-- YES --> phoenix-docs-sync
    |           Agent: phoenix-docs-scribe
    |
    +-- NO --> Continue
    |
Is this about Monte Carlo, graduation modeling, or MOIC?
    |
    +-- YES --> phoenix-advanced-forecasting
    |           Agent: phoenix-probabilistic-engineer
    |           Command: /phoenix-phase2
    |
    +-- NO --> Continue
    |
Is this about reserve sizing or follow-on allocation?
    |
    +-- YES --> phoenix-reserves-optimizer
    |           Agent: phoenix-reserves-optimizer
    |
    +-- NO --> Continue
    |
Is this about UI/reporting/branding?
    |
    +-- YES --> phoenix-brand-reporting
    |           Agent: phoenix-brand-reporting-stylist
    |
    +-- NO --> Use general phoenix-truth-case-orchestrator

Phase-Based Routing

Phase 0: Foundation Validation

Goal: Establish truth case baseline

TaskSkillAgent
Run all truth casesphoenix-truth-case-orchestratorphoenix-truth-case-runner
Triage failuresphoenix-truth-case-orchestratorphoenix-truth-case-runner
Baseline comparisonphoenix-truth-case-orchestrator-

Phase 1A: Precision & Provenance

Goal: Fix precision drift, establish provenance

TaskSkillAgent
parseFloat → Decimal.jsphoenix-precision-guardphoenix-precision-guardian
Low-confidence modulesphoenix-capital-exit-investigatorphoenix-capital-allocation-analyst
JSDoc alignmentphoenix-docs-syncphoenix-docs-scribe

Phase 1B: Semantic Validation

Goal: Core calculation correctness

TaskSkillAgent
Waterfall tier/ledgerphoenix-waterfall-ledger-semanticswaterfall-specialist
XIRR/fees parityphoenix-xirr-fees-validatorxirr-fees-validator
Clawback logicphoenix-waterfall-ledger-semanticswaterfall-specialist

Phase 2: Advanced Forecasting

Goal: Probabilistic validation

TaskSkillAgent
Monte Carlophoenix-advanced-forecastingphoenix-probabilistic-engineer
Graduation modelingphoenix-advanced-forecastingphoenix-probabilistic-engineer
Reserve optimizationphoenix-reserves-optimizerphoenix-reserves-optimizer
MOIC forecastingphoenix-advanced-forecastingphoenix-probabilistic-engineer

Phase 3: Brand & Reporting

Goal: Consistent presentation

TaskSkillAgent
Dashboard layoutphoenix-brand-reportingphoenix-brand-reporting-stylist
Report stylingphoenix-brand-reportingphoenix-brand-reporting-stylist
Press On brandingphoenix-brand-reportingphoenix-brand-reporting-stylist

Command Integration

CommandSkill ActivatedWhen to Use
/phoenix-truthphoenix-truth-case-orchestratorRun deterministic suite
/phoenix-phase2phoenix-advanced-forecastingProbabilistic validation
/phoenix-prob-reportphoenix-advanced-forecastingFormat MC results

Common Workflows

Truth Case Failure Investigation

code
1. /phoenix-truth (run suite)
    |
    v
2. Classify failures:
   - Precision drift → phoenix-precision-guard
   - Waterfall semantics → phoenix-waterfall-ledger-semantics
   - XIRR/fees parity → phoenix-xirr-fees-validator
   - Allocation issues → phoenix-capital-exit-investigator
    |
    v
3. Fix with specialist skill
    |
    v
4. /phoenix-truth (verify fix)

New Calculation Implementation

code
1. phoenix-truth-case-orchestrator
   (create truth cases FIRST)
    |
    v
2. Implement calculation
    |
    v
3. Run skill for domain:
   - Waterfall → phoenix-waterfall-ledger-semantics
   - XIRR → phoenix-xirr-fees-validator
   - Reserves → phoenix-reserves-optimizer
    |
    v
4. phoenix-docs-sync
   (align documentation)
    |
    v
5. /phoenix-truth (full validation)

Phase Gate Progression

code
Phase 0 Gate: 100% truth cases passing
    ↓
Phase 1A Gate: Precision issues resolved
    ↓
Phase 1B Gate: Core calculations Excel-parity
    ↓
Phase 2 Gate: Monte Carlo validation stable
    ↓
Phase 3: Brand consistency applied

Skill Selection Matrix

SymptomLikely SkillVerification
"1e-7 tolerance failure"phoenix-precision-guardCheck for parseFloat
"Clawback not applied"phoenix-waterfall-ledger-semanticsReview tier logic
"XIRR doesn't match Excel"phoenix-xirr-fees-validatorCheck Newton-Raphson
"Missing capital flow"phoenix-capital-exit-investigatorTrace provenance
"MC results unstable"phoenix-advanced-forecastingCheck seed handling
"Chart styling wrong"phoenix-brand-reportingReview brand guide

Related Documentation

Related Skills

  • •financial-calc-correctness - Excel parity methodology
  • •statistical-testing - Monte Carlo validation
  • •systematic-debugging - Root cause analysis