Code to Catalog

Turn a codebase into EventCatalog documentation through a guided, evidence-based interview. Works for two situations:

1. No catalog yet — document an unfamiliar or undocumented codebase from scratch.
2. Existing catalog — reconcile the catalog with the current code (add new resources, flag drift, surface stale entries).

This skill does not write catalog files itself. It produces a plan file (.catalog-plan.md) that captures the agreed architectural model, then hands off to the catalog-documentation-creator skill to generate the actual documentation.

How this skill works

The skill runs in six phases. Follow them in order — later phases depend on earlier ones.

1. Locate & inventory — find the code directory and any existing catalog
2. Discovery scan — read the code, form a hypothesis
3. Reconcile with existing catalog — categorize findings as new / update / unchanged / investigate
4. Tiered grilling — interview the user on structural decisions only
5. Produce the plan file — write .catalog-plan.md, get approval
6. Handoff — ask whether to generate the catalog now or stop at the plan