RomanNum3ral
/
gstack
mirror of https://github.com/garrytan/gstack.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gstack/document-release
History
Hermes Agent 1730a06135 feat(document-release): add Diataxis coverage map, diagram drift detection, and docs debt tracking 
Inspired by @doodlestein's documentation-website skill. Three key ideas incorporated:

1. Step 1.5: Coverage Map (Blast-Radius Analysis) — before editing any docs,
   scan the diff for new public surface and assess documentation coverage across
   Diataxis quadrants (reference/how-to/tutorial/explanation). Flags gaps without
   auto-generating content.

2. Architecture diagram drift detection — extracts entity names from ASCII/Mermaid
   diagrams and cross-references against the diff to catch stale diagrams.

3. Enhanced CHANGELOG sell test — Diataxis rubric scoring (0-3) replaces the
   subjective 'would a user want this?' check.

4. Documentation Debt section in PR body — surfaces coverage gaps and diagram
   drift as actionable items for future work.

All changes are audit-only: the skill flags what's missing, never auto-generates
missing documentation pages. Stays in its lane as a post-ship updater.

Co-Authored-By: Hermes Agent <agent@nousresearch.com>
 		2026-05-11 12:07:15 +00:00
..
SKILL.md feat(document-release): add Diataxis coverage map, diagram drift detection, and docs debt tracking 2026-05-11 12:07:15 +00:00
SKILL.md.tmpl feat(document-release): add Diataxis coverage map, diagram drift detection, and docs debt tracking 2026-05-11 12:07:15 +00:00