Files
stack/skills/mosaic-board/SKILL.md
Jarvis 774b76447d
Some checks failed
ci/woodpecker/pr/ci Pipeline failed
ci/woodpecker/push/ci Pipeline failed
fix: rename all packages from @mosaic/* to @mosaicstack/*
- Updated all package.json name fields and dependency references
- Updated all TypeScript/JavaScript imports
- Updated .woodpecker/publish.yml filters and registry paths
- Updated tools/install.sh scope default
- Updated .npmrc registry paths (worktree + host)
- Enhanced update-checker.ts with checkForAllUpdates() multi-package support
- Updated CLI update command to show table of all packages
- Added KNOWN_PACKAGES, formatAllPackagesTable, getInstallAllCommand
- Marked checkForUpdate() with @deprecated JSDoc

Closes #391
2026-04-04 21:43:23 -05:00

156 lines
4.9 KiB
Markdown

---
name: mosaic-board
description: 'Run a Board of Directors review on a brief or proposal. CEO, CTO, CFO, and COO personas evaluate strategic, technical, financial, and operational viability. Use when you need a go/no-go decision, strategic review, or multi-perspective evaluation of a plan. Triggers on: board review, evaluate this brief, strategic review, go/no-go, board of directors.'
---
# Mosaic Board of Directors
Run a multi-persona strategic review of a brief, proposal, or plan. Four executive personas independently evaluate, then a synthesis merges their verdicts into a single recommendation.
---
## When to Use
- Evaluating a new feature, product, or architectural decision
- Go/no-go decisions before committing resources
- Strategic review of a PRD or project brief
- Any time you want structured multi-perspective feedback
---
## The Board
| Role | Perspective | Key Question |
| ------- | ------------------------------- | ------------------------------------------ |
| **CEO** | Vision & mission alignment | "Does this serve the mission?" |
| **CTO** | Technical feasibility & risk | "Can we actually build this?" |
| **CFO** | Cost, ROI, budget impact | "What does this cost vs return?" |
| **COO** | Operations, timeline, resources | "What's the timeline and resource impact?" |
---
## How It Works
### Step 1: Identify the Brief
The user provides a brief, PRD, proposal, or describes what they want reviewed. If no written document exists, help them articulate the key points:
- What is being proposed?
- What problem does it solve?
- What are the success criteria?
- What are the known constraints?
### Step 2: Run Individual Reviews
For **each board member**, adopt their persona and evaluate the brief independently. Each review must output:
```json
{
"persona": "CEO|CTO|CFO|COO",
"verdict": "approve|reject|conditional",
"confidence": 0.0-1.0,
"concerns": ["specific concern 1", "specific concern 2"],
"recommendations": ["actionable recommendation 1"],
"key_risks": ["identified risk 1"]
}
```
**Rules for each persona:**
- **CEO**: Focus on strategic alignment, market positioning, user value, mission fit. Ask "why should we do this?" not just "can we?"
- **CTO**: Focus on architecture implications, technical debt, integration complexity, security surface. Be realistic about build effort.
- **CFO**: Focus on cost (compute, human time, opportunity cost), ROI timeline, budget impact. Demand numbers or reasonable estimates.
- **COO**: Focus on timeline, team capacity, operational overhead, maintenance burden, deployment complexity.
### Step 3: Synthesize
Merge all four reviews into a board synthesis:
- **Verdict**: `reject` if ANY member rejects. `conditional` if any member is conditional. `approve` only if all approve.
- **Confidence**: Average of all member confidence scores.
- **Concerns**: Deduplicated union of all concerns.
- **Recommendations**: Deduplicated union of all recommendations.
- **Key Risks**: Deduplicated union of all risks.
### Step 4: Present Results
Format the output as a readable Board Decision document:
```markdown
# Board Decision: [Brief Title]
## Verdict: APPROVED / CONDITIONAL / REJECTED
**Confidence: X.XX**
## Individual Reviews
### CEO — [verdict]
- Concerns: ...
- Recommendations: ...
### CTO — [verdict]
- Concerns: ...
- Recommendations: ...
### CFO — [verdict]
- Concerns: ...
- Recommendations: ...
### COO — [verdict]
- Concerns: ...
- Recommendations: ...
## Synthesis
- Combined concerns: ...
- Combined recommendations: ...
- Key risks: ...
## Next Steps
[Based on verdict — what should happen next]
```
---
## Standalone vs Full Pipeline
This skill works **standalone** — you don't need the full Mosaic Stack or Forge pipeline. Just invoke `/skill:mosaic-board` with any brief or proposal.
When used within the **Forge pipeline** (`@mosaicstack/forge`), the board stage is automated with parallel persona tasks and mechanical synthesis via `board-tasks.ts`.
---
## Board Persona Files
If detailed persona definitions exist at `~/.config/mosaic/forge/agents/board/`, load them for richer persona context. The personas work without these files — the role descriptions above are sufficient for standalone use.
---
## Classification Shortcut
Not every proposal needs a full board review:
- **Strategic** (new features, architecture, integrations, security): Full board review
- **Technical** (refactors, bugfixes, UI tweaks): Skip board — go straight to implementation
- **Hotfix** (urgent patches): Skip board and analysis — just fix it
If the user's request is clearly technical or a hotfix, suggest skipping the board review and proceeding directly.
---
## Save Results
Save the board decision to `docs/board-reviews/` or the project's `.forge/` directory:
```
docs/board-reviews/YYYY-MM-DD-brief-name.md
```
This creates an audit trail of strategic decisions.