Record ReleaseKit adoption review findings
This commit is contained in:
43
docs/roadmap/remediation.md
Normal file
43
docs/roadmap/remediation.md
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
# ReleaseKit Adoption Review Remediation
|
||||||
|
|
||||||
|
Review baseline: `d5f3464`. The release implementation matches the selected
|
||||||
|
architecture; no runtime defect or additional release gate was identified.
|
||||||
|
|
||||||
|
## Finding 1 — Complete Documentation Alignment (P3)
|
||||||
|
|
||||||
|
Two descriptions were left behind during the cutover:
|
||||||
|
|
||||||
|
- `docs/policy/release.md`, under Release Documentation, still says to use the
|
||||||
|
“Promptkit section structure below.” The former fixed-heading structure was
|
||||||
|
removed, and the adopted policy and runbook expressly require no fixed
|
||||||
|
section headings. This reference leaves the note-writing instruction unclear.
|
||||||
|
- `docs/roadmap/releasekit.md` still describes remaining adoption work as
|
||||||
|
pending and integration validation as future work. The implementation plan
|
||||||
|
records completion, and the review verified the assembled workflow.
|
||||||
|
|
||||||
|
Remove the obsolete section-structure instruction while preserving the title,
|
||||||
|
summary, applicable compatibility guidance, and licensing-footer requirements.
|
||||||
|
Update the feature roadmap's implementation status, or retire it together with
|
||||||
|
the completed implementation plan during release preparation and repair links.
|
||||||
|
Do not reintroduce a heading validator or add a publication gate.
|
||||||
|
|
||||||
|
Verification: review the affected descriptions for agreement with the actual
|
||||||
|
profile and runbook, and check changed local links. The disposable fixture
|
||||||
|
already demonstrates acceptance of a note without fixed section headings;
|
||||||
|
these prose corrections do not require repeating the complete Go suite.
|
||||||
|
|
||||||
|
## Review Evidence
|
||||||
|
|
||||||
|
- `python3 scripts/test-release.py` passed: successful annotated publication,
|
||||||
|
one race-enabled suite and additional check, same-Go tool build, unchanged
|
||||||
|
module metadata, failed additional validation preventing publication, and
|
||||||
|
native usage-error classification.
|
||||||
|
- A disposable clone of the review baseline, with only a synthetic release
|
||||||
|
note added, passed `scripts/releasekit.sh check v0.0.0` offline with the real
|
||||||
|
profile: race-enabled tests, full vet, Go formatting, Markdown navigation,
|
||||||
|
module-distribution checks, and the three real consumer examples.
|
||||||
|
- Shell syntax checks passed; the runtime root package's dependency list has
|
||||||
|
no ReleaseKit import. No runtime Go code or module metadata changed during
|
||||||
|
the implementation commits after `1889915`.
|
||||||
|
- No real Promptkit publication was performed. The adopted checks and retired
|
||||||
|
gates match the agreed scope; no substantive contract strengthening was found.
|
||||||
Reference in New Issue
Block a user