Slash Command475 repo starsupdated 2d ago

domain-add

Install in Claude Code

Copy

mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/catlog22/maestro-flow/HEAD/.claude/commands/domain-add.md -o ~/.claude/commands/domain-add.md

Then start a new Claude Code session; the slash command loads automatically.

Definition

domain-add.md

<purpose>
Register a domain term into `.workflow/domain/glossary.yaml`. Domain terms are automatically injected into agent context via hooks (domain-compact for all prompts, domain-expanded on keyword match).
</purpose>

<required_reading>
@~/.maestro/workflows/domain-add.md
</required_reading>

<context>
$ARGUMENTS -- expects `<canonical> "<definition>"`

**Examples:**
```bash
/domain-add auth-token "Short-lived credential for API authentication"
/domain-add event-bus "Central pub-sub message broker for cross-module communication"
/domain-add 会话上下文 "Runtime state container for active workflow session"
```

Domain term lifecycle: discover/manual → register → active → (optional) deprecated → removed.

**Related commands:**
- `maestro domain list` — list all registered terms
- `maestro domain discover` — scan codebase for term candidates
- `maestro domain show <canonical>` — show term details
- `maestro domain deprecate <canonical> --successor <new>` — deprecate a term
</context>

<execution>
Follow '~/.maestro/workflows/domain-add.md' completely.
</execution>

<error_codes>
| Code | Severity | Description | Stage |
|------|----------|-------------|-------|
| E001 | fatal | Canonical name and definition are both required | parse_input |
| E002 | fatal | `.workflow/domain/` not initialized — run `maestro domain init` first | validate |
| E003 | fatal | Term already registered with same canonical name | duplicate_check |
| E004 | warning | Near-match found — confirm merge or create new | duplicate_check |
</error_codes>

<success_criteria>
- [ ] Canonical name and definition parsed and validated
- [ ] No duplicate term in glossary (or user confirmed near-match)
- [ ] Aliases and keywords auto-extracted from definition
- [ ] Term written to glossary.yaml with tier and relationships
- [ ] Confirmation displayed with term details and verify command
</success_criteria>

<completion>
### Next-step routing

| Condition | Suggestion |
|-----------|-----------|
| Verify term added | `maestro domain show <canonical>` |
| Add more terms | `/domain-add <canonical> "<definition>"` |
| Discover candidates | `maestro domain discover` |
| List all terms | `maestro domain list` |
</completion>