Skip to content

Commit 287c924

Browse files
committed
feat: Add 42 Commons Blueprint patterns (v7 template)
Commons Blueprint: The Living System Specification - 40 new patterns + 2 updated (graduated-sanctions, value-proposition-design) - 9-Layer Architecture: L0 Meta, L1-L6 Anatomy, L7-L9 Physiology - Full v7 frontmatter: context_labels, search_hints, commons_assessment, specification_layer, relationships with weights, graph_garden entities - Composition tree: generalizes_from/specializes_to on all patterns - Zero relationship asymmetries: every enables has a corresponding requires - Contributors: higgerix, cloudsters Layer distribution: L0 Meta: 1 | L1 Ontology: 5 | L2 State: 8 | L3 Authority: 8 L4 Transition: 3 | L5 Verification: 3 | L6 Evolution: 4 L7 Operations: 6 | L8 Sensing: 2 | L9 Feedback: 2 Informed by: Ostrom's 8 Design Principles, Beer's Viable System Model, Alexander's Pattern Language, and the ADR on Pattern Composition & Decomposition as the Generative Engine.
1 parent 9a282d0 commit 287c924

42 files changed

Lines changed: 8473 additions & 180 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

_patterns/adaptive-learning.md

Lines changed: 175 additions & 0 deletions
Large diffs are not rendered by default.

_patterns/alignment-monitoring.md

Lines changed: 241 additions & 0 deletions
Large diffs are not rendered by default.

_patterns/anomaly-response.md

