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

# 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:

# 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 — claim your Tome and manage your conversions.