What is a Capability Spec?
A capability spec is the single source of truth for an integration unit in Naftiko. Written in YAML and validated by JSON Schema, it declares everything needed to consume upstream APIs, orchestrate multi-step workflows, expose downstream interfaces, enforce governance policies, and configure deployment.
Key sections
- Consumed APIs – Declares upstream systems with namespace, base URI, authentication, and operation contracts.
- Orchestration – Defines steps, call sequences, conditional logic, for-each loops, and parallel execution.
- Exposed APIs – Maps capability operations to REST endpoints, MCP tools, resources, prompts, and Agent Skills.
- Governance – Embeds blocking and advisory policies that are enforced at validation, CI, and runtime.
- Deployment – Configures Docker, Kubernetes, and environment-specific settings.
Why it matters
The capability spec replaces scattered configuration, custom glue code, and tribal knowledge with a single, version-controlled, machine-readable contract. It is committed to Git, reviewed in pull requests, and validated in CI pipelines – making integration a first-class engineering artifact.
