Capability Declaration

Kind: mechanism

Layer: Declarative Core

Record: architecture:capability-declaration

Severity: recommended

Scope: plugin, service, runtime

Canonical: Ontology

A mechanism by which a plugin or service lists the operations it supports, so callers test the list instead of probing for methods.

Listed in Architecture principles, after Convention over Configuration and before Manifest-Based Design.

Requires

• Manifest
• Contracts

Reinforces

• Runtime Discovery
• Self-Description

Enables

• Dynamic Binding

Conflicts with

• Implicit Capability

In tension with

• Declaration Drift

Tensions

• Capability Declaration / Declaration Drift

Violated by

• Implicit Capability

Refactored by

• Manifest-Based Design
• Extract Role Interface

Severity

• recommended

Category

• Metadata / Self-Description / Declarative Systems

Required by

• Self-Describing Architecture

Linked from

• Limits
• Systems built around a model
• Runtime Discovery / Dynamic Binding
• Metadata / Self-Description / Declarative Systems
• Core Vocabulary
• Metadata / Self-Description / Declarative Systems
• SOLID / Object-Oriented Design
• Severity levels
• The resolutions