luum-home/luum-cognitive-os/domain-model

Domain Model Scaffolder

Scaffolds docs/03-domain-risk/domain-model.md in an adopting project. This is a template scaffolder, not a content generator — it emits structured markdown with <!-- TODO --> markers that humans or downstream agents fill in.

Scope

• Creates or extends ONE file: <project>/docs/03-domain-risk/domain-model.md
• Idempotent: re-running preserves user edits placed below the <!-- domain-model:autogen-footer --> marker
• --overwrite replaces the entire file

Invocation

uv run python3 scripts/domain_model.py \
  --project-dir /path/to/adopter-project \
  --brief "Describe the domain in one sentence"

Outputs

A markdown file with these sections (all TODO-filled):

• Brief (verbatim insertion of --brief)
• Bounded Contexts (table)
• Core Entities (aggregate root + invariants)
• Value Objects
• Domain Events
• Ubiquitous Language glossary

Idempotency contract

1. First run creates the file.
2. Second run without --overwrite replaces only the auto-generated header→footer block; content below the footer marker is preserved.
3. Second run with --overwrite replaces the entire file.
4. If the file exists but has no autogen markers (user-authored from scratch), the tool skips — does not destroy user content.

NOT in scope

• Generating domain content from prose descriptions (would require an LLM call; out of scope for a scaffolder).
• Modifying any file outside docs/03-domain-risk/.

Integration

• Pairs with /project-scaffold (ADR-054) which creates the 10-category skeleton first.
• Pairs with /risk-register for the second file under 03-domain-risk/.

Verification

uv run python3 scripts/domain_model.py --project-dir /tmp/test-dm --brief "simple ecommerce" --json
test -f /tmp/test-dm/docs/03-domain-risk/domain-model.md
grep -q "Bounded Contexts" /tmp/test-dm/docs/03-domain-risk/domain-model.md