# Subdomain Evolution Agent

> Create ontological propositions for the Genesis Semantic Design System when gaps are identified. Analyze existing variants, formulate semantic intents, and submit PRs to theme repository. Use when subdomain development reveals missing semantic patterns that can't be expressed with current ontological variants. Use when this capability is needed.

- Skill: `tomevault-io/subdomain-evolution-agent` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/subdomain-evolution-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/subdomain-evolution-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/subdomain-evolution-agent

---


# Subdomain Evolution Agent

**Role**: Ontological Proposition Creator  
**Scope**: Individual subdomain repositories  
**Version**: 2.1 - High-Density Refactor

## Purpose

Identify semantic gaps in Genesis Ontological Design System and create well-formed propositions for new variants. Acts as "local intelligence" observing real-world usage patterns.

## When to Use This Skill

Activate when:
- Implementing features that don't fit existing variants
- Repeatedly combining mixins the same way (missing abstraction)
- Writing raw CSS because no mixin exists
- Discovering semantic patterns used across multiple components
- Needing state/interaction/layout types not in current ontology

**Don't use for:**
- Visual preferences ("different color")
- One-off subdomain-specific features
- Patterns achievable with existing combinations

## Core Workflow

### 1. Verify Genuine Gap

**Checklist:**
- [ ] Reviewed all 41+ variants in INTEGRATION-GUIDE.md
- [ ] Attempted creative mixin combinations
- [ ] Confirmed represents WHAT (semantic), not HOW (visual)
- [ ] Pattern used 2+ places or universally applicable

**Quick Decision:**
```
Can combine existing mixins? → Use combination, no PR
About WHAT (semantic)? → Continue
Universal to ecosystem? → Create PR
```

→ **Complete analysis**: `references/PROPOSITION-GUIDE.md`

### 2. Determine Category

Which of 6 ontological categories?

1. **Environment** - Layout/arrangement patterns
2. **Entity** - Content weight/presence
3. **Cognition** - Typography/information type
4. **Synapse** - Interaction/navigation
5. **State** - Time-based/conditional states
6. **Atmosphere** - Emotional tone/vibe

→ **Category guide**: `/docs/specifications/scss-ontology-system.md`

### 3. Create Proposition

Use template: `.github/PULL_REQUEST_TEMPLATE/ontological_proposition.md`

**Required elements:**
- Source Node (subdomain name)
- Semantic Intent (WHAT it represents)
- Category + Suggested Label
- Use Cases (3+ concrete examples)
- Current Workaround (what you're doing now)

→ **Template & examples**: `references/PROPOSITION-GUIDE.md`

### 4. Submit PR

```bash
# Create branch
git checkout -b proposition/new-variant-name

# Submit to theme repo
# Theme Genome Agent will review
```

## Quality Guidelines

**Strong Proposition:**
- ✅ Semantic, not visual
- ✅ Universal applicability
- ✅ 3+ distinct use cases
- ✅ Clear category fit
- ✅ Demonstrates gap analysis

**Weak Proposition:**
- ❌ "I want blue buttons"
- ❌ Single subdomain use case
- ❌ Combinable with existing mixins
- ❌ Vague semantic intent

→ **Quality criteria**: `references/PROPOSITION-GUIDE.md`

## Common Patterns

**Valid Gaps:**
- Calculating/uncertain content → `state('computing')`
- Historical/archived data → `state('archived')`
- Real-time collaboration → `synapse('collaborate')`
- Social proof elements → `entity('testimonial')`

**Invalid (Use Existing):**
- "Larger text" → `cognition('axiom')` already scales
- "Blue background" → Use atmosphere combinations
- "Rounded corners" → Entity variants handle this

## Validation

Before submitting:
```bash
# Check theme repo builds
npm test

# Review existing variants
cat _sass/ontology/INTEGRATION-GUIDE.md | grep "genesis-"
```

## Resources

**Complete Proposition System**:
- `references/PROPOSITION-GUIDE.md` - **Complete proposition creation guide**
- `.github/PULL_REQUEST_TEMPLATE/ontological_proposition.md` - PR template

**Ontology Reference**:
- `/docs/specifications/ontology-html-mapping.md` - **Formal hierarchy rules and visual element ownership**
- `/docs/specifications/scss-ontology-system.md` - All 41+ variants, categories
- `_sass/ontology/INTEGRATION-GUIDE.md` - API reference
- `GENOME.md` - Variant evolution history
- `/docs/specifications/scss-styling.md` - SCSS patterns and standards

**Related**:
- `.github/skills/theme-genome-agent/SKILL.md` - Proposition review process
- `.github/AGENT-WORKFLOWS.md` - Workflow 1: Subdomain identifies gap
- `.github/docs/ontological-proposition-guide.md` - Proposition creation guide
- `/docs/specifications/github-copilot-agent-guidelines.md` - Agent standards

**Related Skills**: theme-genome-agent, scss-refactor-agent

---

**Version History**:
- **v2.1** (2026-02-10): High-density refactor - 366→148 lines, enhanced spec references
- **v2.0**: Initial subdomain evolution system

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/asisaga) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->