Normalize repository validation and metadata

workplans/KAIZEN-WP-0011-repository-health-normalization.md

@@ -0,0 +1,88 @@
+---
+id: KAIZEN-WP-0011
+type: workplan
+title: "Repository validation and metadata normalization"
+domain: agents
+repo: kaizen-agentic
+status: finished
+owner: codex
+topic_slug: custodian
+created: "2026-08-20"
+updated: "2026-08-20"
+---
+
+# KAIZEN-WP-0011 — Repository validation and metadata normalization
+
+## Dependency validation
+
+```task
+id: KAIZEN-WP-0011-T01
+status: done
+priority: high
+```
+
+Prevent empty dependency declarations such as `dependencies: []` from creating
+an empty-name dependency, and cover the behavior with a regression test.
+
+**Result:** dependency inputs are filtered before registration; the regression
+test passes and registry validation no longer reports an empty dependency.
+
+## Complete CI test coverage
+
+```task
+id: KAIZEN-WP-0011-T02
+status: done
+priority: high
+```
+
+Use the running interpreter for subprocess CLI tests and remove the Forgejo CI
+exclusion for the complete CLI error-handling test module.
+
+**Result:** the subprocess test uses `sys.executable`, the full module passes,
+and Forgejo CI now runs the complete test suite.
+
+## Documentation and capability metadata
+
+```task
+id: KAIZEN-WP-0011-T03
+status: done
+priority: medium
+```
+
+Align the documented agent count with the 20 packaged definitions and use
+`agents-sync-package` consistently for source/package parity guidance.
+
+**Result:** README, contributing guidance, capability source/index, and packaged
+agent guidance agree on 20 agents; parity guidance uses
+`make agents-sync-package`.
+
+## Workplan convention normalization
+
+```task
+id: KAIZEN-WP-0011-T04
+status: done
+priority: medium
+```
+
+Normalize completed workplan statuses to `finished`, rename workplan files to
+the canonical `KAIZEN-WP-NNNN-<slug>.md` convention, and update inbound links.
+
+**Result:** all eleven workplan filenames follow the canonical convention,
+completed top-level statuses use `finished`, and inbound documentation links
+were updated. Stable workplan and task IDs were not changed.
+
+## Verification and closeout
+
+```task
+id: KAIZEN-WP-0011-T05
+status: done
+priority: high
+```
+
+Run the full test, release, agent-validation, and State Hub consistency checks;
+record the outcome and close the workplan.
+
+**Result:** full pytest, `make release-check`, `make agents-validate`, and
+`git diff --check` pass. `statehub fix-consistency` passes; all prefix and
+status warnings are eliminated. UUID registration is deferred to the production
+registrar, requested through State Hub message `d0d38ee7`.