feat(registry): scaffold HR workflow registry with assessment loop

Add workflow entries for INTENT assessment and automation-roadmap phases,
workflows.yaml index, assessment-loop stages, and capability.hr.workflow-catalog
for reuse-surface federation. Completes HUMAN-WP-0002.
This commit is contained in:
2026-06-24 15:25:45 +02:00
parent ba044c4e48
commit 3fd3b4500b
9 changed files with 487 additions and 10 deletions

View File

@@ -1,12 +1,54 @@
# Capability Registry
# HR Registry
Markdown-first capability index for federation and reuse planning.
Markdown-first indexes for HR planning artifacts and federation.
## Authoring
## Layout
1. Copy a capability entry template (see reuse-surface `templates/capability-entry.template.md`).
| 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.