library-fitness-reviewlisted

Trigger a comprehensive whole-corpus library-fitness review with a project-defined catalogue of persona reviewers when a governance/security documentation library undergoes a major change (new domain dir, new document type, multiple governance rule additions, major restructure) or quarterly minimum. Each invocation dispatches a fan-out of independent persona subagents (for example an executive reader, a security practitioner, an auditor, a newcomer) who review every page from a fresh-reader perspective without inheriting maintainer mental models. Catches comprehensibility, usability, logical-structure, standardization, governance/security quality, auditability, maintainability, and reader-experience gaps that per-PR validation sweeps and mechanical audit gates do not detect. Surfaces prioritized recommendations and a discrete remediation backlog the maintainer drives through subsequent PRs.
jposluns/grc_library · ★ 3 · AI & Automation · score 76

Install: claude install-skill jposluns/grc_library

# Library Fitness Review ## Project wiring (the parent library's instantiation; adopters substitute their own) Portable procedure, concrete names. In the parent GRC library this skill runs with: - Persona catalogue and severity model: the activity convention document at `.working/fitness-reviews/README.md` (the persona briefs with per-persona scope and exclusions, the severity-model definitions, the per-run file format, and the operational guidance; the parent catalogue defines ten personas, labelled `A` through `J`). - Run-record path pattern: `.working/fitness-reviews/YYYY-MM-DD-rN.md`, one combined report per run, with `rN` the run ordinal that day. - History register: `.working/fitness-reviews/history.md` (the invocation history table, whose `Personas` column records the personas dispatched, written in the register as `A, B, C, D, E, F, G, H, I, J (all 10)` for a full dispatch, plus the open remediation backlog tracking table). - Remediation-backlog id scheme: `FR-N` (`FR-1`, `FR-2`, ...), carried into TODO entries and referenced from the CHANGELOG entry of each PR that closes an item. - Mechanical baseline command: `tools/run_all_audits.sh`, the parent library's full audit suite. - Citation-accuracy boundary: the corpus Citation Verification Specification (its §14 records that the library does not verify standard content against library interpretation), which bounds what a fitness review judges. An adopting project maps each bullet to its own reco