Files
human-resources/registry/README.md
tegwick 3fd3b4500b 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.
2026-06-24 15:25:45 +02:00

1.9 KiB

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.