Files
gstack/plan-devex-review/sections/checklist.md
Garry Tanandcapy-ai[bot] bc2ed0cee7 v1.91.114.0 feat(dx): score every error for an AI agent reader (agent-ready error contract + gstack-error-capture) (#3226)
* feat(dx): agent-ready error contract for the DevEx review skills

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* feat(dx): gstack-error-capture runs a CLI with no terminal and prints a redacted record

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* fix(dx): CI-clean fences, runtime-root-safe contract location, path-agnostic launch-check test

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* test(dx): preregistered behavior case for the agent-ready error contract; README skill rows

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* test(dx): grader items come from the contract; paid-file count includes the new case

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* feat(dx): outside DX voice uses the agent-ready contract; DX_CAPTURE_* codes join RESULT_CODES with troubleshooting anchors

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* fix(dx): review fixes for gstack-error-capture and the paid grader

- every helper diagnostic passes the record's redaction, fail-closed
- forwarded values are masked before and after sanitizing, plus JSON-escaped forms
- the final secret check reads the record's string fields with byte-based scan limits
- mise/asdf config, trust and env-loading variables need --pass-env; only data locations pass by default
- launch reports whether the target started; --launch-check's probe result is exit_code
- Step 3 captures --help first; help states the containment lifetime limit
- the paid grader validates the bound result with parseReviewResult

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* fix(dx): mask forwarded values before argument validation; protocol strings never match literals; Step 3 captures stay read-only

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

* v1.91.114.0 feat(dx): score every error for an AI agent reader (agent-ready error contract + gstack-error-capture)

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

---------

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
2026-10-17 02:10:12 +00:00

1.7 KiB
Raw Permalink Blame History

Checklist (runner profile)

DX phase steps and required outputs for bin/gstack-autoplan (unattended or light runs); interactive runs read sections/review-sections.md in full.

Steps

  1. Step 0 complete (persona, narrative, benchmark, magical moment, journey, confusion roleplay); run the DX Trend Check.
  2. Run Passes 1–8 in order: getting started, API/CLI/SDK design, errors and debugging (the agent-ready error contract in Pass 3: CAP4 Critical and CAP6 High findings cap the score at 4 and 6), documentation, upgrade path, environment and tooling, community, measurement. The Appendix applies to Claude Code skills only.
  3. One decision cycle per unresolved finding; then the required outputs below.

Required outputs → producing section

Output Produced by Scope
Developer Persona Card Developer Persona Card dx
Developer Empathy Narrative Developer Empathy Narrative dx
Competitive DX Benchmark Competitive DX Benchmark dx
Magical Moment Specification Magical Moment Specification dx
Developer Journey Map Developer Journey Map dx
First-Time Developer Confusion Report First-Time Developer Confusion Report dx
NOT in scope "NOT in scope" section dx
What already exists "What already exists" section dx
TODOS.md updates TODOS.md updates dx
DX Scorecard DX Scorecard dx
DX Implementation Checklist DX Implementation Checklist dx
Unresolved Decisions Unresolved Decisions dx
Review log row Review Log dx
Next-skill handoff Next Steps — Review Chaining dx