apex-review

Files (1)

• SKILL.md

SKILL.md (first lines)

# apex-review — Decision-Maker Review Layer

> Reviews proposals from the perspective of **top-level organizational decision-makers**, not field practitioners.
> Technically excellent and "this person will approve it" are different things.

**Role distinction from hub-persona-auditor**
- hub-persona-auditor: Validates **reader comprehension** of a finished asset (reading experience)
- apex-review: Evaluates **decision-maker approval likelihood** of a technical proposal (decision-making experience)

---

## Triggers

- `/apex-review`
- "Will this work for the decision-maker?", "Will the CTO approve this?", "What do I need to present to the team lead?"
- "Review from an executive perspective", "Generate presentation slides" (when decision-maker audience is specified)
- When agent-composer identifies a task requiring a decision-maker approval gate
- "Check this before I report to my manager"
- "Does this look convincing?"
- "Find objections they might raise in advance"
- "Review before the executive briefing"
- "Do you think this will pass?"

---

## Built-in Decision-Maker Personas

| Code | Role | Core Evaluation Criteria | Auto-Reject Triggers |
|:---:|---|---|---|
| `CTO` | Chief Technology Officer | Strategic alignment · competitive advantage · tech vision | "Everyone else is already doing this" / "Feels like a personal project" |
| `TD` | Technical Lead / Team Lead | Implementation risk · team capability · operational burden · cost | Vague timelines / conflicts with existing stack |
| `QAL` | QA Lead / Quality Owner | Quality standards · testability · rollback plan · compliance | No validation plan / failure scenarios not documented |
| `CONF` | Conference Organizer / External Reviewer | Novelty · demo-readiness · audience value · reproducibility | Overloaded with internal jargon / demo not possible |

If the user does not specify a target persona, it will be confirmed in Step 0.

---

## Step 0. Receive Topic + Target

If no input is provided:

```
Please provide the apex-review target.

  Proposal summary: (What are you seeking approval for?)
  Target decision-maker: [CTO / TD (Technical Lead) / QAL (QA Lead) / CONF (Conference)] — multiple allowed
  Proposal file: (provide path or paste content if available)
  Output format: [HTML presentation deck (recommended) / Markdown report]
```

If no proposal file is provided, collect content through conversation.

---

## Step 1. Structure the Proposal

Organize the received content into the following slide structure.

```
[S1] One-line thesis      — "What needs to be done and why"
[S2] Current state / problem — What is not working right now
[S3] Proposal             — What changes and how
[S4] Expected outcomes    — Quantified or verifiable change
[S5] Implementation plan  — Phases, timeline, ownership
[S6] Risks + mitigations  — Failure scenarios + rollback
[S7] Requests             — What is needed from the decision-maker
```

If any slide is missing during structuring, request the user to fill it in.

---

## Step 2. Generate HTML Presentation Deck

Generate as `apex_review_deck_YYYYMMDD.html`.

HTML structure rules:
- Each slide = `<section class="slide">` block
- Per slide: title + body + (if applicable) decision-maker attention note
- Navigation: keyboard ←→ or buttons
- Style: clean dark background / large headlines / emphasized key figures

```html
<!-- Slide example -->
<section class="slide">
  <h2>Current State · Problem</h2>
  <p class="body">…</p>
  <aside class="exec-note CTO">CTO attention: …</aside>
</section>
```

Notify the user of the file path after saving.

---

## Step 3. Persona Review

Evaluate the proposal for each target decision-maker.

Output format:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
apex-review — Decision-Maker Review Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[CTO Review]
  Verdict: ✅ Approved / ⚠️ Conditional / ❌ Rejected
  Rationale: …
  Conditions (if conditional): …
  Critical weaknesses: …

[TD Review]
  Verdict: …
  …
```

---

From chrono-meta/forge-harness, MIT.

More from chrono-meta/forge-harness