# HR Registry

Markdown-first indexes for HR planning artifacts and federation.

## Layout

| Path | Purpose |
|------|---------|
| `indexes/capabilities.yaml` | Reuse-surface capability index (federated) |
| `indexes/workflows.yaml` | HR workflow catalog index |
| `capabilities/` | Capability entry markdown files |
| `workflows/` | HR workflow entry markdown files |
| `assessment-loop.md` | Iterative assessment stages for workflow entries |

## Workflow registry

HR workflows are planning artifacts linked to INTENT phases. Each entry tracks
an `assessment.stage` that advances through the loop defined in
`assessment-loop.md`:

1. **inventory** — document current state
2. **automation_potential** — score routine vs strategic work
3. **human_touch** — bound what stays human-led
4. **readiness** — ready for roadmap prioritization

### Authoring workflows

1. Copy an existing entry under `workflows/` (e.g. `workflow.hr.current-state-assessment.md`).
2. Set `intent_phase` to the matching INTENT phase (`assessment`, `automation-roadmap`, etc.).
3. Add a row to `indexes/workflows.yaml`.
4. Update `assessment.stage` and `last_reviewed` as the loop progresses.

## Capability registry

Capabilities follow the reuse-surface federation contract.

### Authoring capabilities

1. Copy the template from 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`.

## INTENT linkage

Workflow entries map to INTENT iteration phases:

- `workflow.hr.current-state-assessment` → assessment phase
- `workflow.hr.automation-roadmap` → automation roadmap phase

Further phases (metrics framework, specific operational workflows) extend this
catalog as current-state assessment completes.