generated from coulomb/repo-seed
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:
@@ -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.
|
||||
Reference in New Issue
Block a user