# Ground Domain Evolution

> Domain evolution. Refactor structure as understanding deepens.

- Skill: `attac-t/ground-domain-evolution` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add attac-t/ground-domain-evolution`
- Raw SKILL.md: https://api.skillmd.com/api/skills/attac-t/ground-domain-evolution/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: attac-t (https://skillmd.com/u/attac-t)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/attac-t/ground-domain-evolution

---


# Skill: Domain Evolution

> "Don't fear changes—iteration is healthy."

## The Standard

- **Domains Change**: Your first structure won't be your last.
- **Refactor Without Fear**: Good tests enable structural changes.
- **Split When Large**: A growing domain means multiple domains.
- **Merge When Tiny**: Too granular = too much overhead.

## The Check

Ask yourself:
- Has this domain grown beyond its original purpose?
- Are there 2+ distinct concepts sharing a namespace?
- Is this domain so small it's just ceremony?
- Has my understanding of the business changed?

## The Protocol

1. **Start Coarse**: Begin with fewer, larger domains.
2. **Observe Pain**: Note when a domain feels "off".
3. **Split Deliberately**: Extract sub-domain when clear boundary emerges.
4. **Document Why**: ADR the restructure decision.

## Real-World Examples

See [examples.md](examples.md).

