# Capability Registry

Markdown-first capability index for federation and reuse planning.

`registry/reins/*.yaml` is also the executable rein registry consumed by
`ProfileCatalog`. Each descriptor has a semantic rein version, supported Glas
contract versions, a restricted in-package handler, capabilities, and status.
A profile is executable only when its rein is implemented, supports the exact
contract version, and satisfies every required capability.

Validate the rein registry together with all harness profiles using:

```bash
glas-harness profiles --json
```

## Authoring

1. Copy a capability entry template (see reuse-surface `templates/capability-entry.template.md`).
2. Add the row to `indexes/capabilities.yaml`.
3. Run `reuse-surface validate` from a checkout with the CLI installed.
4. Merge to `main` and verify publish with `reuse-surface establish --publish-check`.

Federation contract: reuse-surface `docs/RegistryFederation.md`.