enterprise-patterns

name	enterprise-patterns
description	Apply enterprise architecture patterns for integration and governance
version	2.0.0
sasmp_version	1.3.0
bonded_agent	03-enterprise-architecture
bond_type	PRIMARY_BOND
last_updated	2025-01

Enterprise Patterns Skill

Purpose

Apply enterprise architecture patterns including TOGAF, integration patterns, governance frameworks, and portfolio management for large-scale systems.

---

Parameters

Parameter	Type	Required	Validation	Default
context	string	✅	min: 50 chars	-
pattern_type	enum	⚪	integration|governance|portfolio|togaf	integration
scope	enum	⚪	enterprise|domain|capability	enterprise
current_state	object	⚪	valid JSON	{}
output_format	enum	⚪	pattern|roadmap|governance	pattern

---

Execution Flow

┌──────────────────────────────────────────────────────────┐
│ 1. VALIDATE: Check context and pattern type              │
│ 2. ASSESS: Current state and maturity                    │
│ 3. SELECT: Appropriate enterprise pattern                │
│ 4. APPLY: Pattern to context                             │
│ 5. MAP: To TOGAF phases if applicable                    │
│ 6. ROADMAP: Create transition plan                       │
│ 7. DOCUMENT: Return pattern application                  │
└──────────────────────────────────────────────────────────┘

---

Retry Logic

Error	Retry	Backoff	Max Attempts
VALIDATION_ERROR	No	-	1
PATTERN_MISMATCH	Yes	1s	2
SCOPE_UNCLEAR	Yes	-	2

---

Logging & Observability

log_points:
  - event: pattern_requested
    level: info
    data: [pattern_type, scope]
  - event: pattern_applied
    level: info
    data: [pattern_name, maturity_level]
  - event: roadmap_generated
    level: info
    data: [phases_count, timeline]

metrics:
  - name: patterns_applied
    type: counter
    labels: [pattern_type]
  - name: application_time_ms
    type: histogram
  - name: maturity_score
    type: gauge

---

Error Handling

Error Code	Description	Recovery
E601	Missing enterprise context	Request org structure
E602	Pattern not applicable	Suggest alternatives
E603	Scope too broad	Narrow to domain
E604	TOGAF phase unclear	Clarify ADM phase

---

Unit Test Template

test_cases:
  - name: "Integration pattern selection"
    input:
      context: "E-commerce integrating with ERP for inventory"
      pattern_type: "integration"
      scope: "enterprise"
    expected:
      has_pattern: true
      pattern_includes: ["Event-Driven", "CDC"]
      has_rationale: true

  - name: "Governance model"
    input:
      context: "5 business units, 200+ applications"
      pattern_type: "governance"
    expected:
      has_governance_model: true
      has_decision_rights: true
      has_review_process: true

  - name: "Portfolio rationalization"
    input:
      context: "Legacy modernization initiative"
      pattern_type: "portfolio"
    expected:
      has_time_analysis: true
      categories_include: ["Tolerate", "Invest", "Migrate", "Eliminate"]

---

Troubleshooting

Common Issues

Symptom	Root Cause	Resolution
Pattern mismatch	Wrong scope	Align scope with pattern
Governance ignored	Too rigid	Balance agility/control
Integration sprawl	No strategy	Implement API gateway

Debug Checklist

□ Is enterprise context documented?
□ Is pattern type appropriate?
□ Is scope clearly defined?
□ Are stakeholders identified?
□ Is TOGAF phase mapped?

---

Pattern Catalog

Integration Patterns

Pattern	Use Case
Event-Driven	Loose coupling, async
API Gateway	Centralized entry
Saga	Distributed transactions
CDC	Real-time sync

Governance Models

Model	Use Case
Centralized	Strict standards
Federated	Domain autonomy
Hybrid	Core + flexibility

Portfolio Categories (TIME)

Category	Action
Tolerate	Maintain minimally
Invest	Enhance actively
Migrate	Move to new platform
Eliminate	Sunset/decommission

---

Integration

Component	Trigger	Data Flow
Agent 03	Pattern request	Receives context, returns pattern
Agent 01	Solution alignment	Enterprise constraints

---

Quality Standards

• Standards-based: TOGAF, EIP references
• Practical: Implementable patterns
• Scalable: Supports growth

---

Version History

Version	Date	Changes
2.0.0	2025-01	Production-grade: pattern catalog, TOGAF mapping
1.0.0	2024-12	Initial release