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

35 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- AUTO-GENERATED from checklist.md.tmpl — do not edit directly -->
<!-- Regenerate: bun run gen:skill-docs -->
## 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 |