diff --git a/crp/cap/ai/architecture/enterprise/ai-operating-model-architecture.meta.yaml b/crp/cap/ai/architecture/enterprise/ai-operating-model-architecture.meta.yaml index 55386c0..1651a59 100644 --- a/crp/cap/ai/architecture/enterprise/ai-operating-model-architecture.meta.yaml +++ b/crp/cap/ai/architecture/enterprise/ai-operating-model-architecture.meta.yaml @@ -1,11 +1,6 @@ id: ai-operating-model-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","togaf-adm-discipline","architecture-decision-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/architecture/governance/ai-evaluation-and-control-architecture.meta.yaml b/crp/cap/ai/architecture/governance/ai-evaluation-and-control-architecture.meta.yaml index 5d84d58..6967164 100644 --- a/crp/cap/ai/architecture/governance/ai-evaluation-and-control-architecture.meta.yaml +++ b/crp/cap/ai/architecture/governance/ai-evaluation-and-control-architecture.meta.yaml @@ -1,11 +1,6 @@ id: ai-evaluation-and-control-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","architecture-decision-rigor","architecture-compliance-review"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/architecture/solution/agentic-solution-architecture.meta.yaml b/crp/cap/ai/architecture/solution/agentic-solution-architecture.meta.yaml index 30e5fae..c48f4da 100644 --- a/crp/cap/ai/architecture/solution/agentic-solution-architecture.meta.yaml +++ b/crp/cap/ai/architecture/solution/agentic-solution-architecture.meta.yaml @@ -1,11 +1,6 @@ id: agentic-solution-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","architecture-decision-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/architecture/solution/grounding-and-context-architecture.meta.yaml b/crp/cap/ai/architecture/solution/grounding-and-context-architecture.meta.yaml index 844d32e..0c7b1f2 100644 --- a/crp/cap/ai/architecture/solution/grounding-and-context-architecture.meta.yaml +++ b/crp/cap/ai/architecture/solution/grounding-and-context-architecture.meta.yaml @@ -1,11 +1,6 @@ id: grounding-and-context-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","architecture-decision-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/architecture/solution/model-selection-and-boundary-fit.meta.yaml b/crp/cap/ai/architecture/solution/model-selection-and-boundary-fit.meta.yaml index 0c0d2fd..118ba62 100644 --- a/crp/cap/ai/architecture/solution/model-selection-and-boundary-fit.meta.yaml +++ b/crp/cap/ai/architecture/solution/model-selection-and-boundary-fit.meta.yaml @@ -1,11 +1,6 @@ id: model-selection-and-boundary-fit version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategic-fit"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/consulting/ai-adoption-roadmapping.meta.yaml b/crp/cap/ai/consulting/ai-adoption-roadmapping.meta.yaml index 16e387e..f785693 100644 --- a/crp/cap/ai/consulting/ai-adoption-roadmapping.meta.yaml +++ b/crp/cap/ai/consulting/ai-adoption-roadmapping.meta.yaml @@ -1,11 +1,6 @@ id: ai-adoption-roadmapping version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","portfolio-prioritization","strategy-narrative-structure"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/consulting/ai-center-of-excellence-design.meta.yaml b/crp/cap/ai/consulting/ai-center-of-excellence-design.meta.yaml index 748f5ca..176a4e9 100644 --- a/crp/cap/ai/consulting/ai-center-of-excellence-design.meta.yaml +++ b/crp/cap/ai/consulting/ai-center-of-excellence-design.meta.yaml @@ -1,11 +1,6 @@ id: ai-center-of-excellence-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","ai-operating-model-architecture","ai-adoption-roadmapping"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/consulting/ai-readiness-assessment.meta.yaml b/crp/cap/ai/consulting/ai-readiness-assessment.meta.yaml index f55966e..6a05fbf 100644 --- a/crp/cap/ai/consulting/ai-readiness-assessment.meta.yaml +++ b/crp/cap/ai/consulting/ai-readiness-assessment.meta.yaml @@ -1,11 +1,6 @@ id: ai-readiness-assessment version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategy-diagnosis","strategic-fit"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/consulting/ai-use-case-framing.meta.yaml b/crp/cap/ai/consulting/ai-use-case-framing.meta.yaml index 887e9b1..a2b584d 100644 --- a/crp/cap/ai/consulting/ai-use-case-framing.meta.yaml +++ b/crp/cap/ai/consulting/ai-use-case-framing.meta.yaml @@ -1,11 +1,6 @@ id: ai-use-case-framing version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategy-diagnosis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/consulting/ai-value-risk-prioritization.meta.yaml b/crp/cap/ai/consulting/ai-value-risk-prioritization.meta.yaml index e0c01e7..ddc60d2 100644 --- a/crp/cap/ai/consulting/ai-value-risk-prioritization.meta.yaml +++ b/crp/cap/ai/consulting/ai-value-risk-prioritization.meta.yaml @@ -1,11 +1,6 @@ id: ai-value-risk-prioritization version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","portfolio-prioritization","strategic-fit"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/agent-loop-and-state-design.meta.yaml b/crp/cap/ai/engineering/agent-loop-and-state-design.meta.yaml index ed8e54d..6d131aa 100644 --- a/crp/cap/ai/engineering/agent-loop-and-state-design.meta.yaml +++ b/crp/cap/ai/engineering/agent-loop-and-state-design.meta.yaml @@ -1,11 +1,6 @@ id: agent-loop-and-state-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","abstraction-boundary-discipline","change-impact-analysis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/context-engineering-discipline.meta.yaml b/crp/cap/ai/engineering/context-engineering-discipline.meta.yaml index 5b4c18e..212796b 100644 --- a/crp/cap/ai/engineering/context-engineering-discipline.meta.yaml +++ b/crp/cap/ai/engineering/context-engineering-discipline.meta.yaml @@ -1,11 +1,6 @@ id: context-engineering-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","clarification-before-guessing"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/evaluation-driven-iteration.meta.yaml b/crp/cap/ai/engineering/evaluation-driven-iteration.meta.yaml index 4375a4b..e03259c 100644 --- a/crp/cap/ai/engineering/evaluation-driven-iteration.meta.yaml +++ b/crp/cap/ai/engineering/evaluation-driven-iteration.meta.yaml @@ -1,11 +1,6 @@ id: evaluation-driven-iteration version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","critical-peer-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/expert-continuity-briefing.meta.yaml b/crp/cap/ai/engineering/expert-continuity-briefing.meta.yaml index b65b6f6..d6fc555 100644 --- a/crp/cap/ai/engineering/expert-continuity-briefing.meta.yaml +++ b/crp/cap/ai/engineering/expert-continuity-briefing.meta.yaml @@ -1,13 +1,16 @@ id: expert-continuity-briefing version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-23T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","statement-extraction-rigor","fact-interpretation-separation"] conflicts: [] do_not_use_when: ["the task is a project or repository reboot handover rather than discussion continuity","simple summarization is sufficient and no receiving expert must continue the work directly"] -distinguish_from: ["statement-extraction-rigor: extracts relevant source statements without building a continuity-ready expert brief","decision-structuring-discipline: structures decision artifacts instead of preserving full discussion continuity","context-engineering-discipline: shapes model context boundaries instead of producing a transfer brief for a receiving expert","project handover protocol/report: governs reboot and repository handover rather than discussion continuity"] +distinguish_from: + - id: statement-extraction-rigor + boundary: "extracts relevant source statements without building a continuity-ready expert brief" + - id: decision-structuring-discipline + boundary: "structures decision artifacts instead of preserving full discussion continuity" + - id: context-engineering-discipline + boundary: "shapes model context boundaries instead of producing a transfer brief for a receiving expert" + - id: project handover protocol/report + boundary: "governs reboot and repository handover rather than discussion continuity" sources: [] diff --git a/crp/cap/ai/engineering/failure-mode-and-guardrail-design.meta.yaml b/crp/cap/ai/engineering/failure-mode-and-guardrail-design.meta.yaml index 1ac3c16..030259b 100644 --- a/crp/cap/ai/engineering/failure-mode-and-guardrail-design.meta.yaml +++ b/crp/cap/ai/engineering/failure-mode-and-guardrail-design.meta.yaml @@ -1,11 +1,6 @@ id: failure-mode-and-guardrail-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","critical-peer-discipline","change-impact-analysis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/prompt-contract-design.meta.yaml b/crp/cap/ai/engineering/prompt-contract-design.meta.yaml index 5664c47..dd0d741 100644 --- a/crp/cap/ai/engineering/prompt-contract-design.meta.yaml +++ b/crp/cap/ai/engineering/prompt-contract-design.meta.yaml @@ -1,11 +1,6 @@ id: prompt-contract-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","interface-contract-first"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/engineering/tool-use-and-action-boundary-design.meta.yaml b/crp/cap/ai/engineering/tool-use-and-action-boundary-design.meta.yaml index 9ce7cdd..4167bff 100644 --- a/crp/cap/ai/engineering/tool-use-and-action-boundary-design.meta.yaml +++ b/crp/cap/ai/engineering/tool-use-and-action-boundary-design.meta.yaml @@ -1,11 +1,6 @@ id: tool-use-and-action-boundary-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","interface-contract-first","change-impact-analysis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/ai/index.md b/crp/cap/ai/index.md index 752dc57..d18e07a 100644 --- a/crp/cap/ai/index.md +++ b/crp/cap/ai/index.md @@ -6,42 +6,42 @@ This index exposes the local capability selection surface for `ai`. ### Enterprise -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-operating-model-architecture` | `ai-operating-model-architecture.md` | Design an explicit AI operating model before scaling ownership, controls, or delivery expectations. | Use when an organization or multi-team initiative needs clear AI roles, lifecycle ownership, and control points. | `[]` | `[decision-gates, togaf-adm-discipline, architecture-decision-rigor]` | `[]` | `[]` | +| `ai-operating-model-architecture` | `ai-operating-model-architecture.md` | Design an explicit AI operating model before scaling ownership, controls, or delivery expectations. | Use when an organization or multi-team initiative needs clear AI roles, lifecycle ownership, and control points. | `[]` | `[]` | `[decision-gates, togaf-adm-discipline, architecture-decision-rigor]` | `[]` | ### Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-evaluation-and-control-architecture` | `ai-evaluation-and-control-architecture.md` | Define how AI behavior is evaluated, monitored, constrained, and interrupted across the runtime lifecycle. | Use when an AI solution needs explicit quality, safety, oversight, or escalation controls. | `[]` | `[decision-gates, architecture-decision-rigor, architecture-compliance-review]` | `[]` | `[]` | +| `ai-evaluation-and-control-architecture` | `ai-evaluation-and-control-architecture.md` | Define how AI behavior is evaluated, monitored, constrained, and interrupted across the runtime lifecycle. | Use when an AI solution needs explicit quality, safety, oversight, or escalation controls. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor, architecture-compliance-review]` | `[]` | ### Solution -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `agentic-solution-architecture` | `agentic-solution-architecture.md` | Decompose agentic solutions into bounded runtime concerns before implementation detail accumulates. | Use when designing or reviewing a system that reasons, invokes tools, persists state, or escalates actions. | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | `[]` | -| `grounding-and-context-architecture` | `grounding-and-context-architecture.md` | Design grounding and context boundaries so generated outputs remain traceable, bounded, and reviewable. | Use when a solution depends on retrieved knowledge, source material, memory, or other contextual inputs. | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | `[]` | -| `model-selection-and-boundary-fit` | `model-selection-and-boundary-fit.md` | Choose model boundaries that fit the actual problem, control needs, and fallback strategy. | Use when deciding whether and how AI capabilities should be introduced into a solution. | `[]` | `[decision-gates, strategic-fit]` | `[]` | `[]` | +| `agentic-solution-architecture` | `agentic-solution-architecture.md` | Decompose agentic solutions into bounded runtime concerns before implementation detail accumulates. | Use when designing or reviewing a system that reasons, invokes tools, persists state, or escalates actions. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | +| `grounding-and-context-architecture` | `grounding-and-context-architecture.md` | Design grounding and context boundaries so generated outputs remain traceable, bounded, and reviewable. | Use when a solution depends on retrieved knowledge, source material, memory, or other contextual inputs. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | +| `model-selection-and-boundary-fit` | `model-selection-and-boundary-fit.md` | Choose model boundaries that fit the actual problem, control needs, and fallback strategy. | Use when deciding whether and how AI capabilities should be introduced into a solution. | `[]` | `[]` | `[decision-gates, strategic-fit]` | `[]` | ## Consulting -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-adoption-roadmapping` | `ai-adoption-roadmapping.md` | Stage AI adoption from pilot to scaled operation with explicit maturity and control gates. | Use when an organization needs a sequenced path from experimentation to governed scale. | `[]` | `[decision-gates, portfolio-prioritization, strategy-narrative-structure]` | `[]` | `[]` | -| `ai-center-of-excellence-design` | `ai-center-of-excellence-design.md` | Design an AI enablement model that scales standards, support, and governance without becoming a delivery bottleneck. | Use when an organization needs a reusable structure for AI enablement across teams or business units. | `[]` | `[decision-gates, ai-operating-model-architecture, ai-adoption-roadmapping]` | `[]` | `[]` | -| `ai-readiness-assessment` | `ai-readiness-assessment.md` | Assess whether an organization or initiative is ready to design, deploy, and control AI responsibly. | Use when deciding whether an AI initiative should start, scale, or pause. | `[]` | `[decision-gates, strategy-diagnosis, strategic-fit]` | `[]` | `[]` | -| `ai-use-case-framing` | `ai-use-case-framing.md` | Frame AI initiatives around concrete problems, outcomes, and constraints before solution design begins. | Use when a team proposes an AI or agentic initiative and the business value or problem boundary is still fluid. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | -| `ai-value-risk-prioritization` | `ai-value-risk-prioritization.md` | Prioritize AI initiatives by balancing value, feasibility, readiness, risk, and control burden. | Use when multiple AI opportunities compete for investment, attention, or implementation capacity. | `[]` | `[decision-gates, portfolio-prioritization, strategic-fit]` | `[]` | `[]` | +| `ai-adoption-roadmapping` | `ai-adoption-roadmapping.md` | Stage AI adoption from pilot to scaled operation with explicit maturity and control gates. | Use when an organization needs a sequenced path from experimentation to governed scale. | `[]` | `[]` | `[decision-gates, portfolio-prioritization, strategy-narrative-structure]` | `[]` | +| `ai-center-of-excellence-design` | `ai-center-of-excellence-design.md` | Design an AI enablement model that scales standards, support, and governance without becoming a delivery bottleneck. | Use when an organization needs a reusable structure for AI enablement across teams or business units. | `[]` | `[]` | `[decision-gates, ai-operating-model-architecture, ai-adoption-roadmapping]` | `[]` | +| `ai-readiness-assessment` | `ai-readiness-assessment.md` | Assess whether an organization or initiative is ready to design, deploy, and control AI responsibly. | Use when deciding whether an AI initiative should start, scale, or pause. | `[]` | `[]` | `[decision-gates, strategy-diagnosis, strategic-fit]` | `[]` | +| `ai-use-case-framing` | `ai-use-case-framing.md` | Frame AI initiatives around concrete problems, outcomes, and constraints before solution design begins. | Use when a team proposes an AI or agentic initiative and the business value or problem boundary is still fluid. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | +| `ai-value-risk-prioritization` | `ai-value-risk-prioritization.md` | Prioritize AI initiatives by balancing value, feasibility, readiness, risk, and control burden. | Use when multiple AI opportunities compete for investment, attention, or implementation capacity. | `[]` | `[]` | `[decision-gates, portfolio-prioritization, strategic-fit]` | `[]` | ## Engineering -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `agent-loop-and-state-design` | `agent-loop-and-state-design.md` | Design agent loops and state transitions so work remains resumable, bounded, and interruptible. | Use when an AI system iterates across planning, tool use, review, or multi-step execution. | `[]` | `[deterministic-reasoning, abstraction-boundary-discipline, change-impact-analysis]` | `[]` | `[]` | -| `context-engineering-discipline` | `context-engineering-discipline.md` | Shape context deliberately so the model receives the right information, in the right form, at the right boundary. | Use when model quality depends on retrieved material, memory, task state, or instruction layering. | `[]` | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | `[]` | -| `evaluation-driven-iteration` | `evaluation-driven-iteration.md` | Improve AI behavior through explicit evaluation evidence rather than taste, anecdotes, or prompt folklore. | Use when changing prompts, context design, workflows, models, or guardrails to improve outcome quality. | `[]` | `[deterministic-reasoning, critical-peer-discipline]` | `[]` | `[]` | -| `expert-continuity-briefing` | `expert-continuity-briefing.md` | Transform a running discussion into a continuity brief that enables another expert or agent to continue the work without material loss of goal, reasoning state, decisions, evidence, or next actions. | Use when an ongoing discussion, advisory thread, or reasoning session must be transferred so another expert can continue without reconstructing the material context from scratch. | the task is a project or repository reboot handover rather than discussion continuity
simple summarization is sufficient and no receiving expert must continue the work directly | `[deterministic-reasoning, statement-extraction-rigor, fact-interpretation-separation]` | `[]` | statement-extraction-rigor: extracts relevant source statements without building a continuity-ready expert brief
decision-structuring-discipline: structures decision artifacts instead of preserving full discussion continuity
context-engineering-discipline: shapes model context boundaries instead of producing a transfer brief for a receiving expert
project handover protocol/report: governs reboot and repository handover rather than discussion continuity | -| `failure-mode-and-guardrail-design` | `failure-mode-and-guardrail-design.md` | Design guardrails from concrete AI failure modes instead of generic caution language. | Use when an AI system can influence decisions, actions, data exposure, or downstream automation. | `[]` | `[deterministic-reasoning, critical-peer-discipline, change-impact-analysis]` | `[]` | `[]` | -| `prompt-contract-design` | `prompt-contract-design.md` | Design prompts and instructions as bounded contracts rather than informal text craft. | Use when stable AI behavior depends on instruction structure, constraint enforcement, or output boundaries. | `[]` | `[deterministic-reasoning, interface-contract-first]` | `[]` | `[]` | -| `tool-use-and-action-boundary-design` | `tool-use-and-action-boundary-design.md` | Separate reasoning from external actions so tool invocation stays controlled, reviewable, and permission-bounded. | Use when an AI system calls tools, writes data, triggers workflows, or acts on external systems. | `[]` | `[deterministic-reasoning, interface-contract-first, change-impact-analysis]` | `[]` | `[]` | +| `agent-loop-and-state-design` | `agent-loop-and-state-design.md` | Design agent loops and state transitions so work remains resumable, bounded, and interruptible. | Use when an AI system iterates across planning, tool use, review, or multi-step execution. | `[]` | `[]` | `[deterministic-reasoning, abstraction-boundary-discipline, change-impact-analysis]` | `[]` | +| `context-engineering-discipline` | `context-engineering-discipline.md` | Shape context deliberately so the model receives the right information, in the right form, at the right boundary. | Use when model quality depends on retrieved material, memory, task state, or instruction layering. | `[]` | `[]` | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | +| `evaluation-driven-iteration` | `evaluation-driven-iteration.md` | Improve AI behavior through explicit evaluation evidence rather than taste, anecdotes, or prompt folklore. | Use when changing prompts, context design, workflows, models, or guardrails to improve outcome quality. | `[]` | `[]` | `[deterministic-reasoning, critical-peer-discipline]` | `[]` | +| `expert-continuity-briefing` | `expert-continuity-briefing.md` | Transform a running discussion into a continuity brief that enables another expert or agent to continue the work without material loss of goal, reasoning state, decisions, evidence, or next actions. | Use when an ongoing discussion, advisory thread, or reasoning session must be transferred so another expert can continue without reconstructing the material context from scratch. | the task is a project or repository reboot handover rather than discussion continuity
simple summarization is sufficient and no receiving expert must continue the work directly | statement-extraction-rigor: extracts relevant source statements without building a continuity-ready expert brief
decision-structuring-discipline: structures decision artifacts instead of preserving full discussion continuity
context-engineering-discipline: shapes model context boundaries instead of producing a transfer brief for a receiving expert
project handover protocol/report: governs reboot and repository handover rather than discussion continuity | `[deterministic-reasoning, statement-extraction-rigor, fact-interpretation-separation]` | `[]` | +| `failure-mode-and-guardrail-design` | `failure-mode-and-guardrail-design.md` | Design guardrails from concrete AI failure modes instead of generic caution language. | Use when an AI system can influence decisions, actions, data exposure, or downstream automation. | `[]` | `[]` | `[deterministic-reasoning, critical-peer-discipline, change-impact-analysis]` | `[]` | +| `prompt-contract-design` | `prompt-contract-design.md` | Design prompts and instructions as bounded contracts rather than informal text craft. | Use when stable AI behavior depends on instruction structure, constraint enforcement, or output boundaries. | `[]` | `[]` | `[deterministic-reasoning, interface-contract-first]` | `[]` | +| `tool-use-and-action-boundary-design` | `tool-use-and-action-boundary-design.md` | Separate reasoning from external actions so tool invocation stays controlled, reviewable, and permission-bounded. | Use when an AI system calls tools, writes data, triggers workflows, or acts on external systems. | `[]` | `[]` | `[deterministic-reasoning, interface-contract-first, change-impact-analysis]` | `[]` | diff --git a/crp/cap/analysis/index.md b/crp/cap/analysis/index.md index 93ac8f9..0ae1be7 100644 --- a/crp/cap/analysis/index.md +++ b/crp/cap/analysis/index.md @@ -4,27 +4,27 @@ This index exposes the local capability selection surface for `analysis`. ## Organization -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `function-deduplication` | `function-deduplication.md` | Remove duplicate function statements without losing meaningful distinctions. | Use when a normalized function set may contain duplicate or near-duplicate function statements. | `[]` | `[function-extraction]` | `[]` | `[]` | -| `function-extraction` | `function-extraction.md` | Extract normalized business or organizational functions from source material. | Use when source material contains business or organizational work statements that must be normalized into functions. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `function-ownership-allocation` | `function-ownership-allocation.md` | Allocate clear accountability for each materially relevant function without collapsing ownership into informal group responsibility. | Use when assigning accountability for materially relevant functions across teams, roles, or organizational units. | `[]` | `[function-extraction]` | `[]` | `[]` | -| `value-stream-organization-design` | `value-stream-organization-design.md` | Design target organizations around end-to-end value flow instead of accidental internal boundaries. | Use when designing or reviewing organizational structures against end-to-end value flow. | `[]` | `[function-extraction, function-deduplication, function-ownership-allocation]` | `[]` | `[]` | +| `function-deduplication` | `function-deduplication.md` | Remove duplicate function statements without losing meaningful distinctions. | Use when a normalized function set may contain duplicate or near-duplicate function statements. | `[]` | `[]` | `[function-extraction]` | `[]` | +| `function-extraction` | `function-extraction.md` | Extract normalized business or organizational functions from source material. | Use when source material contains business or organizational work statements that must be normalized into functions. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `function-ownership-allocation` | `function-ownership-allocation.md` | Allocate clear accountability for each materially relevant function without collapsing ownership into informal group responsibility. | Use when assigning accountability for materially relevant functions across teams, roles, or organizational units. | `[]` | `[]` | `[function-extraction]` | `[]` | +| `value-stream-organization-design` | `value-stream-organization-design.md` | Design target organizations around end-to-end value flow instead of accidental internal boundaries. | Use when designing or reviewing organizational structures against end-to-end value flow. | `[]` | `[]` | `[function-extraction, function-deduplication, function-ownership-allocation]` | `[]` | ## Role Assessment -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `comparison-dimension-discipline` | `comparison-dimension-discipline.md` | Ensure that comparative analysis uses stable, decision-relevant dimensions instead of ad hoc framing. | Use when comparing alternatives, roles, proposals, or candidate options that need a stable evaluation frame. | `[]` | `[statement-extraction-rigor, fact-interpretation-separation]` | `[]` | `[]` | -| `evidence-typing-discipline` | `evidence-typing-discipline.md` | Keep material claims traceable by marking whether they are directly observed or inferred. | Use when materially relevant claims, findings, or recommendations depend on source evidence or observed outputs. | `[]` | `[fact-interpretation-separation]` | `[]` | `[]` | -| `fact-interpretation-separation` | `fact-interpretation-separation.md` | Separate observed statements from inference, synthesis, and judgment. | Use when deriving interpretations, conclusions, or recommendations from source statements or observed evidence. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `statement-extraction-rigor` | `statement-extraction-rigor.md` | Extract all materially relevant statements from source material without collapsing distinct claims. | Use when extracting materially relevant statements from documents, transcripts, requirements, or review artifacts. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | +| `comparison-dimension-discipline` | `comparison-dimension-discipline.md` | Ensure that comparative analysis uses stable, decision-relevant dimensions instead of ad hoc framing. | Use when comparing alternatives, roles, proposals, or candidate options that need a stable evaluation frame. | `[]` | `[]` | `[statement-extraction-rigor, fact-interpretation-separation]` | `[]` | +| `evidence-typing-discipline` | `evidence-typing-discipline.md` | Keep material claims traceable by marking whether they are directly observed or inferred. | Use when materially relevant claims, findings, or recommendations depend on source evidence or observed outputs. | `[]` | `[]` | `[fact-interpretation-separation]` | `[]` | +| `fact-interpretation-separation` | `fact-interpretation-separation.md` | Separate observed statements from inference, synthesis, and judgment. | Use when deriving interpretations, conclusions, or recommendations from source statements or observed evidence. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `statement-extraction-rigor` | `statement-extraction-rigor.md` | Extract all materially relevant statements from source material without collapsing distinct claims. | Use when extracting materially relevant statements from documents, transcripts, requirements, or review artifacts. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | ## Specification -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ambiguity-detection` | `ambiguity-detection.md` | Detect terms or clauses that allow materially different interpretations. | Use when reviewing text, specifications, contracts, or guidance that may allow materially different readings. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `contradiction-detection` | `contradiction-detection.md` | Detect when two statements cannot both be true within the same scope and time frame. | Use when reviewing statements, requirements, or contracts for claims that may not both hold in the same scope and time frame. | `[]` | `[fact-interpretation-separation]` | `[]` | `[]` | -| `overlap-detection` | `overlap-detection.md` | Detect materially relevant duplication of responsibility, output, or control intent. | Use when reviewing responsibilities, outputs, or control boundaries for possible duplication. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `semantic-conflict-detection` | `semantic-conflict-detection.md` | Detect materially incompatible intent, behavior, or governance semantics even when statements are not literally contradictory. | Use when reviewing policies, processes, models, or interfaces that may be materially incompatible without being literally contradictory. | `[]` | `[fact-interpretation-separation, contradiction-detection]` | `[]` | `[]` | +| `ambiguity-detection` | `ambiguity-detection.md` | Detect terms or clauses that allow materially different interpretations. | Use when reviewing text, specifications, contracts, or guidance that may allow materially different readings. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `contradiction-detection` | `contradiction-detection.md` | Detect when two statements cannot both be true within the same scope and time frame. | Use when reviewing statements, requirements, or contracts for claims that may not both hold in the same scope and time frame. | `[]` | `[]` | `[fact-interpretation-separation]` | `[]` | +| `overlap-detection` | `overlap-detection.md` | Detect materially relevant duplication of responsibility, output, or control intent. | Use when reviewing responsibilities, outputs, or control boundaries for possible duplication. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `semantic-conflict-detection` | `semantic-conflict-detection.md` | Detect materially incompatible intent, behavior, or governance semantics even when statements are not literally contradictory. | Use when reviewing policies, processes, models, or interfaces that may be materially incompatible without being literally contradictory. | `[]` | `[]` | `[fact-interpretation-separation, contradiction-detection]` | `[]` | diff --git a/crp/cap/analysis/organization/function-deduplication.meta.yaml b/crp/cap/analysis/organization/function-deduplication.meta.yaml index bafe577..36c97d9 100644 --- a/crp/cap/analysis/organization/function-deduplication.meta.yaml +++ b/crp/cap/analysis/organization/function-deduplication.meta.yaml @@ -1,11 +1,6 @@ id: function-deduplication version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["function-extraction"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/organization/function-extraction.meta.yaml b/crp/cap/analysis/organization/function-extraction.meta.yaml index 2ad82c7..454ab91 100644 --- a/crp/cap/analysis/organization/function-extraction.meta.yaml +++ b/crp/cap/analysis/organization/function-extraction.meta.yaml @@ -1,11 +1,6 @@ id: function-extraction version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["statement-extraction-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/organization/function-ownership-allocation.meta.yaml b/crp/cap/analysis/organization/function-ownership-allocation.meta.yaml index 5cce4b2..1d5057e 100644 --- a/crp/cap/analysis/organization/function-ownership-allocation.meta.yaml +++ b/crp/cap/analysis/organization/function-ownership-allocation.meta.yaml @@ -1,11 +1,6 @@ id: function-ownership-allocation version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["function-extraction"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/organization/value-stream-organization-design.meta.yaml b/crp/cap/analysis/organization/value-stream-organization-design.meta.yaml index b42103f..66c8b68 100644 --- a/crp/cap/analysis/organization/value-stream-organization-design.meta.yaml +++ b/crp/cap/analysis/organization/value-stream-organization-design.meta.yaml @@ -1,11 +1,6 @@ id: value-stream-organization-design version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["function-extraction","function-deduplication","function-ownership-allocation"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/role-assessment/comparison-dimension-discipline.meta.yaml b/crp/cap/analysis/role-assessment/comparison-dimension-discipline.meta.yaml index 4f58f66..6f478a7 100644 --- a/crp/cap/analysis/role-assessment/comparison-dimension-discipline.meta.yaml +++ b/crp/cap/analysis/role-assessment/comparison-dimension-discipline.meta.yaml @@ -1,11 +1,6 @@ id: comparison-dimension-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["statement-extraction-rigor","fact-interpretation-separation"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/role-assessment/evidence-typing-discipline.meta.yaml b/crp/cap/analysis/role-assessment/evidence-typing-discipline.meta.yaml index b1721ab..3a530b6 100644 --- a/crp/cap/analysis/role-assessment/evidence-typing-discipline.meta.yaml +++ b/crp/cap/analysis/role-assessment/evidence-typing-discipline.meta.yaml @@ -1,11 +1,6 @@ id: evidence-typing-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["fact-interpretation-separation"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/role-assessment/fact-interpretation-separation.meta.yaml b/crp/cap/analysis/role-assessment/fact-interpretation-separation.meta.yaml index 30c6d54..d214198 100644 --- a/crp/cap/analysis/role-assessment/fact-interpretation-separation.meta.yaml +++ b/crp/cap/analysis/role-assessment/fact-interpretation-separation.meta.yaml @@ -1,11 +1,6 @@ id: fact-interpretation-separation version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["statement-extraction-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/role-assessment/statement-extraction-rigor.meta.yaml b/crp/cap/analysis/role-assessment/statement-extraction-rigor.meta.yaml index 22a7a5a..1ce16a5 100644 --- a/crp/cap/analysis/role-assessment/statement-extraction-rigor.meta.yaml +++ b/crp/cap/analysis/role-assessment/statement-extraction-rigor.meta.yaml @@ -1,11 +1,6 @@ id: statement-extraction-rigor version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/specification/ambiguity-detection.meta.yaml b/crp/cap/analysis/specification/ambiguity-detection.meta.yaml index 0a82087..ed881d7 100644 --- a/crp/cap/analysis/specification/ambiguity-detection.meta.yaml +++ b/crp/cap/analysis/specification/ambiguity-detection.meta.yaml @@ -1,11 +1,6 @@ id: ambiguity-detection version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["statement-extraction-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/specification/contradiction-detection.meta.yaml b/crp/cap/analysis/specification/contradiction-detection.meta.yaml index 12ead53..c8ffd9e 100644 --- a/crp/cap/analysis/specification/contradiction-detection.meta.yaml +++ b/crp/cap/analysis/specification/contradiction-detection.meta.yaml @@ -1,11 +1,6 @@ id: contradiction-detection version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["fact-interpretation-separation"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/specification/overlap-detection.meta.yaml b/crp/cap/analysis/specification/overlap-detection.meta.yaml index cf44c10..cbf394d 100644 --- a/crp/cap/analysis/specification/overlap-detection.meta.yaml +++ b/crp/cap/analysis/specification/overlap-detection.meta.yaml @@ -1,11 +1,6 @@ id: overlap-detection version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["statement-extraction-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/analysis/specification/semantic-conflict-detection.meta.yaml b/crp/cap/analysis/specification/semantic-conflict-detection.meta.yaml index 174d5d0..4b500ad 100644 --- a/crp/cap/analysis/specification/semantic-conflict-detection.meta.yaml +++ b/crp/cap/analysis/specification/semantic-conflict-detection.meta.yaml @@ -1,11 +1,6 @@ id: semantic-conflict-detection version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["fact-interpretation-separation","contradiction-detection"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/architecture/domain/application-integration-architecture.meta.yaml b/crp/cap/architecture/domain/application-integration-architecture.meta.yaml index a2e8903..14533e8 100644 --- a/crp/cap/architecture/domain/application-integration-architecture.meta.yaml +++ b/crp/cap/architecture/domain/application-integration-architecture.meta.yaml @@ -1,15 +1,16 @@ id: application-integration-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["segment-architecture-stewardship","architecture-decision-rigor"] conflicts: [] do_not_use_when: ["when the problem is primarily data governance or technology platform architecture","when one concrete solution change needs realization governance more than domain architecture"] -distinguish_from: ["data-governance-architecture","technology-platform-architecture","solution-realization-architecture"] +distinguish_from: + - id: data-governance-architecture + boundary: "TBD" + - id: technology-platform-architecture + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Segment Architect (Business and Technical)" organization: "The Open Group" diff --git a/crp/cap/architecture/domain/business-service-architecture.meta.yaml b/crp/cap/architecture/domain/business-service-architecture.meta.yaml index e5c65bb..f7e3440 100644 --- a/crp/cap/architecture/domain/business-service-architecture.meta.yaml +++ b/crp/cap/architecture/domain/business-service-architecture.meta.yaml @@ -1,15 +1,18 @@ id: business-service-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["segment-architecture-stewardship","capability-map-governance"] conflicts: [] do_not_use_when: ["when data, application, or technology-domain concerns dominate the architecture problem","when the task is generic strategic planning without a business-architecture boundary"] -distinguish_from: ["capability-map-governance","data-governance-architecture","application-integration-architecture","technology-platform-architecture"] +distinguish_from: + - id: capability-map-governance + boundary: "TBD" + - id: data-governance-architecture + boundary: "TBD" + - id: application-integration-architecture + boundary: "TBD" + - id: technology-platform-architecture + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Segment Architect (Business and Technical)" organization: "The Open Group" diff --git a/crp/cap/architecture/domain/data-governance-architecture.meta.yaml b/crp/cap/architecture/domain/data-governance-architecture.meta.yaml index afcade2..03a69b8 100644 --- a/crp/cap/architecture/domain/data-governance-architecture.meta.yaml +++ b/crp/cap/architecture/domain/data-governance-architecture.meta.yaml @@ -1,15 +1,16 @@ id: data-governance-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["segment-architecture-stewardship"] conflicts: [] do_not_use_when: ["when the main concern is application-service decomposition rather than data governance and lifecycle control","when the task is low-level schema hygiene without data-landscape architecture implications"] -distinguish_from: ["application-integration-architecture","technology-platform-architecture","domain-modeling-rigor"] +distinguish_from: + - id: application-integration-architecture + boundary: "TBD" + - id: technology-platform-architecture + boundary: "TBD" + - id: domain-modeling-rigor + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Segment Architect (Business and Technical)" organization: "The Open Group" diff --git a/crp/cap/architecture/domain/segment-architecture-stewardship.meta.yaml b/crp/cap/architecture/domain/segment-architecture-stewardship.meta.yaml index 91e1655..d7ffb0f 100644 --- a/crp/cap/architecture/domain/segment-architecture-stewardship.meta.yaml +++ b/crp/cap/architecture/domain/segment-architecture-stewardship.meta.yaml @@ -1,15 +1,16 @@ id: segment-architecture-stewardship version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline","baseline-target-gap-analysis"] conflicts: [] do_not_use_when: ["when the task is enterprise-wide cross-segment integration rather than stewardship of one segment","when the task is detailed realization of one concrete solution rather than segment evolution"] -distinguish_from: ["enterprise-architecture-integration","solution-realization-architecture","capability-map-governance"] +distinguish_from: + - id: enterprise-architecture-integration + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" + - id: capability-map-governance + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Segment Architect (Business and Technical)" organization: "The Open Group" diff --git a/crp/cap/architecture/domain/technology-platform-architecture.meta.yaml b/crp/cap/architecture/domain/technology-platform-architecture.meta.yaml index 836b13a..000111a 100644 --- a/crp/cap/architecture/domain/technology-platform-architecture.meta.yaml +++ b/crp/cap/architecture/domain/technology-platform-architecture.meta.yaml @@ -1,15 +1,16 @@ id: technology-platform-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["segment-architecture-stewardship"] conflicts: [] do_not_use_when: ["when the dominant concern is application-service architecture or data governance rather than platform and infrastructure design","when the task is an operational runbook without architecture-level platform decisions"] -distinguish_from: ["application-integration-architecture","data-governance-architecture","solution-realization-architecture"] +distinguish_from: + - id: application-integration-architecture + boundary: "TBD" + - id: data-governance-architecture + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Segment Architect (Business and Technical)" organization: "The Open Group" diff --git a/crp/cap/architecture/enterprise/architecture-practice-leadership.meta.yaml b/crp/cap/architecture/enterprise/architecture-practice-leadership.meta.yaml index abc18fd..c1918ee 100644 --- a/crp/cap/architecture/enterprise/architecture-practice-leadership.meta.yaml +++ b/crp/cap/architecture/enterprise/architecture-practice-leadership.meta.yaml @@ -1,15 +1,16 @@ id: architecture-practice-leadership version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline","strategic-fit"] conflicts: [] do_not_use_when: ["when the task is detailed segment or solution design rather than architecture-practice leadership","when a conformance verdict is needed rather than leadership, sponsorship, or mandate creation"] -distinguish_from: ["enterprise-architecture-integration","architecture-compliance-review","strategic-fit"] +distinguish_from: + - id: enterprise-architecture-integration + boundary: "TBD" + - id: architecture-compliance-review + boundary: "TBD" + - id: strategic-fit + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Chief Architect" organization: "The Open Group" diff --git a/crp/cap/architecture/enterprise/capability-map-governance.meta.yaml b/crp/cap/architecture/enterprise/capability-map-governance.meta.yaml index a1bcee2..2c0c8fd 100644 --- a/crp/cap/architecture/enterprise/capability-map-governance.meta.yaml +++ b/crp/cap/architecture/enterprise/capability-map-governance.meta.yaml @@ -1,15 +1,14 @@ id: capability-map-governance version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline"] conflicts: [] do_not_use_when: ["when the task is detailed process, org-chart, or application mapping rather than stable capability architecture","when segment or solution realization questions dominate over capability-map control logic"] -distinguish_from: ["business-service-architecture","enterprise-architecture-integration"] +distinguish_from: + - id: business-service-architecture + boundary: "TBD" + - id: enterprise-architecture-integration + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/enterprise/enterprise-architecture-integration.meta.yaml b/crp/cap/architecture/enterprise/enterprise-architecture-integration.meta.yaml index ffd0389..ff951a0 100644 --- a/crp/cap/architecture/enterprise/enterprise-architecture-integration.meta.yaml +++ b/crp/cap/architecture/enterprise/enterprise-architecture-integration.meta.yaml @@ -1,15 +1,16 @@ id: enterprise-architecture-integration version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline","capability-map-governance"] conflicts: [] do_not_use_when: ["when scope is only one segment or one concrete solution","when the main need is executive sponsorship and practice mandate rather than enterprise integration"] -distinguish_from: ["architecture-practice-leadership","segment-architecture-stewardship","transition-architecture-planning"] +distinguish_from: + - id: architecture-practice-leadership + boundary: "TBD" + - id: segment-architecture-stewardship + boundary: "TBD" + - id: transition-architecture-planning + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Enterprise Architect" organization: "The Open Group" diff --git a/crp/cap/architecture/enterprise/togaf-adm-discipline.meta.yaml b/crp/cap/architecture/enterprise/togaf-adm-discipline.meta.yaml index c320c52..9c0dc7b 100644 --- a/crp/cap/architecture/enterprise/togaf-adm-discipline.meta.yaml +++ b/crp/cap/architecture/enterprise/togaf-adm-discipline.meta.yaml @@ -1,15 +1,14 @@ id: togaf-adm-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates"] conflicts: [] do_not_use_when: ["when the task is a local modeling or compliance question that does not depend on TOGAF lifecycle framing","when role-specific architecture leadership or realization design is needed more than phase-aware discipline"] -distinguish_from: ["enterprise-architecture-integration","transition-architecture-planning"] +distinguish_from: + - id: enterprise-architecture-integration + boundary: "TBD" + - id: transition-architecture-planning + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/governance/architecture-compliance-review.meta.yaml b/crp/cap/architecture/governance/architecture-compliance-review.meta.yaml index 7dbdc21..1bd95cf 100644 --- a/crp/cap/architecture/governance/architecture-compliance-review.meta.yaml +++ b/crp/cap/architecture/governance/architecture-compliance-review.meta.yaml @@ -1,15 +1,16 @@ id: architecture-compliance-review version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline","archimate-cross-layer-consistency"] conflicts: [] do_not_use_when: ["when the task is to create architecture direction rather than evaluate conformance against approved principles, standards, or decisions","when no architecture baseline exists to review against"] -distinguish_from: ["architecture-practice-leadership","enterprise-architecture-integration","solution-realization-architecture"] +distinguish_from: + - id: architecture-practice-leadership + boundary: "TBD" + - id: enterprise-architecture-integration + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/index.md b/crp/cap/architecture/index.md index 7e88652..3539bc9 100644 --- a/crp/cap/architecture/index.md +++ b/crp/cap/architecture/index.md @@ -4,40 +4,40 @@ This index exposes the local capability selection surface for `architecture`. ## Domain -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `application-integration-architecture` | `application-integration-architecture.md` | Shape application-domain architecture through explicit service boundaries, interoperability, and application landscape evolution. | Use when a segment or domain architecture task is application-focused and must govern application responsibilities, interfaces, or integration patterns. | when the problem is primarily data governance or technology platform architecture
when one concrete solution change needs realization governance more than domain architecture | `[segment-architecture-stewardship, architecture-decision-rigor]` | `[]` | data-governance-architecture
technology-platform-architecture
solution-realization-architecture | -| `business-service-architecture` | `business-service-architecture.md` | Shape business-domain architecture through explicit capability, service, process, organization, and metric relationships. | Use when a segment or domain architecture task is business-focused and must govern business capabilities and services rather than only technical assets. | when data, application, or technology-domain concerns dominate the architecture problem
when the task is generic strategic planning without a business-architecture boundary | `[segment-architecture-stewardship, capability-map-governance]` | `[]` | capability-map-governance
data-governance-architecture
application-integration-architecture
technology-platform-architecture | -| `data-governance-architecture` | `data-governance-architecture.md` | Shape data-domain architecture through explicit governance, integration, migration, protection, and lifecycle control. | Use when a segment or domain architecture task is data-focused and must govern data ownership, flow, protection, integration, or migration across the landscape. | when the main concern is application-service decomposition rather than data governance and lifecycle control
when the task is low-level schema hygiene without data-landscape architecture implications | `[segment-architecture-stewardship]` | `[]` | application-integration-architecture
technology-platform-architecture
domain-modeling-rigor | -| `segment-architecture-stewardship` | `segment-architecture-stewardship.md` | Shape and govern one business or technical segment as a coherent architecture responsibility instead of a loose collection of systems. | Use when a business or technical segment must be translated from strategy into governed architecture change, policies, standards, and segment evolution. | when the task is enterprise-wide cross-segment integration rather than stewardship of one segment
when the task is detailed realization of one concrete solution rather than segment evolution | `[togaf-adm-discipline, baseline-target-gap-analysis]` | `[]` | enterprise-architecture-integration
solution-realization-architecture
capability-map-governance | -| `technology-platform-architecture` | `technology-platform-architecture.md` | Shape technology-domain architecture through explicit platform, network, device, infrastructure, and interoperability decisions. | Use when a segment or domain architecture task is technology-focused and must govern platform standards, infrastructure boundaries, or technical interoperability. | when the dominant concern is application-service architecture or data governance rather than platform and infrastructure design
when the task is an operational runbook without architecture-level platform decisions | `[segment-architecture-stewardship]` | `[]` | application-integration-architecture
data-governance-architecture
solution-realization-architecture | +| `application-integration-architecture` | `application-integration-architecture.md` | Shape application-domain architecture through explicit service boundaries, interoperability, and application landscape evolution. | Use when a segment or domain architecture task is application-focused and must govern application responsibilities, interfaces, or integration patterns. | when the problem is primarily data governance or technology platform architecture
when one concrete solution change needs realization governance more than domain architecture | data-governance-architecture: TBD
technology-platform-architecture: TBD
solution-realization-architecture: TBD | `[segment-architecture-stewardship, architecture-decision-rigor]` | `[]` | +| `business-service-architecture` | `business-service-architecture.md` | Shape business-domain architecture through explicit capability, service, process, organization, and metric relationships. | Use when a segment or domain architecture task is business-focused and must govern business capabilities and services rather than only technical assets. | when data, application, or technology-domain concerns dominate the architecture problem
when the task is generic strategic planning without a business-architecture boundary | capability-map-governance: TBD
data-governance-architecture: TBD
application-integration-architecture: TBD
technology-platform-architecture: TBD | `[segment-architecture-stewardship, capability-map-governance]` | `[]` | +| `data-governance-architecture` | `data-governance-architecture.md` | Shape data-domain architecture through explicit governance, integration, migration, protection, and lifecycle control. | Use when a segment or domain architecture task is data-focused and must govern data ownership, flow, protection, integration, or migration across the landscape. | when the main concern is application-service decomposition rather than data governance and lifecycle control
when the task is low-level schema hygiene without data-landscape architecture implications | application-integration-architecture: TBD
technology-platform-architecture: TBD
domain-modeling-rigor: TBD | `[segment-architecture-stewardship]` | `[]` | +| `segment-architecture-stewardship` | `segment-architecture-stewardship.md` | Shape and govern one business or technical segment as a coherent architecture responsibility instead of a loose collection of systems. | Use when a business or technical segment must be translated from strategy into governed architecture change, policies, standards, and segment evolution. | when the task is enterprise-wide cross-segment integration rather than stewardship of one segment
when the task is detailed realization of one concrete solution rather than segment evolution | enterprise-architecture-integration: TBD
solution-realization-architecture: TBD
capability-map-governance: TBD | `[togaf-adm-discipline, baseline-target-gap-analysis]` | `[]` | +| `technology-platform-architecture` | `technology-platform-architecture.md` | Shape technology-domain architecture through explicit platform, network, device, infrastructure, and interoperability decisions. | Use when a segment or domain architecture task is technology-focused and must govern platform standards, infrastructure boundaries, or technical interoperability. | when the dominant concern is application-service architecture or data governance rather than platform and infrastructure design
when the task is an operational runbook without architecture-level platform decisions | application-integration-architecture: TBD
data-governance-architecture: TBD
solution-realization-architecture: TBD | `[segment-architecture-stewardship]` | `[]` | ## Enterprise -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `architecture-practice-leadership` | `architecture-practice-leadership.md` | Create the strategic, governance, and sponsorship conditions for an effective architecture practice across the enterprise. | Use when architecture work needs executive alignment, practice leadership, or cross-domain mandate before downstream enterprise, segment, or solution work can succeed. | when the task is detailed segment or solution design rather than architecture-practice leadership
when a conformance verdict is needed rather than leadership, sponsorship, or mandate creation | `[togaf-adm-discipline, strategic-fit]` | `[]` | enterprise-architecture-integration
architecture-compliance-review
strategic-fit | -| `capability-map-governance` | `capability-map-governance.md` | Use capability maps as stable architecture control artifacts rather than as proxies for projects or org charts. | Use when creating, reviewing, or governing capability maps as architecture control artifacts. | when the task is detailed process, org-chart, or application mapping rather than stable capability architecture
when segment or solution realization questions dominate over capability-map control logic | `[togaf-adm-discipline]` | `[]` | business-service-architecture
enterprise-architecture-integration | -| `enterprise-architecture-integration` | `enterprise-architecture-integration.md` | Create enterprise-wide integration, interoperability, governance, and roadmap coherence across multiple architecture segments. | Use when architecture work must align principles, policies, roadmaps, or interoperability across multiple segments instead of one local domain or one solution. | when scope is only one segment or one concrete solution
when the main need is executive sponsorship and practice mandate rather than enterprise integration | `[togaf-adm-discipline, capability-map-governance]` | `[]` | architecture-practice-leadership
segment-architecture-stewardship
transition-architecture-planning | -| `togaf-adm-discipline` | `togaf-adm-discipline.md` | Keep architecture work phase-aware, decision-oriented, and traceable to the intent of TOGAF ADM. | Use when architecture work claims TOGAF alignment or needs phase-aware architecture discipline. | when the task is a local modeling or compliance question that does not depend on TOGAF lifecycle framing
when role-specific architecture leadership or realization design is needed more than phase-aware discipline | `[decision-gates]` | `[]` | enterprise-architecture-integration
transition-architecture-planning | +| `architecture-practice-leadership` | `architecture-practice-leadership.md` | Create the strategic, governance, and sponsorship conditions for an effective architecture practice across the enterprise. | Use when architecture work needs executive alignment, practice leadership, or cross-domain mandate before downstream enterprise, segment, or solution work can succeed. | when the task is detailed segment or solution design rather than architecture-practice leadership
when a conformance verdict is needed rather than leadership, sponsorship, or mandate creation | enterprise-architecture-integration: TBD
architecture-compliance-review: TBD
strategic-fit: TBD | `[togaf-adm-discipline, strategic-fit]` | `[]` | +| `capability-map-governance` | `capability-map-governance.md` | Use capability maps as stable architecture control artifacts rather than as proxies for projects or org charts. | Use when creating, reviewing, or governing capability maps as architecture control artifacts. | when the task is detailed process, org-chart, or application mapping rather than stable capability architecture
when segment or solution realization questions dominate over capability-map control logic | business-service-architecture: TBD
enterprise-architecture-integration: TBD | `[togaf-adm-discipline]` | `[]` | +| `enterprise-architecture-integration` | `enterprise-architecture-integration.md` | Create enterprise-wide integration, interoperability, governance, and roadmap coherence across multiple architecture segments. | Use when architecture work must align principles, policies, roadmaps, or interoperability across multiple segments instead of one local domain or one solution. | when scope is only one segment or one concrete solution
when the main need is executive sponsorship and practice mandate rather than enterprise integration | architecture-practice-leadership: TBD
segment-architecture-stewardship: TBD
transition-architecture-planning: TBD | `[togaf-adm-discipline, capability-map-governance]` | `[]` | +| `togaf-adm-discipline` | `togaf-adm-discipline.md` | Keep architecture work phase-aware, decision-oriented, and traceable to the intent of TOGAF ADM. | Use when architecture work claims TOGAF alignment or needs phase-aware architecture discipline. | when the task is a local modeling or compliance question that does not depend on TOGAF lifecycle framing
when role-specific architecture leadership or realization design is needed more than phase-aware discipline | enterprise-architecture-integration: TBD
transition-architecture-planning: TBD | `[decision-gates]` | `[]` | ## Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `architecture-compliance-review` | `architecture-compliance-review.md` | Review target states and solution directions against architecture principles, standards, and approved decisions. | Use when reviewing target states, architectures, or solution directions against approved architecture principles and standards. | when the task is to create architecture direction rather than evaluate conformance against approved principles, standards, or decisions
when no architecture baseline exists to review against | `[togaf-adm-discipline, archimate-cross-layer-consistency]` | `[]` | architecture-practice-leadership
enterprise-architecture-integration
solution-realization-architecture | +| `architecture-compliance-review` | `architecture-compliance-review.md` | Review target states and solution directions against architecture principles, standards, and approved decisions. | Use when reviewing target states, architectures, or solution directions against approved architecture principles and standards. | when the task is to create architecture direction rather than evaluate conformance against approved principles, standards, or decisions
when no architecture baseline exists to review against | architecture-practice-leadership: TBD
enterprise-architecture-integration: TBD
solution-realization-architecture: TBD | `[togaf-adm-discipline, archimate-cross-layer-consistency]` | `[]` | ## Modeling -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `archimate-cross-layer-consistency` | `archimate-cross-layer-consistency.md` | Keep ArchiMate models consistent across business, application, data, and technology layers. | Use when reviewing ArchiMate models across multiple layers, views, or lifecycle updates. | when the main task is choosing viewpoints rather than validating cross-layer model consistency | `[archimate-viewpoint-selection]` | `[]` | archimate-viewpoint-selection | -| `archimate-viewpoint-selection` | `archimate-viewpoint-selection.md` | Select modeling viewpoints by stakeholder question and decision need, not by template habit. | Use when selecting or reviewing ArchiMate views for stakeholder communication or design decisions. | when the relevant problem is cross-layer inconsistency rather than viewpoint fit for a stakeholder question | `[togaf-adm-discipline]` | `[]` | archimate-cross-layer-consistency | +| `archimate-cross-layer-consistency` | `archimate-cross-layer-consistency.md` | Keep ArchiMate models consistent across business, application, data, and technology layers. | Use when reviewing ArchiMate models across multiple layers, views, or lifecycle updates. | when the main task is choosing viewpoints rather than validating cross-layer model consistency | archimate-viewpoint-selection: TBD | `[archimate-viewpoint-selection]` | `[]` | +| `archimate-viewpoint-selection` | `archimate-viewpoint-selection.md` | Select modeling viewpoints by stakeholder question and decision need, not by template habit. | Use when selecting or reviewing ArchiMate views for stakeholder communication or design decisions. | when the relevant problem is cross-layer inconsistency rather than viewpoint fit for a stakeholder question | archimate-cross-layer-consistency: TBD | `[togaf-adm-discipline]` | `[]` | ## Solution -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `baseline-target-gap-analysis` | `baseline-target-gap-analysis.md` | Make baseline, target, and gap statements comparable before solution design proceeds. | Use when comparing current and target states before solution design or transition planning. | when no baseline or target state can be stated yet
when the main task is sequencing transition states rather than comparing states | `[togaf-adm-discipline]` | `[]` | transition-architecture-planning
solution-realization-architecture | -| `solution-realization-architecture` | `solution-realization-architecture.md` | Shape a concrete solution change into an interoperable topology and implementable transition architecture without losing architectural intent. | Use when a concrete solution must be specified, staged, and governed from requirements through target roadmap and implementation change. | when the task is enterprise or segment governance without a concrete solution scope
when the task is generic project planning or handover without architecture realization content | `[baseline-target-gap-analysis, transition-architecture-planning, architecture-decision-rigor]` | `[]` | segment-architecture-stewardship
transition-architecture-planning
agentic-solution-architecture | -| `transition-architecture-planning` | `transition-architecture-planning.md` | Stage architecture evolution through deliberate intermediate states instead of assuming one-step transformation. | Use when architecture evolution must be staged through deliberate intermediate states. | when baseline and target have not been compared yet
when the task is a single target-state compliance check rather than staged change design | `[baseline-target-gap-analysis]` | `[]` | baseline-target-gap-analysis
solution-realization-architecture | +| `baseline-target-gap-analysis` | `baseline-target-gap-analysis.md` | Make baseline, target, and gap statements comparable before solution design proceeds. | Use when comparing current and target states before solution design or transition planning. | when no baseline or target state can be stated yet
when the main task is sequencing transition states rather than comparing states | transition-architecture-planning: TBD
solution-realization-architecture: TBD | `[togaf-adm-discipline]` | `[]` | +| `solution-realization-architecture` | `solution-realization-architecture.md` | Shape a concrete solution change into an interoperable topology and implementable transition architecture without losing architectural intent. | Use when a concrete solution must be specified, staged, and governed from requirements through target roadmap and implementation change. | when the task is enterprise or segment governance without a concrete solution scope
when the task is generic project planning or handover without architecture realization content | segment-architecture-stewardship: TBD
transition-architecture-planning: TBD
agentic-solution-architecture: TBD | `[baseline-target-gap-analysis, transition-architecture-planning, architecture-decision-rigor]` | `[]` | +| `transition-architecture-planning` | `transition-architecture-planning.md` | Stage architecture evolution through deliberate intermediate states instead of assuming one-step transformation. | Use when architecture evolution must be staged through deliberate intermediate states. | when baseline and target have not been compared yet
when the task is a single target-state compliance check rather than staged change design | baseline-target-gap-analysis: TBD
solution-realization-architecture: TBD | `[baseline-target-gap-analysis]` | `[]` | diff --git a/crp/cap/architecture/modeling/archimate-cross-layer-consistency.meta.yaml b/crp/cap/architecture/modeling/archimate-cross-layer-consistency.meta.yaml index c0ef64e..e3456b5 100644 --- a/crp/cap/architecture/modeling/archimate-cross-layer-consistency.meta.yaml +++ b/crp/cap/architecture/modeling/archimate-cross-layer-consistency.meta.yaml @@ -1,15 +1,12 @@ id: archimate-cross-layer-consistency version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["archimate-viewpoint-selection"] conflicts: [] do_not_use_when: ["when the main task is choosing viewpoints rather than validating cross-layer model consistency"] -distinguish_from: ["archimate-viewpoint-selection"] +distinguish_from: + - id: archimate-viewpoint-selection + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/modeling/archimate-viewpoint-selection.meta.yaml b/crp/cap/architecture/modeling/archimate-viewpoint-selection.meta.yaml index afa9bf1..ecf1663 100644 --- a/crp/cap/architecture/modeling/archimate-viewpoint-selection.meta.yaml +++ b/crp/cap/architecture/modeling/archimate-viewpoint-selection.meta.yaml @@ -1,15 +1,12 @@ id: archimate-viewpoint-selection version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline"] conflicts: [] do_not_use_when: ["when the relevant problem is cross-layer inconsistency rather than viewpoint fit for a stakeholder question"] -distinguish_from: ["archimate-cross-layer-consistency"] +distinguish_from: + - id: archimate-cross-layer-consistency + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/solution/baseline-target-gap-analysis.meta.yaml b/crp/cap/architecture/solution/baseline-target-gap-analysis.meta.yaml index 4750285..bb88dd8 100644 --- a/crp/cap/architecture/solution/baseline-target-gap-analysis.meta.yaml +++ b/crp/cap/architecture/solution/baseline-target-gap-analysis.meta.yaml @@ -1,15 +1,14 @@ id: baseline-target-gap-analysis version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["togaf-adm-discipline"] conflicts: [] do_not_use_when: ["when no baseline or target state can be stated yet","when the main task is sequencing transition states rather than comparing states"] -distinguish_from: ["transition-architecture-planning","solution-realization-architecture"] +distinguish_from: + - id: transition-architecture-planning + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/architecture/solution/solution-realization-architecture.meta.yaml b/crp/cap/architecture/solution/solution-realization-architecture.meta.yaml index 25adada..2fc69a8 100644 --- a/crp/cap/architecture/solution/solution-realization-architecture.meta.yaml +++ b/crp/cap/architecture/solution/solution-realization-architecture.meta.yaml @@ -1,15 +1,16 @@ id: solution-realization-architecture version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["baseline-target-gap-analysis","transition-architecture-planning","architecture-decision-rigor"] conflicts: [] do_not_use_when: ["when the task is enterprise or segment governance without a concrete solution scope","when the task is generic project planning or handover without architecture realization content"] -distinguish_from: ["segment-architecture-stewardship","transition-architecture-planning","agentic-solution-architecture"] +distinguish_from: + - id: segment-architecture-stewardship + boundary: "TBD" + - id: transition-architecture-planning + boundary: "TBD" + - id: agentic-solution-architecture + boundary: "TBD" sources: - title: "Architecture Roles and Skills - Solution Architect" organization: "The Open Group" diff --git a/crp/cap/architecture/solution/transition-architecture-planning.meta.yaml b/crp/cap/architecture/solution/transition-architecture-planning.meta.yaml index 0abe260..2366cf5 100644 --- a/crp/cap/architecture/solution/transition-architecture-planning.meta.yaml +++ b/crp/cap/architecture/solution/transition-architecture-planning.meta.yaml @@ -1,15 +1,14 @@ id: transition-architecture-planning version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["baseline-target-gap-analysis"] conflicts: [] do_not_use_when: ["when baseline and target have not been compared yet","when the task is a single target-state compliance check rather than staged change design"] -distinguish_from: ["baseline-target-gap-analysis","solution-realization-architecture"] +distinguish_from: + - id: baseline-target-gap-analysis + boundary: "TBD" + - id: solution-realization-architecture + boundary: "TBD" sources: - title: "The TOGAF Standard, 10th Edition" organization: "The Open Group" diff --git a/crp/cap/engineering/index.md b/crp/cap/engineering/index.md index 92d8c75..e2033de 100644 --- a/crp/cap/engineering/index.md +++ b/crp/cap/engineering/index.md @@ -4,14 +4,14 @@ This index exposes the local capability selection surface for `engineering`. ## Principles -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `abstraction-boundary-discipline` | `abstraction-boundary-discipline.md` | Align module and service boundaries with change, policy, and responsibility boundaries instead of file convenience. | Use when defining or reviewing module, service, or subsystem boundaries. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `architecture-decision-rigor` | `architecture-decision-rigor.md` | Keep architecture decisions explicit, comparable, and reviewable before they shape the system. | Use when making or reviewing significant architecture decisions. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `change-impact-analysis` | `change-impact-analysis.md` | Make the blast radius of non-trivial changes explicit before implementation commits the system to hidden coupling. | Use when preparing or reviewing non-trivial changes with possible cross-boundary effects. | `[]` | `[architecture-decision-rigor, abstraction-boundary-discipline]` | `[]` | `[]` | -| `composition-over-subtyping` | `composition-over-subtyping.md` | Prefer explicit composition of behavior over deep inheritance or subtype trees. | Use when designing extensible behavior or type relationships. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `domain-modeling-rigor` | `domain-modeling-rigor.md` | Domain concepts must be explicit, stable, and mapped to unambiguous model boundaries. | Use when modeling domain concepts or reviewing domain-facing contracts and APIs. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | -| `functional-error-modeling` | `functional-error-modeling.md` | Error states and optional values must be explicit in domain contracts. | Use when defining or reviewing domain contracts that carry recoverable failures or optional values. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `immutability-by-default` | `immutability-by-default.md` | Keep state transitions explicit and bounded so domain behavior remains predictable and composable. | Use when designing or reviewing stateful domain behavior and mutation boundaries. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `interface-contract-first` | `interface-contract-first.md` | Define semantic boundary contracts before implementation details accumulate around them. | Use when defining or reviewing interface boundaries before implementation details spread. | `[]` | `[domain-modeling-rigor, abstraction-boundary-discipline]` | `[]` | `[]` | -| `side-effect-boundary-discipline` | `side-effect-boundary-discipline.md` | Keep side effects explicit, bounded, and testable. | Use when designing or reviewing IO-heavy logic, process control, or external action boundaries. | `[]` | `[immutability-by-default, functional-error-modeling]` | `[]` | `[]` | +| `abstraction-boundary-discipline` | `abstraction-boundary-discipline.md` | Align module and service boundaries with change, policy, and responsibility boundaries instead of file convenience. | Use when defining or reviewing module, service, or subsystem boundaries. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `architecture-decision-rigor` | `architecture-decision-rigor.md` | Keep architecture decisions explicit, comparable, and reviewable before they shape the system. | Use when making or reviewing significant architecture decisions. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `change-impact-analysis` | `change-impact-analysis.md` | Make the blast radius of non-trivial changes explicit before implementation commits the system to hidden coupling. | Use when preparing or reviewing non-trivial changes with possible cross-boundary effects. | `[]` | `[]` | `[architecture-decision-rigor, abstraction-boundary-discipline]` | `[]` | +| `composition-over-subtyping` | `composition-over-subtyping.md` | Prefer explicit composition of behavior over deep inheritance or subtype trees. | Use when designing extensible behavior or type relationships. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `domain-modeling-rigor` | `domain-modeling-rigor.md` | Domain concepts must be explicit, stable, and mapped to unambiguous model boundaries. | Use when modeling domain concepts or reviewing domain-facing contracts and APIs. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | +| `functional-error-modeling` | `functional-error-modeling.md` | Error states and optional values must be explicit in domain contracts. | Use when defining or reviewing domain contracts that carry recoverable failures or optional values. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `immutability-by-default` | `immutability-by-default.md` | Keep state transitions explicit and bounded so domain behavior remains predictable and composable. | Use when designing or reviewing stateful domain behavior and mutation boundaries. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `interface-contract-first` | `interface-contract-first.md` | Define semantic boundary contracts before implementation details accumulate around them. | Use when defining or reviewing interface boundaries before implementation details spread. | `[]` | `[]` | `[domain-modeling-rigor, abstraction-boundary-discipline]` | `[]` | +| `side-effect-boundary-discipline` | `side-effect-boundary-discipline.md` | Keep side effects explicit, bounded, and testable. | Use when designing or reviewing IO-heavy logic, process control, or external action boundaries. | `[]` | `[]` | `[immutability-by-default, functional-error-modeling]` | `[]` | diff --git a/crp/cap/engineering/principles/abstraction-boundary-discipline.meta.yaml b/crp/cap/engineering/principles/abstraction-boundary-discipline.meta.yaml index 5b2693f..2387add 100644 --- a/crp/cap/engineering/principles/abstraction-boundary-discipline.meta.yaml +++ b/crp/cap/engineering/principles/abstraction-boundary-discipline.meta.yaml @@ -1,11 +1,6 @@ id: abstraction-boundary-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/architecture-decision-rigor.meta.yaml b/crp/cap/engineering/principles/architecture-decision-rigor.meta.yaml index 981660d..4dda16d 100644 --- a/crp/cap/engineering/principles/architecture-decision-rigor.meta.yaml +++ b/crp/cap/engineering/principles/architecture-decision-rigor.meta.yaml @@ -1,11 +1,6 @@ id: architecture-decision-rigor version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/change-impact-analysis.meta.yaml b/crp/cap/engineering/principles/change-impact-analysis.meta.yaml index b369f40..cff615f 100644 --- a/crp/cap/engineering/principles/change-impact-analysis.meta.yaml +++ b/crp/cap/engineering/principles/change-impact-analysis.meta.yaml @@ -1,11 +1,6 @@ id: change-impact-analysis version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["architecture-decision-rigor","abstraction-boundary-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/composition-over-subtyping.meta.yaml b/crp/cap/engineering/principles/composition-over-subtyping.meta.yaml index 8af79fe..499a166 100644 --- a/crp/cap/engineering/principles/composition-over-subtyping.meta.yaml +++ b/crp/cap/engineering/principles/composition-over-subtyping.meta.yaml @@ -1,11 +1,6 @@ id: composition-over-subtyping version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/domain-modeling-rigor.meta.yaml b/crp/cap/engineering/principles/domain-modeling-rigor.meta.yaml index 3b3658a..6a7ed5a 100644 --- a/crp/cap/engineering/principles/domain-modeling-rigor.meta.yaml +++ b/crp/cap/engineering/principles/domain-modeling-rigor.meta.yaml @@ -1,11 +1,6 @@ id: domain-modeling-rigor version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/functional-error-modeling.meta.yaml b/crp/cap/engineering/principles/functional-error-modeling.meta.yaml index 0008a39..467218f 100644 --- a/crp/cap/engineering/principles/functional-error-modeling.meta.yaml +++ b/crp/cap/engineering/principles/functional-error-modeling.meta.yaml @@ -1,11 +1,6 @@ id: functional-error-modeling version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/immutability-by-default.meta.yaml b/crp/cap/engineering/principles/immutability-by-default.meta.yaml index 7966729..3205364 100644 --- a/crp/cap/engineering/principles/immutability-by-default.meta.yaml +++ b/crp/cap/engineering/principles/immutability-by-default.meta.yaml @@ -1,11 +1,6 @@ id: immutability-by-default version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/interface-contract-first.meta.yaml b/crp/cap/engineering/principles/interface-contract-first.meta.yaml index 28e1b5a..700481a 100644 --- a/crp/cap/engineering/principles/interface-contract-first.meta.yaml +++ b/crp/cap/engineering/principles/interface-contract-first.meta.yaml @@ -1,11 +1,6 @@ id: interface-contract-first version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["domain-modeling-rigor","abstraction-boundary-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/engineering/principles/side-effect-boundary-discipline.meta.yaml b/crp/cap/engineering/principles/side-effect-boundary-discipline.meta.yaml index 235e203..63b83da 100644 --- a/crp/cap/engineering/principles/side-effect-boundary-discipline.meta.yaml +++ b/crp/cap/engineering/principles/side-effect-boundary-discipline.meta.yaml @@ -1,11 +1,6 @@ id: side-effect-boundary-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-20T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["immutability-by-default","functional-error-modeling"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/foundation/clarification-before-guessing.meta.yaml b/crp/cap/foundation/clarification-before-guessing.meta.yaml index 10b21b3..00aa46b 100644 --- a/crp/cap/foundation/clarification-before-guessing.meta.yaml +++ b/crp/cap/foundation/clarification-before-guessing.meta.yaml @@ -1,11 +1,6 @@ id: clarification-before-guessing version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/foundation/critical-peer-discipline.meta.yaml b/crp/cap/foundation/critical-peer-discipline.meta.yaml index 8d6c687..991d61b 100644 --- a/crp/cap/foundation/critical-peer-discipline.meta.yaml +++ b/crp/cap/foundation/critical-peer-discipline.meta.yaml @@ -1,11 +1,6 @@ id: critical-peer-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/foundation/deterministic-reasoning.meta.yaml b/crp/cap/foundation/deterministic-reasoning.meta.yaml index cdb9244..85582c3 100644 --- a/crp/cap/foundation/deterministic-reasoning.meta.yaml +++ b/crp/cap/foundation/deterministic-reasoning.meta.yaml @@ -1,11 +1,6 @@ id: deterministic-reasoning version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: [] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/foundation/index.md b/crp/cap/foundation/index.md index 1a92b96..a564c53 100644 --- a/crp/cap/foundation/index.md +++ b/crp/cap/foundation/index.md @@ -2,9 +2,9 @@ This index exposes the local capability selection surface for `foundation`. -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `clarification-before-guessing` | `clarification-before-guessing.md` | Resolve missing or contradictory context through explicit clarification instead of fabricated certainty. | Use when mandatory decision context is missing, contradictory, or underspecified. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | -| `critical-peer-discipline` | `critical-peer-discipline.md` | Act as a rigorous peer that surfaces weak assumptions, material trade-offs, and non-compliant requests instead of passively affirming them. | Use when reviewing requests, proposals, plans, or recommendations for material weakness or non-compliance. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | +| `clarification-before-guessing` | `clarification-before-guessing.md` | Resolve missing or contradictory context through explicit clarification instead of fabricated certainty. | Use when mandatory decision context is missing, contradictory, or underspecified. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | +| `critical-peer-discipline` | `critical-peer-discipline.md` | Act as a rigorous peer that surfaces weak assumptions, material trade-offs, and non-compliant requests instead of passively affirming them. | Use when reviewing requests, proposals, plans, or recommendations for material weakness or non-compliance. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | | `deterministic-reasoning` | `deterministic-reasoning.md` | Keep reasoning explicit, traceable, and stable under incomplete or conflicting context. | Use when reasoning under incomplete, conflicting, or partially evidenced context must remain explicit and stable. | `[]` | `[]` | `[]` | `[]` | -| `task-understanding-confirmation` | `task-understanding-confirmation.md` | Confirm the understood task framing before substantive execution starts so analysis, implementation, or recommendations do not proceed from a misread request. | Use when a new substantive request or a materially reframed task must be confirmed before solution content, analysis, or execution begins. | the interaction already operates inside a confirmed task frame and no material scope change occurred | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | clarification-before-guessing: resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient
interaction-contract: defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate
decision-gates: controls when strategic recommendations may become final and does not confirm task framing before execution | +| `task-understanding-confirmation` | `task-understanding-confirmation.md` | Confirm the understood task framing before substantive execution starts so analysis, implementation, or recommendations do not proceed from a misread request. | Use when a new substantive request or a materially reframed task must be confirmed before solution content, analysis, or execution begins. | the interaction already operates inside a confirmed task frame and no material scope change occurred | clarification-before-guessing: resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient
interaction-contract: defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate
decision-gates: controls when strategic recommendations may become final and does not confirm task framing before execution | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | diff --git a/crp/cap/foundation/task-understanding-confirmation.meta.yaml b/crp/cap/foundation/task-understanding-confirmation.meta.yaml index 69ad6cb..8b6b018 100644 --- a/crp/cap/foundation/task-understanding-confirmation.meta.yaml +++ b/crp/cap/foundation/task-understanding-confirmation.meta.yaml @@ -1,13 +1,14 @@ id: task-understanding-confirmation version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-24T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning","clarification-before-guessing"] conflicts: [] do_not_use_when: ["the interaction already operates inside a confirmed task frame and no material scope change occurred"] -distinguish_from: ["clarification-before-guessing: resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient","interaction-contract: defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate","decision-gates: controls when strategic recommendations may become final and does not confirm task framing before execution"] +distinguish_from: + - id: clarification-before-guessing + boundary: "resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient" + - id: interaction-contract + boundary: "defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate" + - id: decision-gates + boundary: "controls when strategic recommendations may become final and does not confirm task framing before execution" sources: [] diff --git a/crp/cap/index.md b/crp/cap/index.md index 961fa32..91fab66 100644 --- a/crp/cap/index.md +++ b/crp/cap/index.md @@ -16,193 +16,193 @@ It complements the domain-local indexes, which stay focused on composition-orien ##### Enterprise -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-operating-model-architecture` | `ai-operating-model-architecture.md` | Design an explicit AI operating model before scaling ownership, controls, or delivery expectations. | Use when an organization or multi-team initiative needs clear AI roles, lifecycle ownership, and control points. | `[]` | `[decision-gates, togaf-adm-discipline, architecture-decision-rigor]` | `[]` | `[]` | +| `ai-operating-model-architecture` | `ai-operating-model-architecture.md` | Design an explicit AI operating model before scaling ownership, controls, or delivery expectations. | Use when an organization or multi-team initiative needs clear AI roles, lifecycle ownership, and control points. | `[]` | `[]` | `[decision-gates, togaf-adm-discipline, architecture-decision-rigor]` | `[]` | ##### Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-evaluation-and-control-architecture` | `ai-evaluation-and-control-architecture.md` | Define how AI behavior is evaluated, monitored, constrained, and interrupted across the runtime lifecycle. | Use when an AI solution needs explicit quality, safety, oversight, or escalation controls. | `[]` | `[decision-gates, architecture-decision-rigor, architecture-compliance-review]` | `[]` | `[]` | +| `ai-evaluation-and-control-architecture` | `ai-evaluation-and-control-architecture.md` | Define how AI behavior is evaluated, monitored, constrained, and interrupted across the runtime lifecycle. | Use when an AI solution needs explicit quality, safety, oversight, or escalation controls. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor, architecture-compliance-review]` | `[]` | ##### Solution -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `agentic-solution-architecture` | `agentic-solution-architecture.md` | Decompose agentic solutions into bounded runtime concerns before implementation detail accumulates. | Use when designing or reviewing a system that reasons, invokes tools, persists state, or escalates actions. | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | `[]` | -| `grounding-and-context-architecture` | `grounding-and-context-architecture.md` | Design grounding and context boundaries so generated outputs remain traceable, bounded, and reviewable. | Use when a solution depends on retrieved knowledge, source material, memory, or other contextual inputs. | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | `[]` | -| `model-selection-and-boundary-fit` | `model-selection-and-boundary-fit.md` | Choose model boundaries that fit the actual problem, control needs, and fallback strategy. | Use when deciding whether and how AI capabilities should be introduced into a solution. | `[]` | `[decision-gates, strategic-fit]` | `[]` | `[]` | +| `agentic-solution-architecture` | `agentic-solution-architecture.md` | Decompose agentic solutions into bounded runtime concerns before implementation detail accumulates. | Use when designing or reviewing a system that reasons, invokes tools, persists state, or escalates actions. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | +| `grounding-and-context-architecture` | `grounding-and-context-architecture.md` | Design grounding and context boundaries so generated outputs remain traceable, bounded, and reviewable. | Use when a solution depends on retrieved knowledge, source material, memory, or other contextual inputs. | `[]` | `[]` | `[decision-gates, architecture-decision-rigor]` | `[]` | +| `model-selection-and-boundary-fit` | `model-selection-and-boundary-fit.md` | Choose model boundaries that fit the actual problem, control needs, and fallback strategy. | Use when deciding whether and how AI capabilities should be introduced into a solution. | `[]` | `[]` | `[decision-gates, strategic-fit]` | `[]` | #### Consulting -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ai-adoption-roadmapping` | `ai-adoption-roadmapping.md` | Stage AI adoption from pilot to scaled operation with explicit maturity and control gates. | Use when an organization needs a sequenced path from experimentation to governed scale. | `[]` | `[decision-gates, portfolio-prioritization, strategy-narrative-structure]` | `[]` | `[]` | -| `ai-center-of-excellence-design` | `ai-center-of-excellence-design.md` | Design an AI enablement model that scales standards, support, and governance without becoming a delivery bottleneck. | Use when an organization needs a reusable structure for AI enablement across teams or business units. | `[]` | `[decision-gates, ai-operating-model-architecture, ai-adoption-roadmapping]` | `[]` | `[]` | -| `ai-readiness-assessment` | `ai-readiness-assessment.md` | Assess whether an organization or initiative is ready to design, deploy, and control AI responsibly. | Use when deciding whether an AI initiative should start, scale, or pause. | `[]` | `[decision-gates, strategy-diagnosis, strategic-fit]` | `[]` | `[]` | -| `ai-use-case-framing` | `ai-use-case-framing.md` | Frame AI initiatives around concrete problems, outcomes, and constraints before solution design begins. | Use when a team proposes an AI or agentic initiative and the business value or problem boundary is still fluid. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | -| `ai-value-risk-prioritization` | `ai-value-risk-prioritization.md` | Prioritize AI initiatives by balancing value, feasibility, readiness, risk, and control burden. | Use when multiple AI opportunities compete for investment, attention, or implementation capacity. | `[]` | `[decision-gates, portfolio-prioritization, strategic-fit]` | `[]` | `[]` | +| `ai-adoption-roadmapping` | `ai-adoption-roadmapping.md` | Stage AI adoption from pilot to scaled operation with explicit maturity and control gates. | Use when an organization needs a sequenced path from experimentation to governed scale. | `[]` | `[]` | `[decision-gates, portfolio-prioritization, strategy-narrative-structure]` | `[]` | +| `ai-center-of-excellence-design` | `ai-center-of-excellence-design.md` | Design an AI enablement model that scales standards, support, and governance without becoming a delivery bottleneck. | Use when an organization needs a reusable structure for AI enablement across teams or business units. | `[]` | `[]` | `[decision-gates, ai-operating-model-architecture, ai-adoption-roadmapping]` | `[]` | +| `ai-readiness-assessment` | `ai-readiness-assessment.md` | Assess whether an organization or initiative is ready to design, deploy, and control AI responsibly. | Use when deciding whether an AI initiative should start, scale, or pause. | `[]` | `[]` | `[decision-gates, strategy-diagnosis, strategic-fit]` | `[]` | +| `ai-use-case-framing` | `ai-use-case-framing.md` | Frame AI initiatives around concrete problems, outcomes, and constraints before solution design begins. | Use when a team proposes an AI or agentic initiative and the business value or problem boundary is still fluid. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | +| `ai-value-risk-prioritization` | `ai-value-risk-prioritization.md` | Prioritize AI initiatives by balancing value, feasibility, readiness, risk, and control burden. | Use when multiple AI opportunities compete for investment, attention, or implementation capacity. | `[]` | `[]` | `[decision-gates, portfolio-prioritization, strategic-fit]` | `[]` | #### Engineering -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `agent-loop-and-state-design` | `agent-loop-and-state-design.md` | Design agent loops and state transitions so work remains resumable, bounded, and interruptible. | Use when an AI system iterates across planning, tool use, review, or multi-step execution. | `[]` | `[deterministic-reasoning, abstraction-boundary-discipline, change-impact-analysis]` | `[]` | `[]` | -| `context-engineering-discipline` | `context-engineering-discipline.md` | Shape context deliberately so the model receives the right information, in the right form, at the right boundary. | Use when model quality depends on retrieved material, memory, task state, or instruction layering. | `[]` | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | `[]` | -| `evaluation-driven-iteration` | `evaluation-driven-iteration.md` | Improve AI behavior through explicit evaluation evidence rather than taste, anecdotes, or prompt folklore. | Use when changing prompts, context design, workflows, models, or guardrails to improve outcome quality. | `[]` | `[deterministic-reasoning, critical-peer-discipline]` | `[]` | `[]` | -| `expert-continuity-briefing` | `expert-continuity-briefing.md` | Transform a running discussion into a continuity brief that enables another expert or agent to continue the work without material loss of goal, reasoning state, decisions, evidence, or next actions. | Use when an ongoing discussion, advisory thread, or reasoning session must be transferred so another expert can continue without reconstructing the material context from scratch. | the task is a project or repository reboot handover rather than discussion continuity
simple summarization is sufficient and no receiving expert must continue the work directly | `[deterministic-reasoning, statement-extraction-rigor, fact-interpretation-separation]` | `[]` | statement-extraction-rigor: extracts relevant source statements without building a continuity-ready expert brief
decision-structuring-discipline: structures decision artifacts instead of preserving full discussion continuity
context-engineering-discipline: shapes model context boundaries instead of producing a transfer brief for a receiving expert
project handover protocol/report: governs reboot and repository handover rather than discussion continuity | -| `failure-mode-and-guardrail-design` | `failure-mode-and-guardrail-design.md` | Design guardrails from concrete AI failure modes instead of generic caution language. | Use when an AI system can influence decisions, actions, data exposure, or downstream automation. | `[]` | `[deterministic-reasoning, critical-peer-discipline, change-impact-analysis]` | `[]` | `[]` | -| `prompt-contract-design` | `prompt-contract-design.md` | Design prompts and instructions as bounded contracts rather than informal text craft. | Use when stable AI behavior depends on instruction structure, constraint enforcement, or output boundaries. | `[]` | `[deterministic-reasoning, interface-contract-first]` | `[]` | `[]` | -| `tool-use-and-action-boundary-design` | `tool-use-and-action-boundary-design.md` | Separate reasoning from external actions so tool invocation stays controlled, reviewable, and permission-bounded. | Use when an AI system calls tools, writes data, triggers workflows, or acts on external systems. | `[]` | `[deterministic-reasoning, interface-contract-first, change-impact-analysis]` | `[]` | `[]` | +| `agent-loop-and-state-design` | `agent-loop-and-state-design.md` | Design agent loops and state transitions so work remains resumable, bounded, and interruptible. | Use when an AI system iterates across planning, tool use, review, or multi-step execution. | `[]` | `[]` | `[deterministic-reasoning, abstraction-boundary-discipline, change-impact-analysis]` | `[]` | +| `context-engineering-discipline` | `context-engineering-discipline.md` | Shape context deliberately so the model receives the right information, in the right form, at the right boundary. | Use when model quality depends on retrieved material, memory, task state, or instruction layering. | `[]` | `[]` | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | +| `evaluation-driven-iteration` | `evaluation-driven-iteration.md` | Improve AI behavior through explicit evaluation evidence rather than taste, anecdotes, or prompt folklore. | Use when changing prompts, context design, workflows, models, or guardrails to improve outcome quality. | `[]` | `[]` | `[deterministic-reasoning, critical-peer-discipline]` | `[]` | +| `expert-continuity-briefing` | `expert-continuity-briefing.md` | Transform a running discussion into a continuity brief that enables another expert or agent to continue the work without material loss of goal, reasoning state, decisions, evidence, or next actions. | Use when an ongoing discussion, advisory thread, or reasoning session must be transferred so another expert can continue without reconstructing the material context from scratch. | the task is a project or repository reboot handover rather than discussion continuity
simple summarization is sufficient and no receiving expert must continue the work directly | statement-extraction-rigor: extracts relevant source statements without building a continuity-ready expert brief
decision-structuring-discipline: structures decision artifacts instead of preserving full discussion continuity
context-engineering-discipline: shapes model context boundaries instead of producing a transfer brief for a receiving expert
project handover protocol/report: governs reboot and repository handover rather than discussion continuity | `[deterministic-reasoning, statement-extraction-rigor, fact-interpretation-separation]` | `[]` | +| `failure-mode-and-guardrail-design` | `failure-mode-and-guardrail-design.md` | Design guardrails from concrete AI failure modes instead of generic caution language. | Use when an AI system can influence decisions, actions, data exposure, or downstream automation. | `[]` | `[]` | `[deterministic-reasoning, critical-peer-discipline, change-impact-analysis]` | `[]` | +| `prompt-contract-design` | `prompt-contract-design.md` | Design prompts and instructions as bounded contracts rather than informal text craft. | Use when stable AI behavior depends on instruction structure, constraint enforcement, or output boundaries. | `[]` | `[]` | `[deterministic-reasoning, interface-contract-first]` | `[]` | +| `tool-use-and-action-boundary-design` | `tool-use-and-action-boundary-design.md` | Separate reasoning from external actions so tool invocation stays controlled, reviewable, and permission-bounded. | Use when an AI system calls tools, writes data, triggers workflows, or acts on external systems. | `[]` | `[]` | `[deterministic-reasoning, interface-contract-first, change-impact-analysis]` | `[]` | ## Analysis #### Organization -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `function-deduplication` | `function-deduplication.md` | Remove duplicate function statements without losing meaningful distinctions. | Use when a normalized function set may contain duplicate or near-duplicate function statements. | `[]` | `[function-extraction]` | `[]` | `[]` | -| `function-extraction` | `function-extraction.md` | Extract normalized business or organizational functions from source material. | Use when source material contains business or organizational work statements that must be normalized into functions. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `function-ownership-allocation` | `function-ownership-allocation.md` | Allocate clear accountability for each materially relevant function without collapsing ownership into informal group responsibility. | Use when assigning accountability for materially relevant functions across teams, roles, or organizational units. | `[]` | `[function-extraction]` | `[]` | `[]` | -| `value-stream-organization-design` | `value-stream-organization-design.md` | Design target organizations around end-to-end value flow instead of accidental internal boundaries. | Use when designing or reviewing organizational structures against end-to-end value flow. | `[]` | `[function-extraction, function-deduplication, function-ownership-allocation]` | `[]` | `[]` | +| `function-deduplication` | `function-deduplication.md` | Remove duplicate function statements without losing meaningful distinctions. | Use when a normalized function set may contain duplicate or near-duplicate function statements. | `[]` | `[]` | `[function-extraction]` | `[]` | +| `function-extraction` | `function-extraction.md` | Extract normalized business or organizational functions from source material. | Use when source material contains business or organizational work statements that must be normalized into functions. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `function-ownership-allocation` | `function-ownership-allocation.md` | Allocate clear accountability for each materially relevant function without collapsing ownership into informal group responsibility. | Use when assigning accountability for materially relevant functions across teams, roles, or organizational units. | `[]` | `[]` | `[function-extraction]` | `[]` | +| `value-stream-organization-design` | `value-stream-organization-design.md` | Design target organizations around end-to-end value flow instead of accidental internal boundaries. | Use when designing or reviewing organizational structures against end-to-end value flow. | `[]` | `[]` | `[function-extraction, function-deduplication, function-ownership-allocation]` | `[]` | #### Role Assessment -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `comparison-dimension-discipline` | `comparison-dimension-discipline.md` | Ensure that comparative analysis uses stable, decision-relevant dimensions instead of ad hoc framing. | Use when comparing alternatives, roles, proposals, or candidate options that need a stable evaluation frame. | `[]` | `[statement-extraction-rigor, fact-interpretation-separation]` | `[]` | `[]` | -| `evidence-typing-discipline` | `evidence-typing-discipline.md` | Keep material claims traceable by marking whether they are directly observed or inferred. | Use when materially relevant claims, findings, or recommendations depend on source evidence or observed outputs. | `[]` | `[fact-interpretation-separation]` | `[]` | `[]` | -| `fact-interpretation-separation` | `fact-interpretation-separation.md` | Separate observed statements from inference, synthesis, and judgment. | Use when deriving interpretations, conclusions, or recommendations from source statements or observed evidence. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `statement-extraction-rigor` | `statement-extraction-rigor.md` | Extract all materially relevant statements from source material without collapsing distinct claims. | Use when extracting materially relevant statements from documents, transcripts, requirements, or review artifacts. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | +| `comparison-dimension-discipline` | `comparison-dimension-discipline.md` | Ensure that comparative analysis uses stable, decision-relevant dimensions instead of ad hoc framing. | Use when comparing alternatives, roles, proposals, or candidate options that need a stable evaluation frame. | `[]` | `[]` | `[statement-extraction-rigor, fact-interpretation-separation]` | `[]` | +| `evidence-typing-discipline` | `evidence-typing-discipline.md` | Keep material claims traceable by marking whether they are directly observed or inferred. | Use when materially relevant claims, findings, or recommendations depend on source evidence or observed outputs. | `[]` | `[]` | `[fact-interpretation-separation]` | `[]` | +| `fact-interpretation-separation` | `fact-interpretation-separation.md` | Separate observed statements from inference, synthesis, and judgment. | Use when deriving interpretations, conclusions, or recommendations from source statements or observed evidence. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `statement-extraction-rigor` | `statement-extraction-rigor.md` | Extract all materially relevant statements from source material without collapsing distinct claims. | Use when extracting materially relevant statements from documents, transcripts, requirements, or review artifacts. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | #### Specification -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `ambiguity-detection` | `ambiguity-detection.md` | Detect terms or clauses that allow materially different interpretations. | Use when reviewing text, specifications, contracts, or guidance that may allow materially different readings. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `contradiction-detection` | `contradiction-detection.md` | Detect when two statements cannot both be true within the same scope and time frame. | Use when reviewing statements, requirements, or contracts for claims that may not both hold in the same scope and time frame. | `[]` | `[fact-interpretation-separation]` | `[]` | `[]` | -| `overlap-detection` | `overlap-detection.md` | Detect materially relevant duplication of responsibility, output, or control intent. | Use when reviewing responsibilities, outputs, or control boundaries for possible duplication. | `[]` | `[statement-extraction-rigor]` | `[]` | `[]` | -| `semantic-conflict-detection` | `semantic-conflict-detection.md` | Detect materially incompatible intent, behavior, or governance semantics even when statements are not literally contradictory. | Use when reviewing policies, processes, models, or interfaces that may be materially incompatible without being literally contradictory. | `[]` | `[fact-interpretation-separation, contradiction-detection]` | `[]` | `[]` | +| `ambiguity-detection` | `ambiguity-detection.md` | Detect terms or clauses that allow materially different interpretations. | Use when reviewing text, specifications, contracts, or guidance that may allow materially different readings. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `contradiction-detection` | `contradiction-detection.md` | Detect when two statements cannot both be true within the same scope and time frame. | Use when reviewing statements, requirements, or contracts for claims that may not both hold in the same scope and time frame. | `[]` | `[]` | `[fact-interpretation-separation]` | `[]` | +| `overlap-detection` | `overlap-detection.md` | Detect materially relevant duplication of responsibility, output, or control intent. | Use when reviewing responsibilities, outputs, or control boundaries for possible duplication. | `[]` | `[]` | `[statement-extraction-rigor]` | `[]` | +| `semantic-conflict-detection` | `semantic-conflict-detection.md` | Detect materially incompatible intent, behavior, or governance semantics even when statements are not literally contradictory. | Use when reviewing policies, processes, models, or interfaces that may be materially incompatible without being literally contradictory. | `[]` | `[]` | `[fact-interpretation-separation, contradiction-detection]` | `[]` | ## Architecture #### Domain -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `application-integration-architecture` | `application-integration-architecture.md` | Shape application-domain architecture through explicit service boundaries, interoperability, and application landscape evolution. | Use when a segment or domain architecture task is application-focused and must govern application responsibilities, interfaces, or integration patterns. | when the problem is primarily data governance or technology platform architecture
when one concrete solution change needs realization governance more than domain architecture | `[segment-architecture-stewardship, architecture-decision-rigor]` | `[]` | data-governance-architecture
technology-platform-architecture
solution-realization-architecture | -| `business-service-architecture` | `business-service-architecture.md` | Shape business-domain architecture through explicit capability, service, process, organization, and metric relationships. | Use when a segment or domain architecture task is business-focused and must govern business capabilities and services rather than only technical assets. | when data, application, or technology-domain concerns dominate the architecture problem
when the task is generic strategic planning without a business-architecture boundary | `[segment-architecture-stewardship, capability-map-governance]` | `[]` | capability-map-governance
data-governance-architecture
application-integration-architecture
technology-platform-architecture | -| `data-governance-architecture` | `data-governance-architecture.md` | Shape data-domain architecture through explicit governance, integration, migration, protection, and lifecycle control. | Use when a segment or domain architecture task is data-focused and must govern data ownership, flow, protection, integration, or migration across the landscape. | when the main concern is application-service decomposition rather than data governance and lifecycle control
when the task is low-level schema hygiene without data-landscape architecture implications | `[segment-architecture-stewardship]` | `[]` | application-integration-architecture
technology-platform-architecture
domain-modeling-rigor | -| `segment-architecture-stewardship` | `segment-architecture-stewardship.md` | Shape and govern one business or technical segment as a coherent architecture responsibility instead of a loose collection of systems. | Use when a business or technical segment must be translated from strategy into governed architecture change, policies, standards, and segment evolution. | when the task is enterprise-wide cross-segment integration rather than stewardship of one segment
when the task is detailed realization of one concrete solution rather than segment evolution | `[togaf-adm-discipline, baseline-target-gap-analysis]` | `[]` | enterprise-architecture-integration
solution-realization-architecture
capability-map-governance | -| `technology-platform-architecture` | `technology-platform-architecture.md` | Shape technology-domain architecture through explicit platform, network, device, infrastructure, and interoperability decisions. | Use when a segment or domain architecture task is technology-focused and must govern platform standards, infrastructure boundaries, or technical interoperability. | when the dominant concern is application-service architecture or data governance rather than platform and infrastructure design
when the task is an operational runbook without architecture-level platform decisions | `[segment-architecture-stewardship]` | `[]` | application-integration-architecture
data-governance-architecture
solution-realization-architecture | +| `application-integration-architecture` | `application-integration-architecture.md` | Shape application-domain architecture through explicit service boundaries, interoperability, and application landscape evolution. | Use when a segment or domain architecture task is application-focused and must govern application responsibilities, interfaces, or integration patterns. | when the problem is primarily data governance or technology platform architecture
when one concrete solution change needs realization governance more than domain architecture | data-governance-architecture: TBD
technology-platform-architecture: TBD
solution-realization-architecture: TBD | `[segment-architecture-stewardship, architecture-decision-rigor]` | `[]` | +| `business-service-architecture` | `business-service-architecture.md` | Shape business-domain architecture through explicit capability, service, process, organization, and metric relationships. | Use when a segment or domain architecture task is business-focused and must govern business capabilities and services rather than only technical assets. | when data, application, or technology-domain concerns dominate the architecture problem
when the task is generic strategic planning without a business-architecture boundary | capability-map-governance: TBD
data-governance-architecture: TBD
application-integration-architecture: TBD
technology-platform-architecture: TBD | `[segment-architecture-stewardship, capability-map-governance]` | `[]` | +| `data-governance-architecture` | `data-governance-architecture.md` | Shape data-domain architecture through explicit governance, integration, migration, protection, and lifecycle control. | Use when a segment or domain architecture task is data-focused and must govern data ownership, flow, protection, integration, or migration across the landscape. | when the main concern is application-service decomposition rather than data governance and lifecycle control
when the task is low-level schema hygiene without data-landscape architecture implications | application-integration-architecture: TBD
technology-platform-architecture: TBD
domain-modeling-rigor: TBD | `[segment-architecture-stewardship]` | `[]` | +| `segment-architecture-stewardship` | `segment-architecture-stewardship.md` | Shape and govern one business or technical segment as a coherent architecture responsibility instead of a loose collection of systems. | Use when a business or technical segment must be translated from strategy into governed architecture change, policies, standards, and segment evolution. | when the task is enterprise-wide cross-segment integration rather than stewardship of one segment
when the task is detailed realization of one concrete solution rather than segment evolution | enterprise-architecture-integration: TBD
solution-realization-architecture: TBD
capability-map-governance: TBD | `[togaf-adm-discipline, baseline-target-gap-analysis]` | `[]` | +| `technology-platform-architecture` | `technology-platform-architecture.md` | Shape technology-domain architecture through explicit platform, network, device, infrastructure, and interoperability decisions. | Use when a segment or domain architecture task is technology-focused and must govern platform standards, infrastructure boundaries, or technical interoperability. | when the dominant concern is application-service architecture or data governance rather than platform and infrastructure design
when the task is an operational runbook without architecture-level platform decisions | application-integration-architecture: TBD
data-governance-architecture: TBD
solution-realization-architecture: TBD | `[segment-architecture-stewardship]` | `[]` | #### Enterprise -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `architecture-practice-leadership` | `architecture-practice-leadership.md` | Create the strategic, governance, and sponsorship conditions for an effective architecture practice across the enterprise. | Use when architecture work needs executive alignment, practice leadership, or cross-domain mandate before downstream enterprise, segment, or solution work can succeed. | when the task is detailed segment or solution design rather than architecture-practice leadership
when a conformance verdict is needed rather than leadership, sponsorship, or mandate creation | `[togaf-adm-discipline, strategic-fit]` | `[]` | enterprise-architecture-integration
architecture-compliance-review
strategic-fit | -| `capability-map-governance` | `capability-map-governance.md` | Use capability maps as stable architecture control artifacts rather than as proxies for projects or org charts. | Use when creating, reviewing, or governing capability maps as architecture control artifacts. | when the task is detailed process, org-chart, or application mapping rather than stable capability architecture
when segment or solution realization questions dominate over capability-map control logic | `[togaf-adm-discipline]` | `[]` | business-service-architecture
enterprise-architecture-integration | -| `enterprise-architecture-integration` | `enterprise-architecture-integration.md` | Create enterprise-wide integration, interoperability, governance, and roadmap coherence across multiple architecture segments. | Use when architecture work must align principles, policies, roadmaps, or interoperability across multiple segments instead of one local domain or one solution. | when scope is only one segment or one concrete solution
when the main need is executive sponsorship and practice mandate rather than enterprise integration | `[togaf-adm-discipline, capability-map-governance]` | `[]` | architecture-practice-leadership
segment-architecture-stewardship
transition-architecture-planning | -| `togaf-adm-discipline` | `togaf-adm-discipline.md` | Keep architecture work phase-aware, decision-oriented, and traceable to the intent of TOGAF ADM. | Use when architecture work claims TOGAF alignment or needs phase-aware architecture discipline. | when the task is a local modeling or compliance question that does not depend on TOGAF lifecycle framing
when role-specific architecture leadership or realization design is needed more than phase-aware discipline | `[decision-gates]` | `[]` | enterprise-architecture-integration
transition-architecture-planning | +| `architecture-practice-leadership` | `architecture-practice-leadership.md` | Create the strategic, governance, and sponsorship conditions for an effective architecture practice across the enterprise. | Use when architecture work needs executive alignment, practice leadership, or cross-domain mandate before downstream enterprise, segment, or solution work can succeed. | when the task is detailed segment or solution design rather than architecture-practice leadership
when a conformance verdict is needed rather than leadership, sponsorship, or mandate creation | enterprise-architecture-integration: TBD
architecture-compliance-review: TBD
strategic-fit: TBD | `[togaf-adm-discipline, strategic-fit]` | `[]` | +| `capability-map-governance` | `capability-map-governance.md` | Use capability maps as stable architecture control artifacts rather than as proxies for projects or org charts. | Use when creating, reviewing, or governing capability maps as architecture control artifacts. | when the task is detailed process, org-chart, or application mapping rather than stable capability architecture
when segment or solution realization questions dominate over capability-map control logic | business-service-architecture: TBD
enterprise-architecture-integration: TBD | `[togaf-adm-discipline]` | `[]` | +| `enterprise-architecture-integration` | `enterprise-architecture-integration.md` | Create enterprise-wide integration, interoperability, governance, and roadmap coherence across multiple architecture segments. | Use when architecture work must align principles, policies, roadmaps, or interoperability across multiple segments instead of one local domain or one solution. | when scope is only one segment or one concrete solution
when the main need is executive sponsorship and practice mandate rather than enterprise integration | architecture-practice-leadership: TBD
segment-architecture-stewardship: TBD
transition-architecture-planning: TBD | `[togaf-adm-discipline, capability-map-governance]` | `[]` | +| `togaf-adm-discipline` | `togaf-adm-discipline.md` | Keep architecture work phase-aware, decision-oriented, and traceable to the intent of TOGAF ADM. | Use when architecture work claims TOGAF alignment or needs phase-aware architecture discipline. | when the task is a local modeling or compliance question that does not depend on TOGAF lifecycle framing
when role-specific architecture leadership or realization design is needed more than phase-aware discipline | enterprise-architecture-integration: TBD
transition-architecture-planning: TBD | `[decision-gates]` | `[]` | #### Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `architecture-compliance-review` | `architecture-compliance-review.md` | Review target states and solution directions against architecture principles, standards, and approved decisions. | Use when reviewing target states, architectures, or solution directions against approved architecture principles and standards. | when the task is to create architecture direction rather than evaluate conformance against approved principles, standards, or decisions
when no architecture baseline exists to review against | `[togaf-adm-discipline, archimate-cross-layer-consistency]` | `[]` | architecture-practice-leadership
enterprise-architecture-integration
solution-realization-architecture | +| `architecture-compliance-review` | `architecture-compliance-review.md` | Review target states and solution directions against architecture principles, standards, and approved decisions. | Use when reviewing target states, architectures, or solution directions against approved architecture principles and standards. | when the task is to create architecture direction rather than evaluate conformance against approved principles, standards, or decisions
when no architecture baseline exists to review against | architecture-practice-leadership: TBD
enterprise-architecture-integration: TBD
solution-realization-architecture: TBD | `[togaf-adm-discipline, archimate-cross-layer-consistency]` | `[]` | #### Modeling -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `archimate-cross-layer-consistency` | `archimate-cross-layer-consistency.md` | Keep ArchiMate models consistent across business, application, data, and technology layers. | Use when reviewing ArchiMate models across multiple layers, views, or lifecycle updates. | when the main task is choosing viewpoints rather than validating cross-layer model consistency | `[archimate-viewpoint-selection]` | `[]` | archimate-viewpoint-selection | -| `archimate-viewpoint-selection` | `archimate-viewpoint-selection.md` | Select modeling viewpoints by stakeholder question and decision need, not by template habit. | Use when selecting or reviewing ArchiMate views for stakeholder communication or design decisions. | when the relevant problem is cross-layer inconsistency rather than viewpoint fit for a stakeholder question | `[togaf-adm-discipline]` | `[]` | archimate-cross-layer-consistency | +| `archimate-cross-layer-consistency` | `archimate-cross-layer-consistency.md` | Keep ArchiMate models consistent across business, application, data, and technology layers. | Use when reviewing ArchiMate models across multiple layers, views, or lifecycle updates. | when the main task is choosing viewpoints rather than validating cross-layer model consistency | archimate-viewpoint-selection: TBD | `[archimate-viewpoint-selection]` | `[]` | +| `archimate-viewpoint-selection` | `archimate-viewpoint-selection.md` | Select modeling viewpoints by stakeholder question and decision need, not by template habit. | Use when selecting or reviewing ArchiMate views for stakeholder communication or design decisions. | when the relevant problem is cross-layer inconsistency rather than viewpoint fit for a stakeholder question | archimate-cross-layer-consistency: TBD | `[togaf-adm-discipline]` | `[]` | #### Solution -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `baseline-target-gap-analysis` | `baseline-target-gap-analysis.md` | Make baseline, target, and gap statements comparable before solution design proceeds. | Use when comparing current and target states before solution design or transition planning. | when no baseline or target state can be stated yet
when the main task is sequencing transition states rather than comparing states | `[togaf-adm-discipline]` | `[]` | transition-architecture-planning
solution-realization-architecture | -| `solution-realization-architecture` | `solution-realization-architecture.md` | Shape a concrete solution change into an interoperable topology and implementable transition architecture without losing architectural intent. | Use when a concrete solution must be specified, staged, and governed from requirements through target roadmap and implementation change. | when the task is enterprise or segment governance without a concrete solution scope
when the task is generic project planning or handover without architecture realization content | `[baseline-target-gap-analysis, transition-architecture-planning, architecture-decision-rigor]` | `[]` | segment-architecture-stewardship
transition-architecture-planning
agentic-solution-architecture | -| `transition-architecture-planning` | `transition-architecture-planning.md` | Stage architecture evolution through deliberate intermediate states instead of assuming one-step transformation. | Use when architecture evolution must be staged through deliberate intermediate states. | when baseline and target have not been compared yet
when the task is a single target-state compliance check rather than staged change design | `[baseline-target-gap-analysis]` | `[]` | baseline-target-gap-analysis
solution-realization-architecture | +| `baseline-target-gap-analysis` | `baseline-target-gap-analysis.md` | Make baseline, target, and gap statements comparable before solution design proceeds. | Use when comparing current and target states before solution design or transition planning. | when no baseline or target state can be stated yet
when the main task is sequencing transition states rather than comparing states | transition-architecture-planning: TBD
solution-realization-architecture: TBD | `[togaf-adm-discipline]` | `[]` | +| `solution-realization-architecture` | `solution-realization-architecture.md` | Shape a concrete solution change into an interoperable topology and implementable transition architecture without losing architectural intent. | Use when a concrete solution must be specified, staged, and governed from requirements through target roadmap and implementation change. | when the task is enterprise or segment governance without a concrete solution scope
when the task is generic project planning or handover without architecture realization content | segment-architecture-stewardship: TBD
transition-architecture-planning: TBD
agentic-solution-architecture: TBD | `[baseline-target-gap-analysis, transition-architecture-planning, architecture-decision-rigor]` | `[]` | +| `transition-architecture-planning` | `transition-architecture-planning.md` | Stage architecture evolution through deliberate intermediate states instead of assuming one-step transformation. | Use when architecture evolution must be staged through deliberate intermediate states. | when baseline and target have not been compared yet
when the task is a single target-state compliance check rather than staged change design | baseline-target-gap-analysis: TBD
solution-realization-architecture: TBD | `[baseline-target-gap-analysis]` | `[]` | ## Engineering #### Principles -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `abstraction-boundary-discipline` | `abstraction-boundary-discipline.md` | Align module and service boundaries with change, policy, and responsibility boundaries instead of file convenience. | Use when defining or reviewing module, service, or subsystem boundaries. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `architecture-decision-rigor` | `architecture-decision-rigor.md` | Keep architecture decisions explicit, comparable, and reviewable before they shape the system. | Use when making or reviewing significant architecture decisions. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `change-impact-analysis` | `change-impact-analysis.md` | Make the blast radius of non-trivial changes explicit before implementation commits the system to hidden coupling. | Use when preparing or reviewing non-trivial changes with possible cross-boundary effects. | `[]` | `[architecture-decision-rigor, abstraction-boundary-discipline]` | `[]` | `[]` | -| `composition-over-subtyping` | `composition-over-subtyping.md` | Prefer explicit composition of behavior over deep inheritance or subtype trees. | Use when designing extensible behavior or type relationships. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `domain-modeling-rigor` | `domain-modeling-rigor.md` | Domain concepts must be explicit, stable, and mapped to unambiguous model boundaries. | Use when modeling domain concepts or reviewing domain-facing contracts and APIs. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | -| `functional-error-modeling` | `functional-error-modeling.md` | Error states and optional values must be explicit in domain contracts. | Use when defining or reviewing domain contracts that carry recoverable failures or optional values. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `immutability-by-default` | `immutability-by-default.md` | Keep state transitions explicit and bounded so domain behavior remains predictable and composable. | Use when designing or reviewing stateful domain behavior and mutation boundaries. | `[]` | `[domain-modeling-rigor]` | `[]` | `[]` | -| `interface-contract-first` | `interface-contract-first.md` | Define semantic boundary contracts before implementation details accumulate around them. | Use when defining or reviewing interface boundaries before implementation details spread. | `[]` | `[domain-modeling-rigor, abstraction-boundary-discipline]` | `[]` | `[]` | -| `side-effect-boundary-discipline` | `side-effect-boundary-discipline.md` | Keep side effects explicit, bounded, and testable. | Use when designing or reviewing IO-heavy logic, process control, or external action boundaries. | `[]` | `[immutability-by-default, functional-error-modeling]` | `[]` | `[]` | +| `abstraction-boundary-discipline` | `abstraction-boundary-discipline.md` | Align module and service boundaries with change, policy, and responsibility boundaries instead of file convenience. | Use when defining or reviewing module, service, or subsystem boundaries. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `architecture-decision-rigor` | `architecture-decision-rigor.md` | Keep architecture decisions explicit, comparable, and reviewable before they shape the system. | Use when making or reviewing significant architecture decisions. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `change-impact-analysis` | `change-impact-analysis.md` | Make the blast radius of non-trivial changes explicit before implementation commits the system to hidden coupling. | Use when preparing or reviewing non-trivial changes with possible cross-boundary effects. | `[]` | `[]` | `[architecture-decision-rigor, abstraction-boundary-discipline]` | `[]` | +| `composition-over-subtyping` | `composition-over-subtyping.md` | Prefer explicit composition of behavior over deep inheritance or subtype trees. | Use when designing extensible behavior or type relationships. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `domain-modeling-rigor` | `domain-modeling-rigor.md` | Domain concepts must be explicit, stable, and mapped to unambiguous model boundaries. | Use when modeling domain concepts or reviewing domain-facing contracts and APIs. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | +| `functional-error-modeling` | `functional-error-modeling.md` | Error states and optional values must be explicit in domain contracts. | Use when defining or reviewing domain contracts that carry recoverable failures or optional values. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `immutability-by-default` | `immutability-by-default.md` | Keep state transitions explicit and bounded so domain behavior remains predictable and composable. | Use when designing or reviewing stateful domain behavior and mutation boundaries. | `[]` | `[]` | `[domain-modeling-rigor]` | `[]` | +| `interface-contract-first` | `interface-contract-first.md` | Define semantic boundary contracts before implementation details accumulate around them. | Use when defining or reviewing interface boundaries before implementation details spread. | `[]` | `[]` | `[domain-modeling-rigor, abstraction-boundary-discipline]` | `[]` | +| `side-effect-boundary-discipline` | `side-effect-boundary-discipline.md` | Keep side effects explicit, bounded, and testable. | Use when designing or reviewing IO-heavy logic, process control, or external action boundaries. | `[]` | `[]` | `[immutability-by-default, functional-error-modeling]` | `[]` | ## Foundation -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `clarification-before-guessing` | `clarification-before-guessing.md` | Resolve missing or contradictory context through explicit clarification instead of fabricated certainty. | Use when mandatory decision context is missing, contradictory, or underspecified. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | -| `critical-peer-discipline` | `critical-peer-discipline.md` | Act as a rigorous peer that surfaces weak assumptions, material trade-offs, and non-compliant requests instead of passively affirming them. | Use when reviewing requests, proposals, plans, or recommendations for material weakness or non-compliance. | `[]` | `[deterministic-reasoning]` | `[]` | `[]` | +| `clarification-before-guessing` | `clarification-before-guessing.md` | Resolve missing or contradictory context through explicit clarification instead of fabricated certainty. | Use when mandatory decision context is missing, contradictory, or underspecified. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | +| `critical-peer-discipline` | `critical-peer-discipline.md` | Act as a rigorous peer that surfaces weak assumptions, material trade-offs, and non-compliant requests instead of passively affirming them. | Use when reviewing requests, proposals, plans, or recommendations for material weakness or non-compliance. | `[]` | `[]` | `[deterministic-reasoning]` | `[]` | | `deterministic-reasoning` | `deterministic-reasoning.md` | Keep reasoning explicit, traceable, and stable under incomplete or conflicting context. | Use when reasoning under incomplete, conflicting, or partially evidenced context must remain explicit and stable. | `[]` | `[]` | `[]` | `[]` | -| `task-understanding-confirmation` | `task-understanding-confirmation.md` | Confirm the understood task framing before substantive execution starts so analysis, implementation, or recommendations do not proceed from a misread request. | Use when a new substantive request or a materially reframed task must be confirmed before solution content, analysis, or execution begins. | the interaction already operates inside a confirmed task frame and no material scope change occurred | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | clarification-before-guessing: resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient
interaction-contract: defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate
decision-gates: controls when strategic recommendations may become final and does not confirm task framing before execution | +| `task-understanding-confirmation` | `task-understanding-confirmation.md` | Confirm the understood task framing before substantive execution starts so analysis, implementation, or recommendations do not proceed from a misread request. | Use when a new substantive request or a materially reframed task must be confirmed before solution content, analysis, or execution begins. | the interaction already operates inside a confirmed task frame and no material scope change occurred | clarification-before-guessing: resolves missing or contradictory context whereas this capability confirms the task framing even when context is already sufficient
interaction-contract: defines deterministic collaboration behavior for strategy work rather than a general pre-execution confirmation gate
decision-gates: controls when strategic recommendations may become final and does not confirm task framing before execution | `[deterministic-reasoning, clarification-before-guessing]` | `[]` | ## Strategy #### Analysis -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `portfolio-prioritization` | `portfolio-prioritization.md` | Prioritize strategic options through an explicit, justified evaluation frame. | Use when multiple strategic options compete for attention, sequencing, or investment and a ranked decision is required. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | -| `strategy-diagnosis` | `strategy-diagnosis.md` | Determine what is true, relevant, and causally important in the current strategic context before options or actions are prioritized. | Use when a strategic situation must be understood before recommending options, interventions, or commitments. | `[]` | `[decision-gates]` | `[]` | `[]` | -| `strategy-narrative-structure` | `strategy-narrative-structure.md` | Structure strategic communication so direction, rationale, and consequences remain explicit. | Use when strategic reasoning must be communicated in a way that preserves diagnosis, logic, and consequences. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | +| `portfolio-prioritization` | `portfolio-prioritization.md` | Prioritize strategic options through an explicit, justified evaluation frame. | Use when multiple strategic options compete for attention, sequencing, or investment and a ranked decision is required. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | +| `strategy-diagnosis` | `strategy-diagnosis.md` | Determine what is true, relevant, and causally important in the current strategic context before options or actions are prioritized. | Use when a strategic situation must be understood before recommending options, interventions, or commitments. | `[]` | `[]` | `[decision-gates]` | `[]` | +| `strategy-narrative-structure` | `strategy-narrative-structure.md` | Structure strategic communication so direction, rationale, and consequences remain explicit. | Use when strategic reasoning must be communicated in a way that preserves diagnosis, logic, and consequences. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | #### Delivery -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `decision-structuring-discipline` | `decision-structuring-discipline.md` | Structure strategic decision artifacts so they are decision-ready, traceable, and explicit about gaps. | Use when preparing a strategic recommendation, board paper, or decision template for formal review or approval. | `[]` | `[decision-gates]` | `[]` | `[]` | +| `decision-structuring-discipline` | `decision-structuring-discipline.md` | Structure strategic decision artifacts so they are decision-ready, traceable, and explicit about gaps. | Use when preparing a strategic recommendation, board paper, or decision template for formal review or approval. | `[]` | `[]` | `[decision-gates]` | `[]` | #### Evaluation -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `strategic-fit` | `strategic-fit.md` | Evaluate whether an initiative fits strategic direction, constraints, and execution reality. | Use when deciding whether an initiative should stop, continue, pilot, or scale. | `[]` | `[decision-gates, strategy-diagnosis, portfolio-prioritization, kpi-system]` | `[]` | `[]` | +| `strategic-fit` | `strategic-fit.md` | Evaluate whether an initiative fits strategic direction, constraints, and execution reality. | Use when deciding whether an initiative should stop, continue, pilot, or scale. | `[]` | `[]` | `[decision-gates, strategy-diagnosis, portfolio-prioritization, kpi-system]` | `[]` | #### Goal Management -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `cadence-and-review-discipline` | `cadence-and-review-discipline.md` | Keep goals alive through explicit review cadence, evidence updates, learning, decisions, and adaptation instead of treating goals as static planning artifacts. | Use when goals, outcomes, OKRs, initiatives, or execution commitments need check-ins, progress review, scoring, adaptation, or closure. | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | `[]` | -| `goal-cascade-and-alignment` | `goal-cascade-and-alignment.md` | Align goals across levels, teams, or domains so local goals contribute to shared intent without mechanical cascading, hidden conflicts, or ownership dilution. | Use when goals are translated, cascaded, aligned, decomposed, or reviewed across teams, levels, portfolios, or organizational boundaries. | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | `[]` | -| `goal-quality-discipline` | `goal-quality-discipline.md` | Shape goals so they are material, outcome-oriented, understandable, owned, and usable for steering rather than vague aspiration or activity tracking. | Use when goals, objectives, outcomes, or target statements are proposed, reviewed, prioritized, or challenged. | `[]` | `[critical-peer-discipline]` | `[]` | `[]` | -| `okr-discipline` | `okr-discipline.md` | Apply OKRs as a disciplined goal-setting and execution system that creates focus, alignment, measurable progress, learning, and accountability around the goals that matter most. | Use when OKRs are proposed, designed, reviewed, scored, or challenged for goal management, alignment, or execution focus. | Measuring ongoing operational health or business-as-usual without change intent — use kpi-system instead. | `[goal-quality-discipline, goal-cascade-and-alignment, cadence-and-review-discipline, critical-peer-discipline]` | `[]` | kpi-system: kpi-system defines stable measurement semantics for health indicators; okr-discipline defines goal-setting for change with measurable Key Results. OKRs drive change, KPIs monitor health.
goal-quality-discipline: goal-quality-discipline shapes any goal statement for materiality and clarity; okr-discipline applies the specific OKR framework structure (Objective + Key Results + classification + cadence). | +| `cadence-and-review-discipline` | `cadence-and-review-discipline.md` | Keep goals alive through explicit review cadence, evidence updates, learning, decisions, and adaptation instead of treating goals as static planning artifacts. | Use when goals, outcomes, OKRs, initiatives, or execution commitments need check-ins, progress review, scoring, adaptation, or closure. | `[]` | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | +| `goal-cascade-and-alignment` | `goal-cascade-and-alignment.md` | Align goals across levels, teams, or domains so local goals contribute to shared intent without mechanical cascading, hidden conflicts, or ownership dilution. | Use when goals are translated, cascaded, aligned, decomposed, or reviewed across teams, levels, portfolios, or organizational boundaries. | `[]` | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | +| `goal-quality-discipline` | `goal-quality-discipline.md` | Shape goals so they are material, outcome-oriented, understandable, owned, and usable for steering rather than vague aspiration or activity tracking. | Use when goals, objectives, outcomes, or target statements are proposed, reviewed, prioritized, or challenged. | `[]` | `[]` | `[critical-peer-discipline]` | `[]` | +| `okr-discipline` | `okr-discipline.md` | Apply OKRs as a disciplined goal-setting and execution system that creates focus, alignment, measurable progress, learning, and accountability around the goals that matter most. | Use when OKRs are proposed, designed, reviewed, scored, or challenged for goal management, alignment, or execution focus. | Measuring ongoing operational health or business-as-usual without change intent — use kpi-system instead. | kpi-system: kpi-system defines stable measurement semantics for health indicators; okr-discipline defines goal-setting for change with measurable Key Results. OKRs drive change, KPIs monitor health.
goal-quality-discipline: goal-quality-discipline shapes any goal statement for materiality and clarity; okr-discipline applies the specific OKR framework structure (Objective + Key Results + classification + cadence). | `[goal-quality-discipline, goal-cascade-and-alignment, cadence-and-review-discipline, critical-peer-discipline]` | `[]` | #### Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `decision-gates` | `decision-gates.md` | Ensure that strategic recommendations are finalized only when the mandatory decision context is explicit. | Use when a strategic recommendation, prioritization, or decision artifact may move from provisional to final. | `[]` | `[interaction-contract]` | `[]` | `[]` | +| `decision-gates` | `decision-gates.md` | Ensure that strategic recommendations are finalized only when the mandatory decision context is explicit. | Use when a strategic recommendation, prioritization, or decision artifact may move from provisional to final. | `[]` | `[]` | `[interaction-contract]` | `[]` | #### Metrics -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `kpi-system` | `kpi-system.md` | Define KPI-Domains and KPIs as stable, reviewable measurement semantics for strategic decisions, goal tracking, and operational steering. | Use when strategic choices, interventions, or reviews depend on explicit measurement semantics. | Setting stretch goals or defining change-oriented objectives with measurable key results — use okr-discipline instead. | `[deterministic-reasoning]` | `[]` | okr-discipline: okr-discipline defines goal-setting for intentional change with measurable Key Results; kpi-system defines stable measurement semantics for ongoing health monitoring and decision support. KPIs measure state, OKRs drive change. | +| `kpi-system` | `kpi-system.md` | Define KPI-Domains and KPIs as stable, reviewable measurement semantics for strategic decisions, goal tracking, and operational steering. | Use when strategic choices, interventions, or reviews depend on explicit measurement semantics. | Setting stretch goals or defining change-oriented objectives with measurable key results — use okr-discipline instead. | okr-discipline: okr-discipline defines goal-setting for intentional change with measurable Key Results; kpi-system defines stable measurement semantics for ongoing health monitoring and decision support. KPIs measure state, OKRs drive change. | `[deterministic-reasoning]` | `[]` | #### Operation -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `technical-output-validation` | `technical-output-validation.md` | Validate technical outputs against strategic intent, declared quality criteria, and decision gates. | Use when technical output is used as supporting evidence for a strategic recommendation or decision. | `[]` | `[decision-gates, strategic-fit]` | `[]` | `[]` | +| `technical-output-validation` | `technical-output-validation.md` | Validate technical outputs against strategic intent, declared quality criteria, and decision gates. | Use when technical output is used as supporting evidence for a strategic recommendation or decision. | `[]` | `[]` | `[decision-gates, strategic-fit]` | `[]` | #### Workflow -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `interaction-contract` | `interaction-contract.md` | Define deterministic collaboration behavior for strategy work. | Use when strategy work requires explicit clarification behavior, provisional/final signaling, and assumption handling. | `[]` | `[clarification-before-guessing]` | `[]` | `[]` | +| `interaction-contract` | `interaction-contract.md` | Define deterministic collaboration behavior for strategy work. | Use when strategy work requires explicit clarification behavior, provisional/final signaling, and assumption handling. | `[]` | `[]` | `[clarification-before-guessing]` | `[]` | diff --git a/crp/cap/strategy/analysis/portfolio-prioritization.meta.yaml b/crp/cap/strategy/analysis/portfolio-prioritization.meta.yaml index 519e2c5..bb97272 100644 --- a/crp/cap/strategy/analysis/portfolio-prioritization.meta.yaml +++ b/crp/cap/strategy/analysis/portfolio-prioritization.meta.yaml @@ -1,11 +1,6 @@ id: portfolio-prioritization version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategy-diagnosis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/analysis/strategy-diagnosis.meta.yaml b/crp/cap/strategy/analysis/strategy-diagnosis.meta.yaml index 5229b76..daf66f6 100644 --- a/crp/cap/strategy/analysis/strategy-diagnosis.meta.yaml +++ b/crp/cap/strategy/analysis/strategy-diagnosis.meta.yaml @@ -1,11 +1,6 @@ id: strategy-diagnosis version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/analysis/strategy-narrative-structure.meta.yaml b/crp/cap/strategy/analysis/strategy-narrative-structure.meta.yaml index fa9d790..1bf6885 100644 --- a/crp/cap/strategy/analysis/strategy-narrative-structure.meta.yaml +++ b/crp/cap/strategy/analysis/strategy-narrative-structure.meta.yaml @@ -1,11 +1,6 @@ id: strategy-narrative-structure version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategy-diagnosis"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/delivery/decision-structuring-discipline.meta.yaml b/crp/cap/strategy/delivery/decision-structuring-discipline.meta.yaml index 2cc72b8..386eab0 100644 --- a/crp/cap/strategy/delivery/decision-structuring-discipline.meta.yaml +++ b/crp/cap/strategy/delivery/decision-structuring-discipline.meta.yaml @@ -1,11 +1,6 @@ id: decision-structuring-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/evaluation/strategic-fit.meta.yaml b/crp/cap/strategy/evaluation/strategic-fit.meta.yaml index a18a573..7fe2773 100644 --- a/crp/cap/strategy/evaluation/strategic-fit.meta.yaml +++ b/crp/cap/strategy/evaluation/strategic-fit.meta.yaml @@ -1,11 +1,6 @@ id: strategic-fit version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategy-diagnosis","portfolio-prioritization","kpi-system"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/goal-management/cadence-and-review-discipline.meta.yaml b/crp/cap/strategy/goal-management/cadence-and-review-discipline.meta.yaml index 729dce3..0fd47ad 100644 --- a/crp/cap/strategy/goal-management/cadence-and-review-discipline.meta.yaml +++ b/crp/cap/strategy/goal-management/cadence-and-review-discipline.meta.yaml @@ -1,11 +1,6 @@ id: cadence-and-review-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-04-30T00:00:00+02:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["goal-quality-discipline","critical-peer-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/goal-management/goal-cascade-and-alignment.meta.yaml b/crp/cap/strategy/goal-management/goal-cascade-and-alignment.meta.yaml index 6f94c2a..4bcf670 100644 --- a/crp/cap/strategy/goal-management/goal-cascade-and-alignment.meta.yaml +++ b/crp/cap/strategy/goal-management/goal-cascade-and-alignment.meta.yaml @@ -1,11 +1,6 @@ id: goal-cascade-and-alignment version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-04-30T00:00:00+02:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["goal-quality-discipline","critical-peer-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/goal-management/goal-quality-discipline.meta.yaml b/crp/cap/strategy/goal-management/goal-quality-discipline.meta.yaml index 9042ee6..0b6ad77 100644 --- a/crp/cap/strategy/goal-management/goal-quality-discipline.meta.yaml +++ b/crp/cap/strategy/goal-management/goal-quality-discipline.meta.yaml @@ -1,11 +1,6 @@ id: goal-quality-discipline version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-04-30T00:00:00+02:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["critical-peer-discipline"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/goal-management/okr-discipline.meta.yaml b/crp/cap/strategy/goal-management/okr-discipline.meta.yaml index ed8d6f1..65c2077 100644 --- a/crp/cap/strategy/goal-management/okr-discipline.meta.yaml +++ b/crp/cap/strategy/goal-management/okr-discipline.meta.yaml @@ -1,11 +1,6 @@ id: okr-discipline version: 0.3.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-05-04T00:00:00+02:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["goal-quality-discipline","goal-cascade-and-alignment","cadence-and-review-discipline","critical-peer-discipline"] conflicts: [] do_not_use_when: diff --git a/crp/cap/strategy/governance/decision-gates.meta.yaml b/crp/cap/strategy/governance/decision-gates.meta.yaml index 322ef01..53fe164 100644 --- a/crp/cap/strategy/governance/decision-gates.meta.yaml +++ b/crp/cap/strategy/governance/decision-gates.meta.yaml @@ -1,11 +1,6 @@ id: decision-gates version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["interaction-contract"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/index.md b/crp/cap/strategy/index.md index 4fc3298..ac09bcf 100644 --- a/crp/cap/strategy/index.md +++ b/crp/cap/strategy/index.md @@ -4,53 +4,53 @@ This index exposes the local capability selection surface for `strategy`. ## Analysis -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `portfolio-prioritization` | `portfolio-prioritization.md` | Prioritize strategic options through an explicit, justified evaluation frame. | Use when multiple strategic options compete for attention, sequencing, or investment and a ranked decision is required. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | -| `strategy-diagnosis` | `strategy-diagnosis.md` | Determine what is true, relevant, and causally important in the current strategic context before options or actions are prioritized. | Use when a strategic situation must be understood before recommending options, interventions, or commitments. | `[]` | `[decision-gates]` | `[]` | `[]` | -| `strategy-narrative-structure` | `strategy-narrative-structure.md` | Structure strategic communication so direction, rationale, and consequences remain explicit. | Use when strategic reasoning must be communicated in a way that preserves diagnosis, logic, and consequences. | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | `[]` | +| `portfolio-prioritization` | `portfolio-prioritization.md` | Prioritize strategic options through an explicit, justified evaluation frame. | Use when multiple strategic options compete for attention, sequencing, or investment and a ranked decision is required. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | +| `strategy-diagnosis` | `strategy-diagnosis.md` | Determine what is true, relevant, and causally important in the current strategic context before options or actions are prioritized. | Use when a strategic situation must be understood before recommending options, interventions, or commitments. | `[]` | `[]` | `[decision-gates]` | `[]` | +| `strategy-narrative-structure` | `strategy-narrative-structure.md` | Structure strategic communication so direction, rationale, and consequences remain explicit. | Use when strategic reasoning must be communicated in a way that preserves diagnosis, logic, and consequences. | `[]` | `[]` | `[decision-gates, strategy-diagnosis]` | `[]` | ## Delivery -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `decision-structuring-discipline` | `decision-structuring-discipline.md` | Structure strategic decision artifacts so they are decision-ready, traceable, and explicit about gaps. | Use when preparing a strategic recommendation, board paper, or decision template for formal review or approval. | `[]` | `[decision-gates]` | `[]` | `[]` | +| `decision-structuring-discipline` | `decision-structuring-discipline.md` | Structure strategic decision artifacts so they are decision-ready, traceable, and explicit about gaps. | Use when preparing a strategic recommendation, board paper, or decision template for formal review or approval. | `[]` | `[]` | `[decision-gates]` | `[]` | ## Evaluation -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `strategic-fit` | `strategic-fit.md` | Evaluate whether an initiative fits strategic direction, constraints, and execution reality. | Use when deciding whether an initiative should stop, continue, pilot, or scale. | `[]` | `[decision-gates, strategy-diagnosis, portfolio-prioritization, kpi-system]` | `[]` | `[]` | +| `strategic-fit` | `strategic-fit.md` | Evaluate whether an initiative fits strategic direction, constraints, and execution reality. | Use when deciding whether an initiative should stop, continue, pilot, or scale. | `[]` | `[]` | `[decision-gates, strategy-diagnosis, portfolio-prioritization, kpi-system]` | `[]` | ## Goal Management -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `cadence-and-review-discipline` | `cadence-and-review-discipline.md` | Keep goals alive through explicit review cadence, evidence updates, learning, decisions, and adaptation instead of treating goals as static planning artifacts. | Use when goals, outcomes, OKRs, initiatives, or execution commitments need check-ins, progress review, scoring, adaptation, or closure. | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | `[]` | -| `goal-cascade-and-alignment` | `goal-cascade-and-alignment.md` | Align goals across levels, teams, or domains so local goals contribute to shared intent without mechanical cascading, hidden conflicts, or ownership dilution. | Use when goals are translated, cascaded, aligned, decomposed, or reviewed across teams, levels, portfolios, or organizational boundaries. | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | `[]` | -| `goal-quality-discipline` | `goal-quality-discipline.md` | Shape goals so they are material, outcome-oriented, understandable, owned, and usable for steering rather than vague aspiration or activity tracking. | Use when goals, objectives, outcomes, or target statements are proposed, reviewed, prioritized, or challenged. | `[]` | `[critical-peer-discipline]` | `[]` | `[]` | -| `okr-discipline` | `okr-discipline.md` | Apply OKRs as a disciplined goal-setting and execution system that creates focus, alignment, measurable progress, learning, and accountability around the goals that matter most. | Use when OKRs are proposed, designed, reviewed, scored, or challenged for goal management, alignment, or execution focus. | Measuring ongoing operational health or business-as-usual without change intent — use kpi-system instead. | `[goal-quality-discipline, goal-cascade-and-alignment, cadence-and-review-discipline, critical-peer-discipline]` | `[]` | kpi-system: kpi-system defines stable measurement semantics for health indicators; okr-discipline defines goal-setting for change with measurable Key Results. OKRs drive change, KPIs monitor health.
goal-quality-discipline: goal-quality-discipline shapes any goal statement for materiality and clarity; okr-discipline applies the specific OKR framework structure (Objective + Key Results + classification + cadence). | +| `cadence-and-review-discipline` | `cadence-and-review-discipline.md` | Keep goals alive through explicit review cadence, evidence updates, learning, decisions, and adaptation instead of treating goals as static planning artifacts. | Use when goals, outcomes, OKRs, initiatives, or execution commitments need check-ins, progress review, scoring, adaptation, or closure. | `[]` | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | +| `goal-cascade-and-alignment` | `goal-cascade-and-alignment.md` | Align goals across levels, teams, or domains so local goals contribute to shared intent without mechanical cascading, hidden conflicts, or ownership dilution. | Use when goals are translated, cascaded, aligned, decomposed, or reviewed across teams, levels, portfolios, or organizational boundaries. | `[]` | `[]` | `[goal-quality-discipline, critical-peer-discipline]` | `[]` | +| `goal-quality-discipline` | `goal-quality-discipline.md` | Shape goals so they are material, outcome-oriented, understandable, owned, and usable for steering rather than vague aspiration or activity tracking. | Use when goals, objectives, outcomes, or target statements are proposed, reviewed, prioritized, or challenged. | `[]` | `[]` | `[critical-peer-discipline]` | `[]` | +| `okr-discipline` | `okr-discipline.md` | Apply OKRs as a disciplined goal-setting and execution system that creates focus, alignment, measurable progress, learning, and accountability around the goals that matter most. | Use when OKRs are proposed, designed, reviewed, scored, or challenged for goal management, alignment, or execution focus. | Measuring ongoing operational health or business-as-usual without change intent — use kpi-system instead. | kpi-system: kpi-system defines stable measurement semantics for health indicators; okr-discipline defines goal-setting for change with measurable Key Results. OKRs drive change, KPIs monitor health.
goal-quality-discipline: goal-quality-discipline shapes any goal statement for materiality and clarity; okr-discipline applies the specific OKR framework structure (Objective + Key Results + classification + cadence). | `[goal-quality-discipline, goal-cascade-and-alignment, cadence-and-review-discipline, critical-peer-discipline]` | `[]` | ## Governance -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `decision-gates` | `decision-gates.md` | Ensure that strategic recommendations are finalized only when the mandatory decision context is explicit. | Use when a strategic recommendation, prioritization, or decision artifact may move from provisional to final. | `[]` | `[interaction-contract]` | `[]` | `[]` | +| `decision-gates` | `decision-gates.md` | Ensure that strategic recommendations are finalized only when the mandatory decision context is explicit. | Use when a strategic recommendation, prioritization, or decision artifact may move from provisional to final. | `[]` | `[]` | `[interaction-contract]` | `[]` | ## Metrics -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `kpi-system` | `kpi-system.md` | Define KPI-Domains and KPIs as stable, reviewable measurement semantics for strategic decisions, goal tracking, and operational steering. | Use when strategic choices, interventions, or reviews depend on explicit measurement semantics. | Setting stretch goals or defining change-oriented objectives with measurable key results — use okr-discipline instead. | `[deterministic-reasoning]` | `[]` | okr-discipline: okr-discipline defines goal-setting for intentional change with measurable Key Results; kpi-system defines stable measurement semantics for ongoing health monitoring and decision support. KPIs measure state, OKRs drive change. | +| `kpi-system` | `kpi-system.md` | Define KPI-Domains and KPIs as stable, reviewable measurement semantics for strategic decisions, goal tracking, and operational steering. | Use when strategic choices, interventions, or reviews depend on explicit measurement semantics. | Setting stretch goals or defining change-oriented objectives with measurable key results — use okr-discipline instead. | okr-discipline: okr-discipline defines goal-setting for intentional change with measurable Key Results; kpi-system defines stable measurement semantics for ongoing health monitoring and decision support. KPIs measure state, OKRs drive change. | `[deterministic-reasoning]` | `[]` | ## Operation -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `technical-output-validation` | `technical-output-validation.md` | Validate technical outputs against strategic intent, declared quality criteria, and decision gates. | Use when technical output is used as supporting evidence for a strategic recommendation or decision. | `[]` | `[decision-gates, strategic-fit]` | `[]` | `[]` | +| `technical-output-validation` | `technical-output-validation.md` | Validate technical outputs against strategic intent, declared quality criteria, and decision gates. | Use when technical output is used as supporting evidence for a strategic recommendation or decision. | `[]` | `[]` | `[decision-gates, strategic-fit]` | `[]` | ## Workflow -| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From | +| ID | File | Purpose | Use When | Do Not Use When | Distinguish From | Requires | Conflicts | | --- | --- | --- | --- | --- | --- | --- | --- | -| `interaction-contract` | `interaction-contract.md` | Define deterministic collaboration behavior for strategy work. | Use when strategy work requires explicit clarification behavior, provisional/final signaling, and assumption handling. | `[]` | `[clarification-before-guessing]` | `[]` | `[]` | +| `interaction-contract` | `interaction-contract.md` | Define deterministic collaboration behavior for strategy work. | Use when strategy work requires explicit clarification behavior, provisional/final signaling, and assumption handling. | `[]` | `[]` | `[clarification-before-guessing]` | `[]` | diff --git a/crp/cap/strategy/metrics/kpi-system.meta.yaml b/crp/cap/strategy/metrics/kpi-system.meta.yaml index c178f33..d7ae8b4 100644 --- a/crp/cap/strategy/metrics/kpi-system.meta.yaml +++ b/crp/cap/strategy/metrics/kpi-system.meta.yaml @@ -1,11 +1,6 @@ id: kpi-system version: 0.2.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-05-04T00:00:00+02:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: diff --git a/crp/cap/strategy/operation/technical-output-validation.meta.yaml b/crp/cap/strategy/operation/technical-output-validation.meta.yaml index 9058f55..574784a 100644 --- a/crp/cap/strategy/operation/technical-output-validation.meta.yaml +++ b/crp/cap/strategy/operation/technical-output-validation.meta.yaml @@ -1,11 +1,6 @@ id: technical-output-validation version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["decision-gates","strategic-fit"] conflicts: [] do_not_use_when: [] diff --git a/crp/cap/strategy/workflow/interaction-contract.meta.yaml b/crp/cap/strategy/workflow/interaction-contract.meta.yaml index 752077d..aeb54d5 100644 --- a/crp/cap/strategy/workflow/interaction-contract.meta.yaml +++ b/crp/cap/strategy/workflow/interaction-contract.meta.yaml @@ -1,11 +1,6 @@ id: interaction-contract version: 0.1.0 -status: active -approved_by: ["nemron"] -approved_at: 2026-03-19T00:00:00+01:00 -scope: cognitive owner: nemron -review_due: 2026-12-31 requires: ["clarification-before-guessing"] conflicts: [] do_not_use_when: [] diff --git a/crp/gov/prc/workflow.md b/crp/gov/prc/workflow.md index a114901..b0020ad 100644 --- a/crp/gov/prc/workflow.md +++ b/crp/gov/prc/workflow.md @@ -102,7 +102,7 @@ This workflow executes **per Story**. Epic refinement and Story decomposition ar 5. AI Strategy (`ai4x-ai-strategy`) — conditional - validates model/tool constraints, fallback behavior, and uncertainty policy -- only when the Story involves AI/LLM behavior +- only when the Story involves AI/LLM behavior or shapes agent capability consumption patterns 6. Capability Governance (`ai4x-capability-governance`) — conditional - validates portfolio coverage, authors or revises capabilities, performs semantic fitness checks @@ -131,7 +131,7 @@ The Tech Lead determines in Stage 1 which stages are needed for the current Stor | 2. Requirements Refinement | Conditional | Epic ACs are already sufficient for the Story scope | | 3. Architecture | Conditional | No module boundary or domain invariant changes | | 4. Critical Review A | Conditional | Stages 2 and 3 were both skipped | -| 5. AI Strategy | Conditional | Story does not involve AI/LLM behavior | +| 5. AI Strategy | Conditional | Story does not involve AI/LLM behavior and does not shape agent capability consumption patterns | | 6. Capability Governance | Conditional | Story does not involve cognitive capability authoring, evaluation, or portfolio change | | 7. Implementation | Always | — | | 8. Testing | Always | — | diff --git a/utl/cap/checks/capability-indexes.mjs b/utl/cap/checks/capability-indexes.mjs index 3089c44..693a21f 100644 --- a/utl/cap/checks/capability-indexes.mjs +++ b/utl/cap/checks/capability-indexes.mjs @@ -11,6 +11,46 @@ const capRoot = root; const writeMode = modeArg === "--write"; let fail = 0; +// --- Schema loading (AC-15) --- + +const schemaPath = process.env.AI4X_SCHEMA_PATH + ? path.resolve(process.env.AI4X_SCHEMA_PATH) + : path.resolve( + path.dirname(new URL(import.meta.url).pathname), + "../../../adm/gdl/dev/schemas/capability-meta.schema.yaml", + ); + +if (!fs.existsSync(schemaPath)) { + process.stderr.write(`[ccp|ERROR]: central schema file not found: ${schemaPath}\n`); + process.exit(1); +} + +let schemaRaw; +try { + schemaRaw = YAML.parse(fs.readFileSync(schemaPath, "utf8")); +} catch (err) { + process.stderr.write(`[ccp|ERROR]: central schema file is unparseable: ${schemaPath}: ${err instanceof Error ? err.message : String(err)}\n`); + process.exit(1); +} + +if (schemaRaw == null || typeof schemaRaw !== "object" || schemaRaw.fields == null) { + process.stderr.write(`[ccp|ERROR]: central schema file is malformed (missing 'fields' block): ${schemaPath}\n`); + process.exit(1); +} + +const schemaFields = schemaRaw.fields; +// Determine which metadata fields to render in index tables from schema. +// Include array fields with simple items (strings or objects with ≤ 2 properties). +// Complex object arrays (e.g., sources with 5 properties) are excluded. +const indexRenderableFields = Object.entries(schemaFields) + .filter(([, def]) => { + if (def.type !== "array") return false; + const props = def.items?.properties; + if (props && Object.keys(props).length > 2) return false; + return true; + }) + .map(([name]) => name); + function error(message) { fail += 1; process.stderr.write(`[ccp|ERROR]: ${message}\n`); @@ -100,16 +140,21 @@ function getDirectCapabilities(absDir) { const metaPath = mdPath.replace(/\.md$/, ".meta.yaml"); const markdown = fs.readFileSync(mdPath, "utf8"); const meta = fs.existsSync(metaPath) ? readMeta(metaPath) : {}; - return { + const cap = { id: path.basename(entry.name, ".md"), file: path.relative(absDir, mdPath).split(path.sep).join("/"), purpose: extractSection(markdown, "Purpose"), useWhen: extractSection(markdown, "Trigger"), - doNotUseWhen: asStringArray(meta.do_not_use_when), - requires: asStringArray(meta.requires), - conflicts: asStringArray(meta.conflicts), - distinguishFrom: asDistinguishFromArray(meta.distinguish_from), }; + // Schema-driven: extract renderable array fields from metadata + for (const field of indexRenderableFields) { + if (field === "distinguish_from") { + cap[field] = asDistinguishFromArray(meta[field]); + } else { + cap[field] = asStringArray(meta[field]); + } + } + return cap; }) .sort((a, b) => a.id.localeCompare(b.id)); } @@ -122,15 +167,35 @@ function formatTextArray(values) { return values.length === 0 ? "`[]`" : values.join("
"); } +function fieldToColumnHeader(field) { + return field.split("_").map((w) => w[0].toUpperCase() + w.slice(1)).join(" "); +} + +function formatFieldValue(field, entry) { + const value = entry[field]; + if (!Array.isArray(value) || value.length === 0) return "`[]`"; + // ID-reference fields use code formatting + if (field === "requires" || field === "conflicts") return formatIdArray(value); + return formatTextArray(value); +} + function renderTable(entries) { + const fixedHeaders = ["ID", "File", "Purpose", "Use When"]; + const metaHeaders = indexRenderableFields.map(fieldToColumnHeader); + const allHeaders = [...fixedHeaders, ...metaHeaders]; const lines = [ - "| ID | File | Purpose | Use When | Do Not Use When | Requires | Conflicts | Distinguish From |", - "| --- | --- | --- | --- | --- | --- | --- | --- |", + `| ${allHeaders.join(" | ")} |`, + `| ${allHeaders.map(() => "---").join(" | ")} |`, ]; for (const entry of entries) { - lines.push( - `| \`${entry.id}\` | \`${entry.file}\` | ${entry.purpose} | ${entry.useWhen} | ${formatTextArray(entry.doNotUseWhen)} | ${formatIdArray(entry.requires)} | ${formatIdArray(entry.conflicts)} | ${formatTextArray(entry.distinguishFrom)} |`, - ); + const fixedCells = [ + `\`${entry.id}\``, + `\`${entry.file}\``, + entry.purpose, + entry.useWhen, + ]; + const metaCells = indexRenderableFields.map((field) => formatFieldValue(field, entry)); + lines.push(`| ${[...fixedCells, ...metaCells].join(" | ")} |`); } return lines.join("\n"); } diff --git a/utl/cap/checks/capability-meta.mjs b/utl/cap/checks/capability-meta.mjs index 358f33f..38213ac 100755 --- a/utl/cap/checks/capability-meta.mjs +++ b/utl/cap/checks/capability-meta.mjs @@ -5,40 +5,47 @@ import YAML from "yaml"; const rootArg = process.argv[2]; const root = rootArg ? path.resolve(rootArg) : path.resolve(path.dirname(new URL(import.meta.url).pathname), "../../../crp/cap"); -const expectedScope = "cognitive"; const capRoot = root; -const allowedKeys = new Set([ - "id", - "version", - "status", - "approved_by", - "approved_at", - "scope", - "review_due", - "owner", - "requires", - "conflicts", - "do_not_use_when", - "distinguish_from", - "sources", - "migration_note", -]); +// --- Schema loading (AC-11, AC-13, AC-14) --- -const requiredKeys = [ - "id", - "version", - "status", - "approved_by", - "approved_at", - "scope", - "do_not_use_when", - "distinguish_from", - "sources", -]; -const allowedStatus = new Set(["draft", "active", "deprecated", "retired"]); -const allowedSourceKeys = new Set(["title", "organization", "url", "kind", "accessed_at"]); -const allowedSourceKinds = new Set(["standard", "architecture-guidance", "security-guidance", "adoption-guidance", "domain-reference"]); +const schemaPath = process.env.AI4X_SCHEMA_PATH + ? path.resolve(process.env.AI4X_SCHEMA_PATH) + : path.resolve( + path.dirname(new URL(import.meta.url).pathname), + "../../../adm/gdl/dev/schemas/capability-meta.schema.yaml", + ); + +if (!fs.existsSync(schemaPath)) { + process.stderr.write(`[ccp|ERROR]: central schema file not found: ${schemaPath}\n`); + process.exit(1); +} + +let schemaRaw; +try { + schemaRaw = YAML.parse(fs.readFileSync(schemaPath, "utf8")); +} catch (err) { + process.stderr.write(`[ccp|ERROR]: central schema file is unparseable: ${schemaPath}: ${err instanceof Error ? err.message : String(err)}\n`); + process.exit(1); +} + +if (schemaRaw == null || typeof schemaRaw !== "object" || schemaRaw.fields == null) { + process.stderr.write(`[ccp|ERROR]: central schema file is malformed (missing 'fields' block): ${schemaPath}\n`); + process.exit(1); +} + +const schemaFields = schemaRaw.fields; +const allowedKeys = new Set(Object.keys(schemaFields)); +const requiredKeys = Object.entries(schemaFields) + .filter(([, def]) => def.required === true) + .map(([name]) => name); + +// Derive source entry constraints from schema +const sourcesSchema = schemaFields.sources?.items?.properties ?? {}; +const allowedSourceKeys = new Set(Object.keys(sourcesSchema)); +const allowedSourceKinds = sourcesSchema.kind?.enum + ? new Set(sourcesSchema.kind.enum) + : new Set(); let requiredFail = 0; let advisoryFail = 0; @@ -67,13 +74,6 @@ function parseMeta(metaPath) { return out; } -function validateIsoDateTime(value) { - if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?(Z|[+-]\d{2}:\d{2})$/.test(value)) { - return false; - } - return !Number.isNaN(Date.parse(value)); -} - function validateIsoDate(value) { if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) { return false; @@ -152,29 +152,14 @@ for (const capabilityFile of capabilityFiles) { const id = String(parsed.id ?? ""); const version = String(parsed.version ?? ""); - const status = String(parsed.status ?? ""); - const rawApprovedAt = parsed.approved_at; - const approvedAt = rawApprovedAt instanceof Date ? rawApprovedAt.toISOString() : String(rawApprovedAt ?? ""); - const scope = String(parsed.scope ?? ""); const owner = Object.prototype.hasOwnProperty.call(parsed, "owner") ? String(parsed.owner) : ""; - const rawReviewDue = parsed.review_due; - const reviewDue = rawReviewDue instanceof Date - ? rawReviewDue.toISOString().slice(0, 10) - : Object.prototype.hasOwnProperty.call(parsed, "review_due") ? String(rawReviewDue) : ""; - const migrationNote = Object.prototype.hasOwnProperty.call(parsed, "migration_note") - ? String(parsed.migration_note) - : ""; const sources = Array.isArray(parsed.sources) ? parsed.sources : []; - const approvedBy = Array.isArray(parsed.approved_by) ? parsed.approved_by.map(String) : []; const requires = Array.isArray(parsed.requires) ? parsed.requires.map(String) : []; const conflicts = Array.isArray(parsed.conflicts) ? parsed.conflicts.map(String) : []; const doNotUseWhen = Array.isArray(parsed.do_not_use_when) ? parsed.do_not_use_when.map(String) : []; - const distinguishFrom = Array.isArray(parsed.distinguish_from) ? parsed.distinguish_from.map(String) : []; + const distinguishFrom = Array.isArray(parsed.distinguish_from) ? parsed.distinguish_from : []; - if (!Array.isArray(parsed.approved_by)) { - failRequired(`${path.relative(root, metaPath)}: approved_by must be an array`); - } if (Object.prototype.hasOwnProperty.call(parsed, "requires") && !Array.isArray(parsed.requires)) { failRequired(`${path.relative(root, metaPath)}: requires must be an array`); } @@ -197,43 +182,30 @@ for (const capabilityFile of capabilityFiles) { if (!validateSemver(version)) { failRequired(`${path.relative(root, metaPath)}: version '${version}' must be semver`); } - if (!allowedStatus.has(status)) { - failRequired(`${path.relative(root, metaPath)}: invalid status '${status}'`); - } - if (!validateIsoDateTime(approvedAt)) { - failRequired(`${path.relative(root, metaPath)}: approved_at '${approvedAt}' must be ISO-8601 datetime`); - } - if (scope !== expectedScope) { - failRequired(`${path.relative(root, metaPath)}: scope '${scope}' must be '${expectedScope}'`); - } - if (status === "active" && approvedBy.length === 0) { - failRequired(`${path.relative(root, metaPath)}: status 'active' requires non-empty approved_by`); - } if (owner.length === 0) { - failAdvisory(`${path.relative(root, metaPath)}: owner should be set`); + failRequired(`${path.relative(root, metaPath)}: owner must be non-empty`); } - if (reviewDue.length > 0) { - if (!validateIsoDate(reviewDue)) { - failRequired(`${path.relative(root, metaPath)}: review_due '${reviewDue}' must be ISO date (YYYY-MM-DD)`); - } else { - const dueTs = Date.parse(`${reviewDue}T00:00:00Z`); - const nowTs = Date.now(); - if (dueTs < nowTs) { - failAdvisory(`${path.relative(root, metaPath)}: review_due '${reviewDue}' is in the past`); - } + for (const entry of doNotUseWhen) { + if (String(entry).trim().length === 0) { + failRequired(`${path.relative(root, metaPath)}: do_not_use_when entries must be non-empty strings`); } } - if (status === "deprecated" && migrationNote.length === 0) { - failAdvisory(`${path.relative(root, metaPath)}: deprecated capability should include migration_note`); - } - for (const entry of [...doNotUseWhen, ...distinguishFrom]) { - if (entry.trim().length === 0) { - failRequired(`${path.relative(root, metaPath)}: do_not_use_when/distinguish_from entries must be non-empty strings`); + for (const entry of distinguishFrom) { + if (entry == null || typeof entry !== "object" || !entry.id || !entry.boundary) { + failRequired(`${path.relative(root, metaPath)}: distinguish_from entries must be objects with 'id' and 'boundary' properties`); } } for (let idx = 0; idx < sources.length; idx += 1) { const source = sources[idx] ?? {}; const label = `${path.relative(root, metaPath)}: sources[${idx}]`; + // Reject unknown source properties (schema-derived) + if (allowedSourceKeys.size > 0) { + for (const key of Object.keys(source)) { + if (!allowedSourceKeys.has(key)) { + failRequired(`${label} unsupported key '${key}'`); + } + } + } const title = String(source.title ?? ""); const organization = String(source.organization ?? ""); const url = String(source.url ?? ""); diff --git a/utl/cap/checks/tst/capability-meta.sh b/utl/cap/checks/tst/capability-meta.sh index 81ed518..a82fdff 100755 --- a/utl/cap/checks/tst/capability-meta.sh +++ b/utl/cap/checks/tst/capability-meta.sh @@ -19,12 +19,7 @@ MD cat >"${fixture}/cap/foundation/deterministic-reasoning.meta.yaml" <<'YAML' id: deterministic-reasoning version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: [] conflicts: [] do_not_use_when: [] @@ -37,12 +32,7 @@ MD cat >"${fixture}/cap/foundation/clarification-before-guessing.meta.yaml" <<'YAML' id: clarification-before-guessing version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] @@ -55,12 +45,7 @@ MD cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' id: interaction-contract version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["clarification-before-guessing"] conflicts: [] do_not_use_when: [] @@ -85,12 +70,7 @@ MD cat >"${fixture}/cap/ai/engineering/context-engineering-discipline.meta.yaml" <<'YAML' id: context-engineering-discipline version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["clarification-before-guessing"] conflicts: [] do_not_use_when: [] @@ -116,12 +96,7 @@ run_fail_unknown_requires() { cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' id: interaction-contract version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["missing"] conflicts: [] do_not_use_when: [] @@ -140,12 +115,7 @@ run_fail_requires_conflicts_overlap() { cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' id: interaction-contract version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["clarification-before-guessing"] conflicts: ["clarification-before-guessing"] do_not_use_when: [] @@ -167,12 +137,7 @@ MD cat >"${fixture}/cap/foundation/critical-peer-discipline.meta.yaml" <<'YAML' id: critical-peer-discipline version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: ["interaction-contract"] do_not_use_when: [] @@ -185,48 +150,40 @@ YAML fi } -run_fail_missing_sources() { - local fixture="${TMP_DIR}/missing-sources" +run_fail_missing_owner() { + local fixture="${TMP_DIR}/missing-owner" make_ok_fixture "${fixture}" cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' id: interaction-contract version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive -owner: qa -review_due: 2026-12-31 requires: ["clarification-before-guessing"] conflicts: [] do_not_use_when: [] distinguish_from: [] +sources: [] YAML if "${CHECKER}" "${fixture}/cap" >/dev/null 2>&1; then - echo "expected failure for missing required sources field" >&2 + echo "expected failure for missing required owner field" >&2 return 1 fi } -run_fail_missing_do_not_use_when() { - local fixture="${TMP_DIR}/missing-do-not-use-when" +run_fail_unknown_key() { + local fixture="${TMP_DIR}/unknown-key" make_ok_fixture "${fixture}" cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' id: interaction-contract version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 +status: active requires: ["clarification-before-guessing"] conflicts: [] +do_not_use_when: [] distinguish_from: [] sources: [] YAML if "${CHECKER}" "${fixture}/cap" >/dev/null 2>&1; then - echo "expected failure for missing do_not_use_when field" >&2 + echo "expected failure for unknown key 'status'" >&2 return 1 fi } @@ -241,12 +198,7 @@ MD cat >"${fixture}/cap/ai/architecture/solution/agentic-solution-architecture.meta.yaml" <<'YAML' id: agentic-solution-architecture version: 0.1.0 -status: active -approved_by: ["qa"] -approved_at: 2026-03-08T00:00:00+01:00 -scope: cognitive owner: qa -review_due: 2026-12-31 requires: ["deterministic-reasoning"] conflicts: [] do_not_use_when: [] @@ -264,14 +216,63 @@ YAML fi } +run_fail_invalid_distinguish_from() { + local fixture="${TMP_DIR}/invalid-df" + make_ok_fixture "${fixture}" + cat >"${fixture}/cap/strategy/workflow/interaction-contract.meta.yaml" <<'YAML' +id: interaction-contract +version: 0.1.0 +owner: qa +requires: ["clarification-before-guessing"] +conflicts: [] +do_not_use_when: [] +distinguish_from: ["some-plain-string"] +sources: [] +YAML + if "${CHECKER}" "${fixture}/cap" >/dev/null 2>&1; then + echo "expected failure for string-format distinguish_from entry" >&2 + return 1 + fi +} + +run_fail_schema_missing() { + local fixture="${TMP_DIR}/schema-missing" + make_ok_fixture "${fixture}" + if AI4X_SCHEMA_PATH="/nonexistent/schema.yaml" "${CHECKER}" "${fixture}/cap" >/dev/null 2>&1; then + echo "expected failure for missing schema file" >&2 + return 1 + fi + # Verify error message names the file + local stderr_output + stderr_output="$(AI4X_SCHEMA_PATH="/nonexistent/schema.yaml" "${CHECKER}" "${fixture}/cap" 2>&1 || true)" + if ! echo "${stderr_output}" | grep -q "schema file not found"; then + echo "expected error message to mention 'schema file not found'" >&2 + return 1 + fi +} + +run_fail_schema_unparseable() { + local fixture="${TMP_DIR}/schema-unparseable" + make_ok_fixture "${fixture}" + local bad_schema="${TMP_DIR}/bad-schema.yaml" + echo "{{invalid yaml" >"${bad_schema}" + if AI4X_SCHEMA_PATH="${bad_schema}" "${CHECKER}" "${fixture}/cap" >/dev/null 2>&1; then + echo "expected failure for unparseable schema file" >&2 + return 1 + fi +} + run_ok run_ok_explicit_empty_sources run_fail_missing_meta run_fail_unknown_requires run_fail_requires_conflicts_overlap run_fail_asymmetric_conflict -run_fail_missing_sources -run_fail_missing_do_not_use_when +run_fail_missing_owner +run_fail_unknown_key run_fail_invalid_source_kind +run_fail_invalid_distinguish_from +run_fail_schema_missing +run_fail_schema_unparseable echo "capability-meta.sh: OK"