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
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
You can design culturally appropriate survey instruments tailored to international development contexts, analyze mixed-methods data by integrating quantitative findings with qualitative insights, and implement robust data quality management systems for your field operations. Claude helps you create survey templates with adaptive logic, develop validation protocols, and produce data quality reports that highlight issues before analysis begins.
by skillslib
You can evaluate whether products are viable remanufacturing candidates by conducting systematic disassembly analysis and identifying recovery opportunities. The skill helps you design efficient remanufacturing workflows, calculate ROI and environmental impact metrics (including embodied energy recovery of 85-90%), and create remanufacturability scorecards that guide design improvements and supply chain decisions.
by skillslib
You can diagnose warehouse bottlenecks using structured data analysis, then generate optimized layouts and flow improvements. The skill models space utilization, labor deployment, and throughput constraints to identify quick wins and long-term improvements, delivering quantified cost savings and performance gains for your specific facility.
by skillslib
You can systematically code qualitative data against your evaluation framework, surface patterns and themes across multiple responses, extract compelling impact stories with supporting evidence, and generate summary matrices that link narrative findings to your outcomes claims. This skill maintains analytical rigor while reducing the 40-60 hours typically spent manually reviewing transcripts and open-ended survey responses per evaluation cycle.
by skillslib
Get complete, ready-to-deploy lead magnets tailored to your ideal customer profile. Claude designs the concept, writes the persuasive copy, builds the email sequences, and creates deployment strategies that attract qualified prospects and build engaged lists fast. You'll capture 3-5x more subscribers with magnetic offers that actually resonate.
by skillslib
You can convert raw discovery call notes into polished, multi-section sales proposals that include executive summaries tailored to buyer personas, needs analysis mapped to your solution architecture, tiered pricing options with competitive positioning, ROI projections with financial justification, and realistic implementation timelines. The skill preserves personalization and strategic positioning while automating structural components, letting you respond to RFPs and time-sensitive opportunities without sacrificing quality or consistency.
by skillslib
This skill generates optimized facility layouts by analyzing material and personnel flow patterns, validating against operational constraints, and comparing multiple design options with quantified metrics. You provide your facility's dimensions, equipment locations, and operational requirements, and Claude produces detailed layouts with flow efficiency scores, space utilization analysis, and cost-benefit comparisons. Each layout option includes specific recommendations for improving throughput, reducing congestion points, and enhancing safety compliance.
by skillslib