Plan Devex Review

Pre-implementation developer-experience review for Codex. Use when a plan is for APIs, CLIs, SDKs, docs, or developer-facing platforms.

mphaxise Updated

File contents

Plan DevEx Review

Use this skill when the product is for developers and the plan should be judged on onboarding, clarity, and time-to-value before implementation starts.

This port is adapted from garrytan/gstack at commit 4d2c8d94d00cc4f4f3d4c26316a4f939ceedc045.

Workflow

  1. Read the plan and identify the target developer persona.
  2. Trace the intended first-run journey:
    • discovery
    • install or setup
    • hello world
    • first real success
  3. Stress-test the plan for:
    • time to first working result
    • documentation clarity
    • API or CLI ergonomics
    • failure handling and error messages
    • magical moment versus tedious setup
  4. Rewrite the plan to reduce friction and expose the real adoption bottlenecks.

Guardrails

  • Do not confuse backend complexity with good developer experience.
  • Prefer concrete journey steps over abstract DX slogans.
  • Name the highest-friction step explicitly.

Outputs

Always include:

  • target developer persona
  • expected hello-world path
  • biggest friction points
  • revised DevEx direction
  • what to test after implementation
  • next 1-3 actions

mphaxise/gstack-port-for-codex/tree/main/skills/plan-devex-review commit daf4d70cd8

Frequently asked questions

npx skillmds@latest add mphaxise/plan-devex-review