/suggest-domain

Suggest Domain

Analyzes a rule and suggests the ideal SYNAPSE domain for it.

---

Purpose

Help users place rules in the most appropriate domain by analyzing the rule's content, matching it against existing domain keywords, and considering domain purposes.

---

Prerequisites

• `.synapse/manifest` exists
• At least one domain exists in `.synapse/`

---

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | `rule-text` | Yes | The rule text to analyze |

---

Steps

Step 1: Load Existing Domains

Read `.synapse/manifest` and build a list of all domains with their:

• Domain name and key
• RECALL keywords (from `{DOMAIN_KEY}_RECALL`)
• Current state (active/inactive)
• Rule count (from reading each domain file)

Step 2: Analyze Rule Content

Examine the rule text for:

• **Agent references:** mentions of `@dev`, `@qa`, `@architect`, etc. -> suggests agent-specific domain
• **Workflow references:** mentions of "story", "sprint", "review", "deploy" -> suggests workflow domain
• **Technical keywords:** "test", "lint", "commit", "branch" -> match against RECALL keywords
• **Domain-specific terms:** "security", "performance", "accessibility" -> match domain names

Step 3: Score Domains

For each existing domain, calculate a relevance score:

| Factor | Weight | Points | Description | |--------|--------|--------|-------------| | RECALL keyword match | High | 3 | Rule text contains a domain's RECALL keyword | | Domain name word match | Medium | 2 | Rule text contains words from domain name | | Agent trigger match | High | 3 | Rule mentions an agent that triggers a domain | | Existing rule similarity | Low | 1 | Rule is similar to existing rules in domain |

Sum the points for each domain. Maximum possible score is 9 (round up to 10 if all factors match). Present as `{score}/10`.

Step 4: Present Suggestion

Display the top suggestion(s):

Suggested domain for rule: "{rule-text}"

  1. {domain-name} (score: {score}/10)
     Reason: {justification}
     RECALL keywords: {keywords}
     Current rules: {count}

  2. {domain-name} (score: {score}/10)
     Reason: {justification}

  [NEW] Create new domain "{suggested-name}"
     If no existing domain fits well.

Step 5: Offer Quick Action (Optional)

After displaying the suggestion, offer:

Quick actions:
  1. Add rule to {suggested-domain} now
  2. Create new domain and add rule
  3. Cancel (do nothing)

If user selects 1: Follow the add-rule task for the suggested domain. If user selects 2: Follow the create-domain task, then add-rule. If user selects 3: Exit without changes.

---

Validation

• [ ] All existing domains loaded and analyzed
• [ ] Suggestion includes justification
• [ ] Score is based on keyword matching and domain analysis
• [ ] Quick action options work correctly if selected
• [ ] Handles case where no good match exists (suggests new domain)

---

Error Handling

| Error | Message | |-------|---------| | No domains exist | `No domains found in manifest. Use "create" to create your first domain.` | | Empty rule text | `Error: Please provide the rule text to analyze.` | | Manifest not found | `Error: .synapse/manifest not found. SYNAPSE must be initialized first.` |

---

*Suggest Domain — SYNAPSE CRUD Command C7* *Source: SYNAPSE-HOOK-SKILL-COMMAND-ANALYSIS.md section 2.3*