---
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"
state_hub_workstream_id: "ceae7cdc-2ed2-5276-a520-8f2a2d1fcc23"
---

# KAIZEN-WP-0011 — Repository validation and metadata normalization

## Dependency validation

```task
id: KAIZEN-WP-0011-T01
status: done
priority: high
state_hub_task_id: "673da081-e29e-5bff-ba53-cd588f9d9863"
```


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
state_hub_task_id: "e02b5249-6f7c-5c22-b918-261e5a91031f"
```


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
state_hub_task_id: "0d31a1fa-7ac9-5476-a340-06761bd3f63a"
```


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
state_hub_task_id: "bfb22aee-f87a-5268-bd5c-cc8b43c99c4e"
```


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
state_hub_task_id: "da4970c6-7da5-5a25-b70a-f12abfd97307"
```


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`.