Skip to content

feat: /plan-devex-review + /devex-review — DX review skills (v0.15.3.0)#784

Merged
garrytan merged 6 commits intomainfrom
garrytan/plan-devex-review
Apr 3, 2026
Merged

feat: /plan-devex-review + /devex-review — DX review skills (v0.15.3.0)#784
garrytan merged 6 commits intomainfrom
garrytan/plan-devex-review

Conversation

@garrytan
Copy link
Copy Markdown
Owner

@garrytan garrytan commented Apr 3, 2026

Summary

Two new skills for developer experience review, following the plan-design-review / design-review pattern:

New Skills:

  • /plan-devex-review — Plan-stage DX review based on Addy Osmani's framework. Rates 8 dimensions 0-10 (getting started, API/CLI/SDK, errors, docs, upgrades, dev env, community, measurement). Auto-detects product type with applicability gate. Developer empathy simulation. DX scorecard with trend tracking. Conditional Claude Code Skill DX checklist.
  • /devex-review — Live-system DX audit using browse tool. Tests all 8 dimensions aligned with plan-devex-review for boomerang comparison. Each dimension marked TESTED/INFERRED/N-A with evidence.

Infrastructure:

  • {{DX_FRAMEWORK}} resolver — shared compact principles, characteristics, and scoring rubric (~150 lines)
  • DX Hall of Fame reference file — on-demand examples loaded per pass to avoid prompt bloat
  • DX Review row added to review dashboard (review.ts + preamble.ts)

Review pipeline:

  • CEO Review: SCOPE EXPANSION mode, 6 proposals all accepted
  • Eng Review: 1 issue (DRY resolved with resolver), 0 critical gaps
  • Codex Outside Voice: 11 findings, 5 incorporated (score alignment, Pass 9 → appendix, on-demand examples, resolver scoping, missing sub-dimensions)
  • Pre-landing Review: clean, 0 issues

Pre-Landing Review

No issues found.

Test plan

  • bun run gen:skill-docs succeeds (both skills generate)
  • bun run gen:skill-docs --dry-run reports all files FRESH
  • bun test passes (skill validation + version check)

🤖 Generated with Claude Code

garrytan and others added 6 commits April 3, 2026 07:58
New {{DX_FRAMEWORK}} resolver provides compact (~150 lines) shared content
for /plan-devex-review and /devex-review: Addy Osmani's 8 DX principles,
7 characteristics table, 10 cognitive patterns, scoring rubric, and TTHW
benchmarks. Hall of Fame examples loaded on-demand per pass to avoid bloat.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds plan-devex-review and devex-review schema entries to the review
dashboard resolver and placeholder table in the preamble. All existing
SKILL.md files regenerated to include the new DX Review row.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Plan-stage developer experience review. Rates 8 DX dimensions 0-10:
getting started, API/CLI/SDK design, error messages, docs, upgrade path,
dev environment, community, and DX measurement. Includes developer empathy
simulation, auto-detect product type with applicability gate, DX scorecard
with trend tracking, and a conditional Claude Code Skill DX checklist.
Hall of Fame examples loaded on-demand per pass from dx-hall-of-fame.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Live-system developer experience audit using browse tool. Tests all 8
dimensions aligned with /plan-devex-review for boomerang comparison
(plan said 3 min TTHW, reality says 8). Each dimension marked TESTED,
INFERRED, or N/A with evidence. Scope-aware: declares what browse can
and cannot test, falls back to file artifacts for untestable dimensions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

E2E Evals: ✅ PASS

60/60 tests passed | $6.54 total cost | 12 parallel runners

Suite Result Status Cost
e2e-browse 5/5 $0.15
e2e-deploy 6/6 $1.14
e2e-design 3/3 $0.39
e2e-plan 7/7 $1.12
e2e-qa-workflow 3/3 $0.97
e2e-review 6/6 $0.96
e2e-workflow 3/3 $0.36
llm-judge 24/24 $0.48
e2e-qa-workflow 3/3 $0.97

12x ubicloud-standard-2 (Docker: pre-baked toolchain + deps) | wall clock ≈ slowest suite

@garrytan garrytan merged commit be96ff5 into main Apr 3, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant