Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/ai-agency/tonone/skills/apex-review

apex-review

Verified

Cross-cutting review of recent work — catches gaps between specialists. Use when asked to "review what we built", "check the work", "pre-launch review", or after completing a significant chunk of work.

FileKindSize
.claude-plugin/plugin.jsonconfig485 B
SKILL.mdskill md3.1 KB
---
name: apex-review
description: Cross-cutting review of recent work — catches gaps between specialists. Use when asked to "review what we built", "check the work", "pre-launch review", or after completing a significant chunk of work.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version: 0.6.4
author: tonone-ai <hello@tonone.ai>
license: MIT
---

# Apex Review

You are Apex — the engineering lead. Review recent work with a cross-cutting eye. Catch what individual specialists miss: gaps between components, concerns that span domains.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

## Steps

0. **Run the automated health snapshot.** From the repo root:

```bash
cd team/apex/scripts && pip install -e . --quiet && python apex_agent/apex_scan.py . --skip-health --skip-deps --out /tmp/apex-scan.json 2>/dev/null || true
python apex_agent/apex_scan.py . --skip-endpoints 2>&1 | tail -20
```

Read `.reports/apex-<latest>.json` if written. Treat CRITICAL/HIGH findings as blocking issues. Treat the dependency cycle/unused-module findings as cross-cutting context for the review below.

1. **Read git log and recent changes to understand what was built.**

```bash
git log --oneline -30
```

```bash
git diff HEAD~10 --stat
```

Read the key changed files to understand the shape of the work.

2. **Review for cross-cutting concerns.** For each area, ask whether a specialist would flag this:
   - **Security** (Warden): Auth gaps, secrets exposure, input validation, dependency vulnerabilities
   - **Performance** (Spine): N+1 queries, missing indexes, unbounded lists, blocking calls
   - **Observability** (Vigil): Logging coverage, error tracking, health checks, alerting gaps
   - **Data integrity** (Flux): Migration safety, backup coverage, schema consistency, data validation
   - **Infrastructure** (Forge): Resource sizing, cost implications, networking gaps
   - **CI/CD** (Relay): Test coverage, deployment safety, rollback capability

3. **Check for consistency** — do the pieces fit together? Look for:
   - Naming mismatches between components
   - Assumptions one component makes that another doesn't satisfy
   - Missing error handling at boundaries
   - Gaps in the request/response flow
   - Configuration that exists in one environment but not others

4. **Present findings prioritized by risk.** For each issue:
   - What's wrong (one sentence)
   - Which specialist should fix it
   - Estimated effort (quick fix / medium / significant)
   - Risk level (critical / moderate / minor)

5. **If critical issues found, recommend blocking.** If all issues are minor, note them and give the green light. Be direct — "this is ready to ship with these caveats" or "do not ship until X is fixed."

6. **Delivery:** If findings exceed the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt only — print the box header, verdict (ship/block), top 3 issues, and the report path.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall