CtrlK
BlogDocsLog inGet started
Tessl Logo

enterprise-architecture

This skill should be used when the user asks to 'map business capabilities', 'build a technology radar', 'define architecture governance', 'prioritize strategic initiatives', or mentions capability mapping, DDD domains, ARB, DORA metrics, or target operating model. [EXPLICIT] It generates enterprise architecture alignment artifacts including capability maps, domain decomposition, governance frameworks, technology radars, and strategic initiative roadmaps. [EXPLICIT] Use this skill whenever the user needs to align technology initiatives with business strategy, even if they don't explicitly ask for 'enterprise architecture'. [EXPLICIT]

SKILL.md
Quality
Evals
Security

Enterprise Architecture: Strategy & Portfolio Alignment

Enterprise architecture aligns technology initiatives with business strategy. It defines what capabilities the enterprise needs, what technologies support them, how decisions are governed, and how investments are prioritized. [EXPLICIT]

Principio Rector

Una empresa sin mapa de capacidades es un ejército sin mapa del terreno. La arquitectura enterprise conecta la estrategia de negocio con la tecnología: qué capacidades necesita la empresa, qué tecnología las soporta, cómo se gobierna, y cómo se prioriza la inversión. Sin esta capa, cada equipo optimiza localmente mientras la empresa se fragmenta.

Filosofía de Arquitectura Enterprise

  1. Capacidades > sistemas. Los sistemas cambian; las capacidades del negocio persisten. Se invierte en capacidades, no en tecnología por sí misma. [EXPLICIT]
  2. Radar > mandato. El technology radar guía, no obliga. Los equipos proponen, el ARB valida, el contexto decide. [EXPLICIT]
  3. Gobierno proporcional. Más governance para alto riesgo/costo. Menos para experimentos y innovación. El gobierno habilita, no frena. [EXPLICIT]

Inputs

The user provides an organization or initiative name as $ARGUMENTS. Parse $1 as the enterprise/organization name used throughout all output artifacts. [EXPLICIT]

Parameters:

  • {MODO}: piloto-auto (default) | desatendido | supervisado | paso-a-paso
    • piloto-auto: Auto para capability mapping y radar, HITL para governance decisions y portfolio prioritization. [EXPLICIT]
    • desatendido: Cero interrupciones. Arquitectura enterprise documentada automáticamente. Supuestos documentados. [EXPLICIT]
    • supervisado: Autónomo con checkpoint en domain boundaries y governance framework. [EXPLICIT]
    • paso-a-paso: Confirma cada capability, domain context, radar entry, y initiative. [EXPLICIT]
  • {FORMATO}: markdown (default) | html | dual
  • {VARIANTE}: ejecutiva (~40% — S1 capability map + S3 radar + S5 portfolio) | técnica (full 6 sections, default)

Before generating architecture, detect organizational context:

!find . -name "*.md" -o -name "*.yaml" -o -name "*.json" | head -20

If reference materials exist, load them:

Read ${CLAUDE_SKILL_DIR}/references/enterprise-arch-patterns-1.md
Read ${CLAUDE_SKILL_DIR}/references/enterprise-arch-patterns-2.md

When to Use

  • Aligning initiatives with enterprise strategy and business objectives
  • Evaluating portfolio fit of new projects or acquisitions
  • Establishing architectural governance (principles, standards, review process)
  • Building technology radar to guide decisions across teams
  • Prioritizing initiatives based on business value, cost, risk, alignment
  • Defining capability roadmaps (current state to target state)
  • Designing team topologies and organizational structure to match architecture

When NOT to Use

  • Internal software structure of a single system → software-architecture
  • End-to-end solution design for a business problem → solutions-architecture
  • Infrastructure, compute, and platform design → infrastructure-architecture
  • Build pipelines and supply chain security → devsecops-architecture

Delivery Structure: 6 Sections

S1: Capability Map (Maturity 1-5)

Hierarchical decomposition of business capabilities from strategic to operational level. [EXPLICIT]

Structure:

  • Level 1 (Strategic): Core business capabilities (e.g., "Acquire Customers", "Process Payments")
  • Level 2 (Management): Supporting capabilities (e.g., "Customer Onboarding", "Identity Verification")
  • Level 3 (Operational): Detailed activities (e.g., "Validate ID", "Run Credit Check")

Per capability:

  • Current maturity (1-5): 1=Ad-hoc, 2=Defined, 3=Managed, 4=Optimized, 5=Strategic
  • Target maturity: Where the capability needs to be
  • Gap: Maturity gap and effort to close
  • Ownership: Business unit/team
  • Systems: Applications supporting it
  • Data: Key data entities involved

