Architecture Decision Records

Research-backed architectural decisions for the RHEL DevOps Skills CLI. Each ADR corrects assumptions from the original PRD and is supported by external research with authoritative source links.

All ADRs follow the MADR (Markdown Architectural Decision Records) format.

Decision Log

ADR Title Status
001 Adopt Agent Skills Open Standard (SKILL.md) Accepted
002 Target Claude Code and Cursor IDE Accepted
003 Documentation Embedding via references/ Accepted
004 Correct Installation Target Paths Accepted
005 Dual-Mode Installation (Skills + Rules) Accepted
006 Shell Installer Architecture Accepted
007 GitHub Pages Documentation Site Accepted
008 Skill Update Strategy Accepted
009 Community Skill Contributions Accepted
010 Cross-Skill Dependencies Accepted
011 End-to-End Validation and Troubleshooting Accepted
012 Workshop Module Testing Strategy Accepted
013 Refactor Skills for AgnosticD and Validated Patterns Accepted
014 Skill Researcher Workflow Accepted
015 Deployment Pipeline Testing Skills Accepted
016 AgnosticD Hub-Student Topology Skill Accepted
017 VP Submission Skill and Validator Redeploy Gate Accepted

Table of contents