Unified tooling for the System Capability Protocol (SCP). This monorepo contains the core scanner/graph builder and integration plugins.
Note: The SCP specification is maintained separately.
Core tool for architecture definition and graph building
Scan repositories for scp.yaml manifests, validate them, build dependency graphs, and export to various formats (JSON, Mermaid, Neo4j, OpenC2).
uv run scp-cli scan ./repos --export mermaidServiceNow CMDB integration
Sync SCP architecture graphs to ServiceNow Configuration Management Database (CMDB).
scp-servicenow cmdb sync graph.json# Install all dependencies
make setup
# Scan repositories for scp.yaml files
make scan DIR=/path/to/repos
# Or use the CLI directly
uv run scp-cli scan /path/to/repos --export json -o graph.jsonRun make help to see all available commands
Built on scp-sdk 0.2.0 - All packages use the SDK for manifest parsing, validation, and graph operations.
The System Capability Protocol provides a declarative manifest format (scp.yaml) that describes what a system should be, complementing OpenTelemetry's view of what is happening.
This enables:
- LLM Reasoning: Change impact analysis and migration planning
- Architecture Discovery: Auto-generate org-wide system maps
- Theory vs Reality: Diff declared dependencies against OTel traces
- Smart Alerting: Auto-enrich alerts with ownership and blast radius
See scp-definition for the complete specification.
This is a Python monorepo managed with uv. Each package can be developed independently:
# Work on constructor
cd packages/constructor
uv sync
uv run pytestMIT