Skip to content

Conversation

@justtorrell
Copy link
Collaborator

@justtorrell justtorrell commented Sep 4, 2025

This PR introduces a new specialized Claude subagent for comprehensive Ash Framework
expertise, focusing on modern Ash 3.0+ patterns, code quality enforcement, and architectural
guidance - ST0019

Key Features

4-Tier Expertise System:

  • Tier 1 - Critical Quality Gates: Detect Ecto/Ash anti-patterns, validate resource
    definitions, prevent runtime errors
  • Tier 2 - Modern Pattern Promotion: Suggest bulk operations, atomic updates,
    domain-driven design
  • Tier 3 - Development Quality: Migration guidance, test templates, error handling
  • Tier 4 - Advanced Scenarios: Multi-resource transactions, change tracking, code
    interfaces

Core Capabilities:

  • Catches direct Ecto queries bypassing Ash (Repo.all, Repo.get, etc.)
  • Promotes Ash 3.0+ features like bulk operations and atomic updates
  • Provides concrete code examples and transformations
  • References Intent documentation at intent/docs/ref/ash/
  • Acts as "strict but helpful mentor" for quality enforcement

Integration

The ash-expert agent integrates seamlessly with existing Intent agents:

  • Works alongside elixir agent for broader Elixir patterns
  • Complements worker-bee agent for WDD architecture compliance
  • Leverages intent agent for steel thread methodology
  • References project-specific Ash documentation and usage rules

Files Changed

  • Added intent/plugins/claude/subagents/ash-expert/agent.md - Main agent definition
  • Added intent/plugins/claude/subagents/ash-expert/metadata.json - Agent metadata
  • Updated intent/plugins/claude/subagents/.manifest/global-agents.json - Registry
  • Updated intent/llm/AGENTS.md - Documentation with new agent description
  • Created intent/llm/AGENTS.md.bak - Backup of previous version

This agent fills a critical gap in providing specialized Ash framework expertise while
maintaining consistency with Intent's development methodology and existing agent ecosystem.

Introduces a new specialized Claude subagent for comprehensive Ash Framework expertise,
focusing on modern Ash 3.0+ patterns, code quality enforcement, and architectural guidance.

Key capabilities:
- Critical quality gates: Detect Ecto/Ash anti-patterns, validate resource definitions
- Modern pattern promotion: Suggest bulk operations, atomic updates, domain-driven design
- Performance optimization: Identify N+1 queries, recommend calculations and aggregations
- Migration guidance: Help with ash_postgres patterns and constraint management
- 4-tier expertise system from critical fixes to advanced transaction patterns

The agent acts as a "strict but helpful mentor" to:
- Enforce Ash principles and prevent common mistakes
- Promote Ash 3.0+ features over legacy patterns
- Provide concrete code examples and transformations
- Reference Intent documentation at intent/docs/ref/ash/

Integrates with existing Intent agents (elixir, worker-bee) to provide
specialized Ash framework knowledge while maintaining consistency with
Worker-Bee Driven Design patterns and Elixir Usage Rules.
Complete documentation of the ash-expert agent creation process, including:
- Design decisions and 4-tier expertise architecture
- Implementation details and technical specifications
- Comprehensive task breakdown (9 phases, 44 tasks)
- Integration with Intent's agent ecosystem
@justtorrell justtorrell changed the title Add ash-expert: Modern Ash 3.0+ code quality specialist ST0019 - Add ash-expert: Modern Ash 3.0+ code quality specialist Sep 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants