TODOs & Backlog

TODOs

Standards & Governance

  • Update CLAUDE.md files to reference standards by STD-NNN ID

  • Create compliance automation script (grep for :std-status: Active)

  • Add standards compliance check to pre-commit hook

Project Compliance Remediation

  • Add appendix-issues.adoc + appendix-todos.adoc to 61 partially compliant projects

  • Convert 6 pages-only projects to partial+page (thinkpad-t16g, tmux-config, kora-cli, claude-code-features, local-model-fine-tuning, arch-linux-fresh-setup)

  • Resolve 3 orphaned partial directories (monad-evaluation, monad-sdk, siem-in-house → belong to QRadar project)

  • Convert 25+ PRJ-*.adoc flat files to proper directory projects with partials

Content Quality

  • Audit examples/ directory — verify all 500+ files are actually referenced via include::example$

  • Remove empty partials/patterns/cross-domain/ directory

  • Verify partials/attributes.adoc is included consistently across pages

  • Review portfolio entries for status label consistency (STD-017 controlled vocabulary)

STD-019 Attribute Remediation (Case Studies)

Audit 2026-04-10: 24 case study files have hardcoded IPs/hostnames that should use {attributes} from antora.yml. Top 5 offenders for priority refactoring — also need extraction to partials per STD-001.

  • RCA-2026-03-13-001-wifi-dhcp-failure.adoc — 23 hardcoded IPs, no partials

  • RCA-2026-03-09-001-nm-eaptls-static-ip.adoc — 23 hardcoded IPs, no partials

  • CR-2026-03-04-vyos-bind-dns.adoc — 18 hardcoded IPs, no partials

  • INC-2026-04-06-domus-iot-vpn-connectivity.adoc — 11 hardcoded IPs, 2 partials (partial adoption)

  • CR-2026-04-07-iot-wan-vpn-passthrough.adoc — 9 hardcoded IPs, no partials

Approach: refactor when next referenced, not proactively. Extract content to partials, replace literals with {attributes}. Worklogs are exempt (historical session logs).

Automation

  • Port /session skill to dots-quantum stow package ✅

  • Add nav entries for new cert projects to education nav partial

  • Create make audit-standards target to check compliance

  • Create make audit-projects target to check STD-001 compliance across all projects