generated from coulomb/repo-seed
Introduces a capability catalog (CUST-WP-0022) so domains can advertise what they provide and agents can request capabilities from other domains with auto-routing, lifecycle tracking, and task-unblocking on completion. - New models: CapabilityCatalog, CapabilityRequest with full lifecycle (requested → accepted → in_progress → ready_for_review → completed/rejected/withdrawn) - Migration i6d7e8f9a0b1: capability_catalog + capability_requests tables - Router /capability-catalog and /capability-requests with accept/status endpoints - 7 new MCP tools: register_capability, list_capabilities, request_capability, accept_capability_request, update_capability_request_status, list_capability_requests, get_capability_request - StateSummary gains open_capability_requests count - Dashboard: capability-requests.md page + docs/capabilities.md + docs/scope.md - SCOPE.md: three seed capabilities documented (MCP registration, state tracking, SBOM) - scope.template: Provided Capabilities section with example block - scripts/ingest_capabilities.py + make ingest-capabilities[/-all] targets Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
138 lines
2.6 KiB
Plaintext
138 lines
2.6 KiB
Plaintext
# SCOPE
|
|
|
|
> This file helps you quickly understand what this repository is about,
|
|
> when it is relevant, and when it is not.
|
|
> It is intentionally lightweight and may be incomplete.
|
|
|
|
---
|
|
|
|
## One-liner
|
|
|
|
<!-- Describe the purpose of this repository in one precise sentence. -->
|
|
<!-- Example: "Provides a lightweight event router for Kubernetes-native systems." -->
|
|
|
|
---
|
|
|
|
## Core Idea
|
|
|
|
<!-- What is the main capability or idea behind this repository? -->
|
|
<!-- What problem does it try to solve? -->
|
|
|
|
---
|
|
|
|
## In Scope
|
|
|
|
<!-- What this repository is responsible for. -->
|
|
<!-- Be explicit and concrete. -->
|
|
|
|
-
|
|
-
|
|
-
|
|
|
|
---
|
|
|
|
## Out of Scope
|
|
|
|
<!-- What this repository deliberately does NOT do. -->
|
|
<!-- This is often more important than "In Scope". -->
|
|
|
|
-
|
|
-
|
|
-
|
|
|
|
---
|
|
|
|
## Relevant When
|
|
|
|
<!-- When should someone consider using or exploring this repository? -->
|
|
|
|
-
|
|
-
|
|
-
|
|
|
|
---
|
|
|
|
## Not Relevant When
|
|
|
|
<!-- When should someone ignore this repository? -->
|
|
|
|
-
|
|
-
|
|
-
|
|
|
|
---
|
|
|
|
## Current State
|
|
|
|
<!-- Rough indication of maturity. No strict format required. -->
|
|
|
|
- Status: <!-- e.g. concept / experimental / active / stable / deprecated -->
|
|
- Implementation: <!-- e.g. idea / partial / substantial / complete -->
|
|
- Stability: <!-- e.g. unstable / evolving / stable -->
|
|
- Usage: <!-- e.g. none / personal / internal / production -->
|
|
|
|
<!-- Add any notes that help set expectations. -->
|
|
|
|
---
|
|
|
|
## How It Fits
|
|
|
|
<!-- Where does this repository sit in the bigger picture? -->
|
|
|
|
- Upstream dependencies:
|
|
- Downstream consumers:
|
|
- Often used with:
|
|
|
|
---
|
|
|
|
## Terminology
|
|
|
|
<!-- Terms that are important to understand this repo. -->
|
|
<!-- Especially useful if naming differs from other repos. -->
|
|
|
|
- Preferred terms:
|
|
- Also known as:
|
|
- Potentially confusing terms:
|
|
|
|
---
|
|
|
|
## Related / Overlapping Repositories
|
|
|
|
<!-- List repositories that have similar or adjacent responsibilities. -->
|
|
<!-- Helps detect duplication and navigate the ecosystem. -->
|
|
|
|
- <repo-name> — <!-- how it relates -->
|
|
|
|
---
|
|
|
|
## Getting Oriented
|
|
|
|
<!-- If someone decides to look deeper, where should they start? -->
|
|
|
|
- Start with:
|
|
- Key files / directories:
|
|
- Entry points:
|
|
|
|
---
|
|
|
|
## Provided Capabilities
|
|
|
|
<!-- What can this repo's domain provide to other domains on request? -->
|
|
<!-- Each capability block is parsed by the state-hub capability catalog ingest. -->
|
|
<!-- Remove the examples and add your own, or leave empty if none. -->
|
|
|
|
<!--
|
|
```capability
|
|
type: infrastructure
|
|
title: Example capability title
|
|
description: What this capability provides, in one or two sentences.
|
|
keywords: [keyword1, keyword2, keyword3]
|
|
```
|
|
-->
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
<!-- Anything else worth knowing. Keep it short. -->
|