Agent skill

phoenix-workflow-orchestrator

Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/nikhillinit/Updog_restore/tree/main/.claude/skills/phoenix-workflow-orchestrator

SKILL.md

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

Skill Phase Primary Use
phoenix-truth-case-orchestrator 0 Run suite, triage failures
phoenix-precision-guard 1A Numeric precision, Decimal.js
phoenix-waterfall-ledger-semantics 1B Waterfall/carry calculations
phoenix-xirr-fees-validator 1B XIRR and fee calculations
phoenix-capital-exit-investigator 1A Capital allocation, recycling
phoenix-docs-sync 1A JSDoc and docs alignment
phoenix-advanced-forecasting 2 Monte Carlo, graduation, MOIC
phoenix-reserves-optimizer 2 Reserve sizing optimization
phoenix-brand-reporting 3 Brand-consistent UI/reports

Decision Tree

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

Task Skill Agent
Run all truth cases phoenix-truth-case-orchestrator phoenix-truth-case-runner
Triage failures phoenix-truth-case-orchestrator phoenix-truth-case-runner
Baseline comparison phoenix-truth-case-orchestrator -

Phase 1A: Precision & Provenance

Goal: Fix precision drift, establish provenance

Task Skill Agent
parseFloat → Decimal.js phoenix-precision-guard phoenix-precision-guardian
Low-confidence modules phoenix-capital-exit-investigator phoenix-capital-allocation-analyst
JSDoc alignment phoenix-docs-sync phoenix-docs-scribe

Phase 1B: Semantic Validation

Goal: Core calculation correctness

Task Skill Agent
Waterfall tier/ledger phoenix-waterfall-ledger-semantics waterfall-specialist
XIRR/fees parity phoenix-xirr-fees-validator xirr-fees-validator
Clawback logic phoenix-waterfall-ledger-semantics waterfall-specialist

Phase 2: Advanced Forecasting

Goal: Probabilistic validation

Task Skill Agent
Monte Carlo phoenix-advanced-forecasting phoenix-probabilistic-engineer
Graduation modeling phoenix-advanced-forecasting phoenix-probabilistic-engineer
Reserve optimization phoenix-reserves-optimizer phoenix-reserves-optimizer
MOIC forecasting phoenix-advanced-forecasting phoenix-probabilistic-engineer

Phase 3: Brand & Reporting

Goal: Consistent presentation

Task Skill Agent
Dashboard layout phoenix-brand-reporting phoenix-brand-reporting-stylist
Report styling phoenix-brand-reporting phoenix-brand-reporting-stylist
Press On branding phoenix-brand-reporting phoenix-brand-reporting-stylist

Command Integration

Command Skill Activated When to Use
/phoenix-truth phoenix-truth-case-orchestrator Run deterministic suite
/phoenix-phase2 phoenix-advanced-forecasting Probabilistic validation
/phoenix-prob-report phoenix-advanced-forecasting Format MC results

Common Workflows

Truth Case Failure Investigation

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

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

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

Symptom Likely Skill Verification
"1e-7 tolerance failure" phoenix-precision-guard Check for parseFloat
"Clawback not applied" phoenix-waterfall-ledger-semantics Review tier logic
"XIRR doesn't match Excel" phoenix-xirr-fees-validator Check Newton-Raphson
"Missing capital flow" phoenix-capital-exit-investigator Trace provenance
"MC results unstable" phoenix-advanced-forecasting Check seed handling
"Chart styling wrong" phoenix-brand-reporting Review brand guide

Related Documentation

  • PHOENIX-AGENTS.md - Agent details
  • execution-plan-v2.34.md - Current plan
  • docs/notebooklm-sources/ - Domain truth (85K words)

Related Skills

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

Expand your agent's capabilities with these related and highly-rated skills.

nikhillinit/Updog_restore

financial-calc-correctness

0 0
Explore
nikhillinit/Updog_restore

statistical-testing

0 0
Explore
nikhillinit/Updog_restore

ui-ux-pro-max

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

0 0
Explore
nikhillinit/Updog_restore

code-reviewer

Comprehensive multi-AI code review system for Python, JavaScript, and TypeScript. Use when reviewing code for quality, security, performance, or best practices. Includes automated analysis scripts, language-specific patterns, and AI collaboration workflows for complex decisions.

0 0
Explore
nikhillinit/Updog_restore

dependency-guardian

Automated dependency management with security scanning, update orchestration, and compatibility validation

0 0
Explore
nikhillinit/Updog_restore

documentation-sync

Detects code/documentation drift, validates examples, generates diagrams, auto-updates documentation

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results