Lines changed: 227 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 170 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,170 @@
1+
---
2+
id: pat_01KHM0E71P5YZXR8P3FMSEA2CM
3+
slug: capability-specification
4+
title: Capability Specification
5+
aliases:
6+
- Capability Modeling
7+
- Business Capability Mapping
8+
- Service Capability Assessment
9+
summary: A pattern for identifying and modeling the abilities a value creation system possesses or needs, independent of how
10+
those abilities are currently implemented.
11+
context_labels:
12+
corporate: Business Capability Map
13+
government: Service Capability Assessment
14+
activist: Movement Capacity Building
15+
tech: Platform Capability Model
16+
community: Community Asset Mapping
17+
ontology:
18+
domain: business
19+
cross_domains:
20+
- technology
21+
- governance
22+
- organization
23+
specification_layer: L2
24+
search_hints:
25+
primary_tension: What We Do vs. What We Can Do
26+
vector_keywords:
27+
- capability
28+
- business architecture
29+
- enterprise architecture
30+
- TOGAF
31+
- value stream
32+
- organization design
33+
- solution architecture
34+
commons_assessment:
35+
stakeholder_architecture: 3
36+
value_creation: 4
37+
resilience: 3
38+
ownership: 2
39+
autonomy: 3
40+
composability: 5
41+
fractal_value: 4
42+
overall_score: 3.43
43+
lifecycle:
44+
usage_stage: design
45+
adoption_stage: mature
46+
status: draft
47+
version: 1.0
48+
confidence: 3
49+
relationships:
50+
enables:
51+
- id: organization-design
52+
weight: 0.9
53+
description: Capabilities define what the organization must be able to do.
54+
- id: solution-architecture
55+
weight: 0.8
56+
description: Capabilities define what solutions must support.
57+
requires:
58+
- id: value-stream-specification
59+
weight: 0.8
60+
description: Value streams define what capabilities are needed.
61+
generalizes_from:
62+
- commons-blueprint
63+
specializes_to:
64+
- solution-architecture
65+
- organization-design
66+
graph_garden:
67+
last_pruned: '2026-02-16'
68+
entities:
69+
- TOGAF
70+
communities:
71+
- governance-and-trust
72+
inferred_links: []
73+
contributors:
74+
- higgerix
75+
- cloudsters
76+
license: CC-BY-SA-4.0
77+
attribution: commons.engineering by cloudsters
78+
provenance:
79+
contributors:
80+
- higgerix
81+
- cloudsters
82+
---
83+
> A pattern for identifying and modeling the abilities a value creation system possesses or needs, independent of how those abilities are currently implemented.
84+
85+
### 1. Context
86+
87+
Any organization, from a multinational corporation to a local community group, is a complex system designed to create value. To do so, it relies on a set of underlying abilities—what it can *do*. These abilities are often implicit, embedded within software applications, team structures, and individual expertise. For instance, the ability to "manage customer relationships" might be partially handled by a CRM system, partially by the sales team's informal networks, and partially by the support desk's ticketing software. As organizations grow and evolve, this ad-hoc implementation of capabilities leads to a tangled web of redundant systems, duplicated effort, and critical gaps. Without a clear, implementation-agnostic inventory of its abilities, an organization cannot effectively align its resources, technology, and structure with its strategic goals. It becomes difficult to answer fundamental questions like: What are we truly good at? Where are we wasting resources on redundant functions? What new abilities must we develop to thrive in the future?
88+
89+
### 2. Problem
90+
91+
> **The core conflict is What We Do vs. What We Can Do.**
92+
93+
This tension manifests through several competing forces that pull an organization in different directions, hindering its ability to adapt and execute its strategy effectively.
94+
95+
1. **Force 1: Solution-Centric vs. Capability-Centric Planning.** Organizations naturally gravitate towards thinking in terms of the concrete tools and systems they have (e.g., "we need a new CRM") rather than the abstract abilities they need to possess (e.g., "we need to improve our ability to manage customer data"). This solution-first mindset leads to a portfolio of disconnected applications and a technology landscape that drives strategy, rather than serving it.
96+
2. **Force 2: Organizational Silos vs. Cross-Functional Value Streams.** Capabilities are rarely confined to a single department. The ability to "fulfill an order" might involve sales, logistics, finance, and customer service. However, organizations are typically structured in vertical silos. This creates a disconnect where no single department owns the end-to-end capability, leading to redundancy, inefficiency, and a fragmented customer experience.
97+
3. **Force 3: Short-Term Operations vs. Long-Term Strategy.** The immediate pressures of day-to-day operations often overshadow the need for strategic planning. Without a stable model of required capabilities, investment decisions are often reactive, driven by the most urgent operational fire rather than a deliberate plan to build the abilities needed for future success. This results in a cycle of short-term fixes that create long-term architectural debt.
98+
99+
### 3. Solution
100+
101+
> **Therefore, create a stable, implementation-agnostic model of the organization's capabilities, and use it as the central artifact for aligning strategy, technology, and organizational design.**
102+
103+
A capability specification, often visualized as a capability map, serves as a blueprint of the organization. It decomposes the enterprise into a set of modular, stable, and clearly defined abilities. Each capability represents *what* the business does, not *how* it does it. For example, a capability is "Process Payments," not "Use Stripe to Process Payments." This abstraction is the key to its power.
104+
105+
By separating the *what* from the *how*, a capability model provides a stable reference point against which to measure change. The need to "Process Payments" will likely exist for the life of the organization, but the specific technologies and teams used to implement it will evolve. This model becomes the bridge connecting strategic intent with operational execution. It allows leaders to:
106+
107+
* **Align Investments:** Analyze which capabilities are most critical to strategic goals and direct funding accordingly.
108+
* **Identify Redundancies:** Map existing applications and teams to the capability model to reveal areas where the same ability is being delivered by multiple, overlapping systems.
109+
* **Analyze Gaps:** Compare the current state of capabilities against the future state required by the strategy, highlighting areas for development and innovation.
110+
111+
```mermaid
112+
graph TD
113+
A[Strategy] -->|Defines| B(Required Capabilities)
114+
B -->|Guides| C{Investment Decisions}
115+
C -->|Fund| D[Projects & Initiatives]
116+
D -->|Build/Improve| E[Solutions & Teams]
117+
E -->|Implement| F(Business Capabilities)
118+
F -->|Enable| G[Value Streams]
119+
G -->|Deliver| H(Value)
120+
F -->|Measured by| B
121+
```
122+
123+
### 4. Implementation
124+
125+
Developing and maintaining a capability specification is an iterative process, not a one-time project. It requires a cross-functional effort involving business and technology stakeholders.
126+
127+
1. **Establish Scope and Governance:** Define the scope of the capability model (e.g., enterprise-wide, a specific business unit). Establish a governance process for how the model will be maintained and updated over time. Assign ownership for the model to a dedicated role, such as an enterprise architect.
128+
2. **Draft the Initial Capability Map:** Start by identifying the highest-level capabilities, often called Level 1 capabilities. These should be stable and represent the core functions of the organization. A common approach is to derive them from the primary value streams. For example, a manufacturing company might have Level 1 capabilities like "Develop Product," "Market & Sell," "Fulfill Orders," and "Manage Customer Service."
129+
3. **Decompose to Lower Levels:** Decompose the Level 1 capabilities into more granular Level 2 and Level 3 capabilities. For example, "Fulfill Orders" might decompose into "Manage Inventory," "Process Shipments," and "Handle Returns." Avoid going too deep; three levels of decomposition are typically sufficient.
130+
4. **Map Implementations:** For each capability in the model, identify the people, processes, and technology that currently implement it. This involves mapping business units, teams, applications, and data sources to the capability hierarchy. This step is crucial for identifying redundancies and assessing the health of the current landscape.
131+
5. **Assess and Prioritize:** Assess each capability against various dimensions, such as its strategic importance, its current performance or maturity, and its cost. This analysis will reveal which capabilities are underperforming, over-funded, or missing entirely. Use this assessment to create a roadmap for investment and improvement.
132+
133+
**Key Considerations:**
134+
* **Business-Led, IT-Supported:** The development of the capability model must be led by business stakeholders to ensure it accurately reflects the needs of the organization. IT plays a critical supporting role in mapping technology and providing architectural guidance.
135+
* **Start Small and Iterate:** Don't try to boil the ocean. Start with a single business unit or value stream and build out the model over time. The goal is to create a useful tool, not a perfect academic exercise.
136+
137+
**Common Pitfalls:**
138+
* **Analysis Paralysis:** Spending too much time debating the perfect hierarchy and naming conventions. The model should be a living artifact that evolves.
139+
* **Solution-Specific Naming:** Defining capabilities in terms of specific software or teams (e.g., "Manage Salesforce Contacts" instead of "Manage Customer Contacts"). This defeats the purpose of an implementation-agnostic model.
140+
* **Lack of Governance:** Creating a capability map as a one-time project and then failing to maintain it. Without ongoing governance, the model will quickly become outdated and irrelevant.
141+
142+
### 5. Consequences
143+
144+
**Benefits:**
145+
* **Improved Strategic Alignment:** Provides a clear line of sight from strategic objectives to the operational capabilities required to achieve them, ensuring that investments are directed towards what matters most.
146+
* **Reduced IT Complexity and Cost:** By identifying redundant applications and systems, organizations can consolidate their IT landscape, leading to significant cost savings and reduced complexity.
147+
* **Increased Business Agility:** A modular, capability-based architecture allows organizations to swap out implementations (e.g., replace an old CRM with a new one) without disrupting the entire business process.
148+
149+
**Liabilities:**
150+
* **Risk of Abstraction:** If not grounded in the reality of how the business operates, the capability model can become an abstract architectural exercise that has little impact on decision-making.
151+
* **Maintenance Overhead:** A capability model is not a static artifact. It requires ongoing effort to keep it up-to-date as the organization and its technology landscape evolve.
152+
153+
**When NOT to use this pattern:**
154+
* For very small or early-stage organizations where the entire business model is in flux and the overhead of creating a formal capability model would outweigh the benefits. In these cases, a lighter-weight approach to strategic planning is more appropriate.
155+
* In highly dynamic and exploratory contexts, such as a skunkworks project or a rapid prototyping initiative, where the focus is on speed of execution and learning, and a formal architectural model would be a hindrance.
156+
157+
### 6. Known Uses
158+
159+
* **The Open Group Architecture Framework (TOGAF):** Capability-Based Planning is a cornerstone of TOGAF, one of the most widely adopted frameworks for enterprise architecture. TOGAF provides a detailed methodology for defining, assessing, and planning the evolution of business capabilities as part of the Architecture Vision and Business Architecture phases. It is used by thousands of organizations worldwide to link IT to business strategy.
160+
* **Berliner Verkehrsbetriebe (BVG):** As Germany's largest public transport company, BVG faced a sprawling and complex IT landscape with over 10,000 applications. By creating a comprehensive business capability map, they were able to rationalize their application portfolio, identify redundancies, and prioritize investments. This capability-driven approach enabled them to modernize their technology stack and improve the efficiency of their operations, ultimately leading to better service for the citizens of Berlin.
161+
* **Large-Scale Mergers and Acquisitions:** During a merger or acquisition, a capability map is an invaluable tool for understanding the overlapping and unique abilities of the two combining organizations. By mapping the capabilities of both companies, leaders can make informed decisions about which systems to keep, which to retire, and how to integrate the two organizations with minimal disruption. This approach helps to accelerate the realization of synergies and avoid the common pitfall of inheriting a tangled and redundant technology landscape.
162+
163+
### 7. Cognitive Era Considerations
164+
165+
The rise of AI and autonomous agents fundamentally changes how organizations think about and manage their capabilities. The capability specification pattern becomes even more critical in this new era, but it also evolves in its application.
166+
167+
* **AI as a Capability Implementation:** AI and machine learning models are no longer just tools; they are implementations of capabilities. An organization's capability map must now include AI-driven abilities, such as "Predict Customer Churn" or "Automate Invoice Processing." This allows for a holistic view of both human and machine capabilities.
168+
* **Automated Capability Discovery:** Agents can be deployed to analyze application logs, process documentation, and communication patterns to automatically discover and map the de facto capabilities of an organization. This bottom-up discovery process can be compared with the top-down, strategically defined capability map to identify discrepancies and "shadow IT" capabilities.
169+
* **Dynamic Capability Orchestration:** In the future, an organization's capabilities may not be static. Autonomous agents could dynamically assemble and orchestrate new capabilities on the fly by combining existing services and AI models in novel ways. The capability specification provides the semantic layer needed for agents to understand what capabilities are available and how they can be composed.
170+
* **New Risks and Ethical Considerations:** As more capabilities are automated, new risks emerge. The capability model must be used to assess the ethical implications and failure modes of AI-driven abilities. For example, a capability for "Automated Candidate Screening" must be carefully scrutinized for bias. The model provides a framework for governing these new types of risk.

0 commit comments

Comments
 (0)