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