Key outcomes:

  • Identifies underinvested capabilities (gaps between current and target)
  • Shows capability dependencies (which must improve first)
  • Guides infrastructure and system investment decisions
  • Reveals redundancies (multiple systems doing same thing)

Format: Heat map (capability x maturity x color), dependency matrix

S2: Domain Model (DDD)

Decomposes the enterprise into cohesive domains using Domain-Driven Design principles. [EXPLICIT]

Bounded Contexts:

  • Core Domain: differentiates from competitors (invest heavily)
  • Supporting Domain: necessary but not unique (build or buy selectively)
  • Generic Domain: commoditized (buy, don't build)

Context Mapping:

  • Upstream/Downstream dependencies
  • Shared Kernel (minimize), Anti-Corruption Layer (isolate from legacy)
  • Customer/Supplier (formal contracts between teams)

Domain Ownership:

  • Conway's Law: org structure mirrors system structure
  • Team topologies aligned to domains (stream-aligned, enabling, platform, complicated subsystem)

Key decisions:

  • Granularity: too many contexts = overhead; too few = tight coupling
  • Shared concepts: minimize shared kernel; prefer ACL
  • Team alignment: teams should own contexts end-to-end

S3: Technology Radar (Adopt/Trial/Assess/Hold)

Guides technology adoption across the enterprise (ThoughtWorks-style). [EXPLICIT]

Classification:

  • Adopt: Proven, recommended; invest in new projects
  • Trial: Being evaluated, limited production use; appropriate for small/medium bets
  • Assess: Interesting, no production use yet; keep watching
  • Hold: Avoid in new projects; existing can continue; consider migration plan

Dimensions: Platforms, Languages, Frameworks, Data, Infrastructure, Architectural Patterns, Security & Compliance

Per technology:

  • Status (Adopt/Trial/Assess/Hold), rationale, owner, alternatives, migration path

Principles:

  • Technology decisions serve business goals, not fashionability
  • Limit tech diversity: too many = operational burden
  • Platform team manages adoption process, not mandates
  • Teams can propose new entries with business justification

S4: Architectural Governance (ARB)

Framework for making and enforcing architecture decisions. [EXPLICIT]

Architectural Principles: Long-lived, guide decision-making

  • "Cloud-first: default to cloud; on-prem justified by specific constraints"
  • "API-first: all capabilities exposed via APIs"
  • "Data-driven: all systems expose metrics; decisions based on data"

Standards & Patterns: API design, logging (structured, correlation IDs), deployment (blue-green, canary), database selection criteria

Architecture Review Board (ARB):

  • Composition: CTO, domain architects, lead engineers, ops lead
  • Review criteria: strategic fit, compliance, cost, risk, technology alignment
  • Frequency: monthly or quarterly
  • Escalation: conflicts resolved by CTO/VP Engineering

Approval Process:

  • Threshold: when review required (new service, tech outside radar, >$100k cost)
  • Proposal format: ADR, business case, implementation plan
  • Timeline: 2-week review window
  • Exception handling: emergency path for urgent issues

Compliance & Audit:

  • Regular audits of architecture decisions
  • Technology drift tracking (unauthorized tech in production)
  • Compliance controls mapping (regulations to architecture controls)

S5: Initiative Portfolio

Prioritized list of strategic initiatives aligned with business objectives and capability gaps. [EXPLICIT]

Per initiative:

  • Name & Objective, Business Value, Cost estimate, Risk, Strategic Alignment
  • Capability Mapping (which capabilities it improves)
  • Effort Estimate (t-shirt: S/M/L/XL), Timeline, Dependencies, Success Metrics

Portfolio Analysis:

  • Pareto: 20% of initiatives drive 80% of value
  • Risk vs. Value plot
  • Capacity planning: total effort vs. available capacity
  • Balance: 60% strategic/transformational, 20% operational, 20% technical debt

Principles:

  • Keep portfolio <20 initiatives (focus)
  • Initiatives are living; reprioritize quarterly
  • Portfolio governance ensures alignment and prevents chaos

S6: Target Operating Model (Team Topologies, DORA)

How the organization is structured and operates to deliver and manage architecture. [EXPLICIT]

Organizational Structure (Team Topologies):

  • Stream-aligned teams: own end-to-end capabilities, cross-functional
  • Platform teams: shared infrastructure, tools, standards
  • Enabling teams: help others adopt new ways of working
  • Complicated subsystem teams: specialized experts (ML, security, performance)

Funding Model: Product funding per capability, platform shared budget, CapEx vs. OpEx

Delivery Cadence: Sprint length, release cadence, ceremonies

Decision Rights: Strategic (CTO), Tactical (ARB), Operational (Teams)

Metrics & Accountability:

  • DORA: Deployment frequency, lead time, failure rate, MTTR
  • Business: Revenue per team, cost per transaction, customer satisfaction
  • Capability: Maturity, reliability, performance, security posture

Trade-off Matrix

DecisionEnablesConstrainsWhen to Use
Cloud-FirstScalability, flexibility, innovation speedVendor lock-in, compliance complexity, costDigital-native orgs, variable workloads
Build vs. BuyControl, differentiationHigher cost, longer time-to-marketCore domains, competitive advantage
MicroservicesIndependent scaling, tech diversity, autonomyOps complexity, distributed debuggingLarge teams, high-scale, polyglot
MonolithicSimple operations, single deployment, consistencyTight coupling, hard to scale independentlySmall teams, simple domains
Centralized Data WarehouseSingle source of truth, analytics, governanceETL complexity, latency, tight couplingTraditional BI, regulatory reporting
Decentralized Data LakesAgility, quick onboarding, independent optimizationInconsistency, data quality, governance burdenData science, exploratory analytics
Governance (Heavy)Control, compliance, consistencySlow decisions, innovation risk, frictionRegulated industries, large enterprises
Governance (Light)Speed, innovation, team autonomyChaos, technical debt, inconsistencyStartups, small teams, fast-moving

Assumptions

  • Enterprise strategy and business objectives defined
  • Capability baseline assessed (current maturity levels)
  • Key stakeholders engaged (business, technology, operations)
  • Sufficient lead time for governance and transformation
  • Investment available for strategic initiatives and platform infrastructure

Limits

  • Does not design individual systems (see software-architecture)
  • Does not design end-to-end solutions (see solutions-architecture)
  • Does not design infrastructure topology (see infrastructure-architecture)
  • Does not manage day-to-day delivery (product/engineering management)
  • Governance is advisory; enforcement requires executive sponsorship

Edge Cases

Legacy Enterprise with Technical Debt: Capabilities supported by outdated tech. Modernization competes with new feature development. Prioritize highest-value, lowest-cost improvements; parallel running during transition. [EXPLICIT]

Multi-Geographic or Multi-Regulatory: Different regions have different compliance (GDPR EU, CCPA California). Architecture must accommodate regional customization. Domain model per region, shared kernel for common capabilities. [EXPLICIT]

High-Growth Startup Becoming Enterprise: "Move fast, break things" needs governance. Retrospective capability mapping, gradual governance introduction, strategic initiative prioritization. [EXPLICIT]

Merger or Acquisition: Two enterprises with different architectures, technologies, governance. Capability analysis for synergies, phased integration roadmap, shared platform investments. [EXPLICIT]

Digital Transformation Initiative: High visibility, multiple stakeholders, cross-cutting impact. Clear vision, phased capability evolution, frequent communication, quick wins early. [EXPLICIT]


Validation Gate

Before finalizing delivery, verify:

  • Capability map complete and maturity assessed
  • Domains identified with clear ownership
  • Technology radar guides new investments
  • Governance process defined and understood
  • Initiative portfolio prioritized and funded
  • Operating model aligns org structure with architecture
  • Strategic initiatives on track and delivering value
  • Technology decisions traceable to business objectives
  • Architecture is enabling (not blocking) business agility
  • Enterprise can articulate its technology strategy clearly

Cross-References

  • software-architecture: Receives technology standards and patterns from radar; aligns internal structure with domains
  • solutions-architecture: Uses capability map and domain model for end-to-end solutions
  • infrastructure-architecture: Implements platform recommendations from technology radar and operating model
  • devsecops-architecture: Enforces governance standards and compliance controls in pipeline

Output Format Protocol

FormatDefaultDescription
markdownYesRich Markdown + Mermaid diagrams. Token-efficient.
htmlOn demandBranded HTML (Design System). Visual impact.
dualOn demandBoth formats.

Default output is Markdown with embedded Mermaid diagrams. HTML generation requires explicit {FORMATO}=html parameter. [EXPLICIT]

Output Artifact

Primary: A-03_Enterprise_Architecture_Deep.html — Executive summary, capability map, domain model, technology radar, governance framework, initiative portfolio, target operating model.

Secondary: Capability heat map (PNG/SVG), technology radar visualization, strategic roadmap (Gantt), governance flowchart, metrics dashboard.


Author: toolkit contributors | Last updated: March 18, 2026

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): references/ guías de profundidad (cargar UNA por etapa) · knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · templates/ plantilla de output · assets/ recursos estáticos.

Repository
JaviMontano/claude-plugins
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.