Enterprise Architecture Decision Documentation
Document architecture decisions with compliance validation and trade-off analysis
What You Can Do
You can generate formally structured Architecture Decision Records (ADRs) that document your architectural choices with stakeholder impact assessment and quantified trade-offs. The skill validates decisions against enterprise compliance frameworks (SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP), analyzes effects across all stakeholders, and produces governance-ready documentation suitable for architecture review boards and strategic planning.
Features
Creates properly formatted decision records following Nygard ADR template with Status, Context, Decision, Consequences, and Alternatives sections
Automatically checks decisions against enterprise compliance frameworks (SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP) and flags regulatory risks
Maps effects across engineering teams, operations, security, compliance, and business stakeholders with severity scoring
Calculates measurable trade-offs using cost models (infrastructure, maintenance, licensing), performance metrics, and risk exposure
Compares rejected options with decision rationale, risk scores, and implementation effort estimates
Identifies architectural dependencies, affected systems, data flows, and rollback complexity for portfolio decisions
Generates implementation roadmaps with milestone definitions, team allocations, and rollback procedures
Creates C-level abstracts highlighting business impact, regulatory implications, and strategic alignment
Example Output
Example 1: Microservices Migration Decision
ADR-042: Adopt Microservices Architecture for Order Processing
Status: Accepted (2026-Q3)
Context:
Monolithic order system hits 500ms response times at 10K RPS. Deployment velocity blocked by coupling. Compliance audits flag single-point-of-failure risks.
Decision:
Migrate to microservices (Order, Payment, Fulfillment, Notification). Kubernetes with event-driven communication.
Consequences:
- Cost: +$45K/month infrastructure, -$200K licensing savings
- Performance: 95th percentile latency 120ms (from 500ms)
- Compliance: Isolated systems simplify audit trails (HIPAA-ready)
- Risk: Distributed complexity, +15% engineering overhead
Stakeholder Impact:
- Platform Engineering: Critical (8-week onboarding, +2 SREs)
- Security: High (enhanced isolation, reduced blast radius)
- Finance: High (+15% OpEx, licensing savings offset)
- Product: High (40% faster feature velocity)
Example 2: Trade-off Quantification Matrix
Decision: PostgreSQL with Sharding vs. MySQL Vertical Scaling vs. Managed Cloud DB
Criteria │ PostgreSQL+Shard │ MySQL Scale-Up │ Cloud Managed
─────────────────────┼──────────────────┼────────────────┼──────────────
Setup Cost │ $12K │ $8K │ $3K
Monthly OpEx │ $15K │ $18K │ $22K
12-Month Total │ $192K │ $224K │ $267K
GDPR Data Residency │ ✓ Full control │ ✓ Full control │ ✗ Vendor risk
Scalability (RPS) │ 100K+ │ 15K max │ Unlimited
Complexity Score │ 7/10 │ 4/10 │ 2/10
Recommendation: PostgreSQL (best compliance + cost balance)
What's Included
- SKILL.md: Complete Architecture Decision Documentation prompt with compliance validation logic, stakeholder mapping frameworks, and trade-off quantification models
- ADR template: Nygard-compliant template with enterprise sections (compliance checklist, stakeholder matrix, cost calculator)
- Compliance checklist: SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP requirements mapped to architectural decision contexts
- Stakeholder impact worksheet: Template for mapping affected parties, severity assessment, and cross-team concerns
- Trade-off quantification framework: Cost model templates, performance metrics, risk exposure scoring, ROI calculator
- Alternative evaluation template: Structured comparison grid for rejected options with rejection rationale
- Dependency mapping tool: Relationship matrix and rollback complexity assessment
- Executive summary template: One-page format for architecture review boards and strategic presentations
Who It's For
- Enterprise Architects — Document architectural decisions with quantified impact for review boards and strategic planning
- Platform/Infrastructure Leaders — Standardize technical decisions across large organizations with compliance governance
- Chief Technology Officers — Create audit trails for regulatory compliance and architectural governance
- Solution Architects — Communicate trade-offs to non-technical stakeholders using impact matrices and cost models
- Compliance and Security Teams — Validate architectural choices against regulatory frameworks before implementation
Best For
- Microservices vs. monolith decisions — Evaluate architectural migration with stakeholder and compliance impact
- Cloud or data residency choices — Document multi-region, hybrid, or on-premise decisions with GDPR/HIPAA validation
- Technology selection decisions — Compare databases, messaging systems, or orchestration platforms with cost and risk models
- Organizational scaling decisions — Map architectural choices that span multiple teams with dependency and learning-curve impact
- Major infrastructure overhauls — Create governance-ready documentation for ERP, data warehouse, or security architecture
- Regulatory compliance architecture — Design systems meeting SOC2, HIPAA, PCI-DSS with documented trade-off analysis
You might also like
You can evaluate unfamiliar locations objectively against your specific production needs—whether that's crane access, parking capacity, noise restrictions, or permit requirements. The skill generates comprehensive scout reports that compare multiple sites using weighted evaluation matrices, flag deal-breakers early, and document infrastructure limitations so your production team makes informed decisions before committing resources to visits.
by skillslib
You'll design robust SCADA system architectures, configure industrial protocols (Modbus, Profibus, OPC-UA, DNP3), and diagnose connectivity and performance issues across distributed control networks. Get step-by-step configuration guidance, integration workflows, and troubleshooting decision trees tailored to your specific hardware and protocol stack.
by skillslib
You can establish systematic color grading workflows that accelerate project delivery, ensure visual consistency across episodes and projects, and maintain broadcast-quality standards. Claude generates reusable templates, quality control checklists, and grading decision frameworks tailored to your project's color science and deliverable requirements.
by skillslib
Use Claude to automate your entire collection workflow, from first touch to recovery, with legally sound escalation protocols. You'll recover more money in less time, reduce bad debt write-offs by 25-40%, and build defensible collection records that withstand legal scrutiny. Claude handles customized demand letters, compliance validation, debtor profiling, and escalation strategies tailored to account age, debtor behavior, and jurisdiction.
by skillslib
You can conduct comprehensive active transportation network audits that identify missing links, connectivity gaps, and underserved communities. Claude helps you prioritize infrastructure investments against limited budgets using equity screening, mode-share modeling, and cost-benefit analysis—producing client-ready documentation and stakeholder presentations that justify infrastructure decisions with quantitative evidence rather than assumptions.
by skillslib
Turn project descriptions, timelines, and structured data into professional draw.io diagrams instantly. You can generate flowcharts, org charts, Gantt charts, swimlane diagrams, and process flows by describing what you need. Claude creates draw.io XML that you can open directly in the editor or modify further.
by skillslib
Generate customized legal documents and client communications automatically from your MyCase case data. This skill extracts case details, client information, and matter status to populate document templates, send email updates, and create batch processing workflows. Reduce manual data entry and standardize your document generation process while maintaining client communication consistency.
by skillslib
This skill helps you troubleshoot Wwise integration issues, diagnose audio performance bottlenecks, and generate comprehensive documentation for interactive audio specifications. You'll get step-by-step fixes for common implementation problems, performance optimization strategies, and best practices for audio systems across different game engines and platforms.
by skillslib