plan-v2-extract-domain

Please deep think / ultrathink as this is a complex task.

extract-domain

Collaboratively identify and formalize an existing codebase concept as a named domain without moving files. This is a workshop with the user, not an automated refactor. The goal is communication — future plans can reference "the auth domain" and everyone knows what that means.

User input:

$ARGUMENTS
# Expected:
# <concept>                    — the concept to extract (e.g., "authentication", "billing")
# Optional flags:
# --domain <slug>              — override the auto-generated slug
# --list                       — list existing domains and exit

What This Command Does

1. Explores the codebase to discover all code related to the concept
2. Catalogues discovered files and their roles — presented to user for review
3. Workshops with user to define what belongs vs. doesn't (boundary)
4. Identifies public interfaces other code already consumes (contracts)
5. Maps internal components (services, adapters, repos — composition)
6. Writes docs/domains/<slug>/domain.md pointing to files where they currently live
7. Updates docs/domains/registry.md (creates it if first domain)

What This Command Does NOT Do

• ❌ Move files to a new directory structure
• ❌ Refactor imports
• ❌ Create new source directories
• ❌ Change any code

---

Step 0: List Mode

If --list flag provided:

• Read docs/domains/registry.md (if exists)
• Display all registered domains with slug, type, status
• If docs/domains/domain-map.md exists, show it too — the map gives the visual overview of how domains relate
• If no registry exists, report "No domains registered yet"
• Exit

Step 1: Check for Existing Domain

• Read docs/domains/registry.md if it exists
• Read docs/domains/domain-map.md if it exists — understand the current domain topology, existing contract relationships, and where a new domain might fit
• Check if a domain with matching slug already exists
• If exists: report it and ask user whether to update or abort
• Generate slug from concept: lowercase, replace spaces with hyphens, strip non-alphanumeric