generated from coulomb/repo-seed
tegwick
3fd3b4500b
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.
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 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. |