Local Capability Guidance v1¶
Source schema: doc/schemas/capability-guidance.v1.schema.json
Optional lower-trust documentation from an operator-admitted signed local provider, bound to one exact capability contract. Notes describe use, not executable instructions. The host validates structure and provenance, not semantic intent; schema, grants and host policy retain authority.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: capability-guidance.v1 |
|
capability/id |
yes |
string | |
provider/id |
yes |
string | |
contract/ref |
yes |
string | |
contract/digest |
yes |
string | |
description |
yes |
string | |
lang |
yes |
string | |
usage/when |
no |
string | |
usage/avoid |
no |
string | |
usage/notes |
no |
string | |
usage/ref |
no |
string | |
examples |
no |
array | |
| ## Field Semantics |
schema¶
- Required:
yes - Shape: const:
capability-guidance.v1
capability/id¶
- Required:
yes - Shape: string
provider/id¶
- Required:
yes - Shape: string
contract/ref¶
- Required:
yes - Shape: string
contract/digest¶
- Required:
yes - Shape: string
description¶
- Required:
yes - Shape: string
lang¶
- Required:
yes - Shape: string
usage/when¶
- Required:
no - Shape: string
usage/avoid¶
- Required:
no - Shape: string
usage/notes¶
- Required:
no - Shape: string
usage/ref¶
- Required:
no - Shape: string
examples¶
- Required:
no - Shape: array