Domain Packs

Domain packs are npm packages that register specialized operations with the Soleri engine. Unlike knowledge packs (which add static vault entries), domain packs add algorithmic capabilities: operations that compute results, validate data, and enforce rules.

Domain packs are standalone community packages. They live in their own repositories, have their own release cycles, and are installed via npm. The Soleri engine provides the infrastructure (loader, types, runtime) but ships with zero domain-specific code.

Available packs

Discover available packs with npx @soleri/cli pack registry or install directly with npx @soleri/cli pack add <name>.

@soleri/domain-design

Design system intelligence with 45 operations across three facades.

Design facade (20 ops)

Operation	Type	What it does
check_contrast	Algorithmic	WCAG 2.1 contrast ratio check between two colors
get_color_pairs	Algorithmic	Suggest accessible foreground colors for a background
validate_token	Algorithmic	Validate a design token name against the token schema
validate_component_code	Algorithmic	Check component code for design system compliance
check_button_semantics	Algorithmic	Verify button variant matches its action intent
check_action_overflow	Algorithmic	Recommend buttons vs. dropdown menu based on action count
generate_image	LLM-dependent	Generate images via Google Gemini
get_typography_guidance	Data-serving	Typography scales, rules, and recommendations
get_spacing_guidance	Data-serving	Spacing system and scale guidance
get_icon_guidance	Data-serving	Icon usage patterns
get_animation_patterns	Data-serving	Animation and transition patterns
get_dark_mode_colors	Data-serving	Dark mode color mappings
get_responsive_patterns	Data-serving	Responsive design patterns
get_ux_law	Data-serving	UX laws and principles
get_guidance	Data-serving	General design guidance
recommend_style	Data-serving	Style recommendations
recommend_palette	Data-serving	Color palette recommendations
recommend_typography	Data-serving	Typography pairing suggestions
recommend_design_system	Data-serving	Design system recommendations
get_stack_guidelines	Data-serving	Stack-specific guidelines (React, Vue, Svelte, etc.)

Design Rules facade (15 ops)

Clean code rules, architecture patterns, variant philosophy, API constraints, stabilization patterns, delivery workflow, UX writing rules, performance constraints, component dev rules, defensive design rules, dialog patterns, component usage patterns, UI patterns, operational expertise, and error handling patterns.

Design Patterns facade (10 ops)

Container pattern recommendations, radius guidance, depth layering, component workflows, Storybook patterns, testing patterns, font requirements, shadcn components, plus orchestration packs for fix workflows and theming.

@soleri/domain-component

Component registry lifecycle with 7 operations.

Operation	Type	What it does
search	Data-serving	Search vault for components by query
get	Data-serving	Get a component by ID
list	Data-serving	List components with optional filters
create	Algorithmic	Register a new component with metadata
detect_drift	Algorithmic	Compare component code against stored vault metadata
analyze_dependencies	Algorithmic	Parse imports to build a dependency graph
sync_status	Algorithmic	Check sync between vault registry and filesystem

@soleri/domain-code-review

Code review intelligence with 8 operations split between GitHub PR review and Playwright validation.

GitHub-sourced ops (4)

Operation	What it does
review_pr_design	Review a PR diff for design-relevant issues (tokens, hex, inline styles)
check_architecture	Check imports for architecture boundary violations
search_review_context	Search knowledge base for review patterns matching a query
generate_review_summary	Generate a structured summary from an array of issues

Playwright-sourced ops (4)

Operation	What it does
validate_page_styles	Validate computed styles against design system scales
accessibility_audit	Audit accessibility data: missing labels, bad contrast, roles
classify_visual_changes	Classify style changes as cosmetic, structural, or behavioral
validate_component_states	Verify all required interaction states are implemented

@soleri/domain-design-qa

Design QA with 5 operations for handoff quality assurance.

Operation	What it does
detect_token_drift	Compare design tokens against a token map with fuzzy matching
detect_hardcoded_colors	Find hex colors that lack token mappings
sync_components	Match design components against code components by name
accessibility_precheck	WCAG contrast check on an array of color pairs
handoff_audit	Audit component metadata completeness with composite scoring

All ops process pre-extracted data, no external API calls required. The handoff_audit produces a composite score weighted 40% token drift, 30% component sync, 30% accessibility when full data is provided.

Installing domain packs

Domain packs are npm packages. Install them with the CLI or directly via npm:

# Via Soleri CLI
npx @soleri/cli pack add domain-design

# Or directly via npm
npm install @soleri/domain-design

Then add the pack to your agent.yaml:

packs:
  - name: design
    package: '@soleri/domain-design'

The engine discovers domain pack ops automatically when the pack is installed and the agent starts.

Creating your own domain pack

Scaffold a new pack with:

npx @soleri/cli pack create my-pack

This generates a complete repo with DomainPack interface, TypeScript config, tests, and CI workflow. See Creating Packs for the full authoring guide.

When to use domain packs vs. knowledge packs

Need	Use
Static patterns, rules, principles	Knowledge pack
Algorithmic validation and checks	Domain pack
Computed results (contrast ratios)	Domain pack
Best practices and anti-patterns	Knowledge pack
Both knowledge and operations	Domain pack with bundled knowledge

Domain packs can include bundled knowledge (the knowledge field in their manifest), so a single domain pack can provide both algorithmic ops and vault entries.

---

Next: Creating Packs for building your own packs. See also Skills Catalog for workflow skills, Capabilities for the full feature list, Extending Your Agent for custom ops and facades, and the CLI Reference for npx @soleri/cli pack and domain management commands.