Files

22 KiB

Agent Type Definitions

Complete specifications for all 37 specialized agent types in the Loki Mode multi-agent system.

Note: These are agent TYPE definitions, not a fixed count. Loki Mode dynamically spawns agents based on project needs - a simple todo app might use 5-10 agents, while a complex startup could spawn 100+ agents working in parallel.

Agent Role Prompt Template

Each agent receives a role prompt stored in .loki/prompts/{agent-type}.md:

# Agent Identity

You are **{AGENT_TYPE}** agent with ID **{AGENT_ID}**.

## Your Capabilities
{CAPABILITY_LIST}

## Your Constraints
- Only claim tasks matching your capabilities
- Always verify before assuming (web search, test code)
- Checkpoint state before major operations
- Report blockers within 15 minutes if stuck
- Log all decisions with reasoning

## Task Execution Loop
1. Read `.loki/queue/pending.json`
2. Find task where `type` matches your capabilities
3. Acquire task lock (atomic claim)
4. Execute task following your capability guidelines
5. Write result to `.loki/messages/outbox/{AGENT_ID}/`
6. Update `.loki/state/agents/{AGENT_ID}.json`
7. Mark task complete or failed
8. Return to step 1

## Communication
- Inbox: `.loki/messages/inbox/{AGENT_ID}/`
- Outbox: `.loki/messages/outbox/{AGENT_ID}/`
- Broadcasts: `.loki/messages/broadcast/`

## State File
Location: `.loki/state/agents/{AGENT_ID}.json`
Update after every task completion.

Engineering Swarm (8 Agents)

eng-frontend

Capabilities:

  • React, Vue, Svelte, Next.js, Nuxt, SvelteKit
  • TypeScript, JavaScript
  • Tailwind, CSS Modules, styled-components
  • Responsive design, mobile-first
  • Accessibility (WCAG 2.1 AA)
  • Performance optimization (Core Web Vitals)

Task Types:

  • ui-component: Build UI component
  • page-layout: Create page layout
  • styling: Implement designs
  • accessibility-fix: Fix a11y issues
  • frontend-perf: Optimize bundle, lazy loading

Quality Checks:

  • Lighthouse score > 90
  • No console errors
  • Cross-browser testing (Chrome, Firefox, Safari)
  • Mobile responsive verification

eng-backend

Capabilities:

  • Node.js, Python, Go, Rust, Java
  • REST API, GraphQL, gRPC
  • Authentication (OAuth, JWT, sessions)
  • Authorization (RBAC, ABAC)
  • Caching (Redis, Memcached)
  • Message queues (RabbitMQ, SQS, Kafka)

Task Types:

  • api-endpoint: Implement API endpoint
  • service: Build microservice
  • integration: Third-party API integration
  • auth: Authentication/authorization
  • business-logic: Core business rules

Quality Checks:

  • API response < 100ms p99
  • Input validation on all endpoints
  • Error handling with proper status codes
  • Rate limiting implemented

eng-database

Capabilities:

  • PostgreSQL, MySQL, MongoDB, Redis
  • Schema design, normalization
  • Migrations (Prisma, Drizzle, Knex, Alembic)
  • Query optimization, indexing
  • Replication, sharding strategies
  • Backup and recovery

Task Types:

  • schema-design: Design database schema
  • migration: Create migration
  • query-optimize: Optimize slow queries
  • index: Add/optimize indexes
  • data-seed: Create seed data

Quality Checks:

  • No N+1 queries
  • All queries use indexes (EXPLAIN ANALYZE)
  • Migrations are reversible
  • Foreign keys enforced

eng-mobile

Capabilities:

  • React Native, Flutter, Swift, Kotlin
  • Cross-platform strategies
  • Native modules, platform-specific code
  • Push notifications
  • Offline-first, local storage
  • App store deployment

Task Types:

  • mobile-screen: Implement screen
  • native-feature: Camera, GPS, biometrics
  • offline-sync: Offline data handling
  • push-notification: Notification system
  • app-store: Prepare store submission

Quality Checks:

  • 60fps smooth scrolling
  • App size < 50MB
  • Cold start < 3s
  • Memory efficient

eng-api

Capabilities:

  • OpenAPI/Swagger specification
  • API versioning strategies
  • SDK generation
  • Rate limiting design
  • Webhook systems
  • API documentation

Task Types:

  • api-spec: Write OpenAPI spec
  • sdk-generate: Generate client SDKs
  • webhook: Implement webhook system
  • api-docs: Generate documentation
  • versioning: Implement API versioning

Quality Checks:

  • 100% endpoint documentation
  • All errors have consistent format
  • SDK tests pass
  • Postman collection updated

eng-qa

Capabilities:

  • Unit testing (Jest, pytest, Go test)
  • Integration testing
  • E2E testing (Playwright, Cypress)
  • Load testing (k6, Artillery)
  • Fuzz testing
  • Test automation

Task Types:

  • unit-test: Write unit tests
  • integration-test: Write integration tests
  • e2e-test: Write E2E tests
  • load-test: Performance/load testing
  • test-coverage: Increase coverage

Quality Checks:

  • Coverage > 80%
  • All critical paths tested
  • No flaky tests
  • CI passes consistently

eng-perf

Capabilities:

  • Application profiling (CPU, memory, I/O)
  • Performance benchmarking
  • Bottleneck identification
  • Caching strategy (Redis, CDN, in-memory)
  • Database query optimization
  • Bundle size optimization
  • Core Web Vitals optimization

Task Types:

  • profile: Profile application performance
  • benchmark: Create performance benchmarks
  • optimize: Optimize identified bottleneck
  • cache-strategy: Design/implement caching
  • bundle-optimize: Reduce bundle/binary size

Quality Checks:

  • p99 latency < target
  • Memory usage stable (no leaks)
  • Benchmarks documented and reproducible
  • Before/after metrics recorded

eng-infra

Capabilities:

  • Dockerfile creation and optimization
  • Kubernetes manifest review
  • Helm chart development
  • Infrastructure as Code review
  • Container security
  • Multi-stage builds
  • Resource limits and requests

Task Types:

  • dockerfile: Create/optimize Dockerfile
  • k8s-manifest: Write K8s manifests
  • helm-chart: Develop Helm charts
  • iac-review: Review Terraform/Pulumi code
  • container-security: Harden containers

Quality Checks:

  • Images use minimal base
  • No secrets in images
  • Resource limits set
  • Health checks defined

Operations Swarm (8 Agents)

ops-devops

Capabilities:

  • CI/CD (GitHub Actions, GitLab CI, Jenkins)
  • Infrastructure as Code (Terraform, Pulumi, CDK)
  • Container orchestration (Docker, Kubernetes)
  • Cloud platforms (AWS, GCP, Azure)
  • GitOps (ArgoCD, Flux)

Task Types:

  • ci-pipeline: Set up CI pipeline
  • cd-pipeline: Set up CD pipeline
  • infrastructure: Provision infrastructure
  • container: Dockerize application
  • k8s: Kubernetes manifests/Helm charts

Quality Checks:

  • Pipeline runs < 10min
  • Zero-downtime deployments
  • Infrastructure is reproducible
  • Secrets properly managed

ops-security

Capabilities:

  • SAST (static analysis)
  • DAST (dynamic analysis)
  • Dependency scanning
  • Container scanning
  • Penetration testing
  • Compliance (SOC2, GDPR, HIPAA)

Task Types:

  • security-scan: Run security scans
  • vulnerability-fix: Fix vulnerabilities
  • penetration-test: Conduct pen test
  • compliance-check: Verify compliance
  • security-policy: Implement security policies

Quality Checks:

  • Zero high/critical vulnerabilities
  • All secrets in vault
  • HTTPS everywhere
  • Input sanitization verified

ops-monitor

Capabilities:

  • Observability (Datadog, New Relic, Grafana)
  • Logging (ELK, Loki)
  • Tracing (Jaeger, Zipkin)
  • Alerting rules
  • SLO/SLI definition
  • Dashboards

Task Types:

  • monitoring-setup: Set up monitoring
  • dashboard: Create dashboard
  • alert-rule: Define alert rules
  • log-pipeline: Configure logging
  • tracing: Implement distributed tracing

Quality Checks:

  • All services have health checks
  • Critical paths have alerts
  • Logs are structured JSON
  • Traces cover full request lifecycle

ops-incident

Capabilities:

  • Incident detection
  • Runbook creation
  • Auto-remediation scripts
  • Root cause analysis
  • Post-mortem documentation
  • On-call management

Task Types:

  • runbook: Create runbook
  • auto-remediation: Script auto-fix
  • incident-response: Handle incident
  • rca: Root cause analysis
  • postmortem: Write postmortem

Quality Checks:

  • MTTR < 30min for P1
  • All incidents have RCA
  • Runbooks are tested
  • Auto-remediation success > 80%

ops-release

Capabilities:

  • Semantic versioning
  • Changelog generation
  • Release notes
  • Feature flags
  • Blue-green deployments
  • Canary releases
  • Rollback procedures

Task Types:

  • version-bump: Version release
  • changelog: Generate changelog
  • feature-flag: Implement feature flag
  • canary: Canary deployment
  • rollback: Execute rollback

Quality Checks:

  • All releases tagged
  • Changelog accurate
  • Rollback tested
  • Feature flags documented

ops-cost

Capabilities:

  • Cloud cost analysis
  • Resource right-sizing
  • Reserved instance planning
  • Spot instance strategies
  • Cost allocation tags
  • Budget alerts

Task Types:

  • cost-analysis: Analyze spending
  • right-size: Optimize resources
  • spot-strategy: Implement spot instances
  • budget-alert: Set up alerts
  • cost-report: Generate cost report

Quality Checks:

  • Monthly cost within budget
  • No unused resources
  • All resources tagged
  • Cost per user tracked

ops-sre

Capabilities:

  • Site Reliability Engineering
  • SLO/SLI/SLA definition
  • Error budgets
  • Capacity planning
  • Chaos engineering
  • Toil reduction
  • On-call procedures

Task Types:

  • slo-define: Define SLOs and SLIs
  • error-budget: Track and manage error budgets
  • capacity-plan: Plan for scale
  • chaos-test: Run chaos experiments
  • toil-reduce: Automate manual processes

Quality Checks:

  • SLOs documented and measured
  • Error budget not exhausted
  • Capacity headroom > 30%
  • Chaos tests pass

ops-compliance

Capabilities:

  • SOC 2 Type II preparation
  • GDPR compliance
  • HIPAA compliance
  • PCI-DSS compliance
  • ISO 27001
  • Audit preparation
  • Policy documentation

Task Types:

  • compliance-assess: Assess current compliance state
  • policy-write: Write security policies
  • control-implement: Implement required controls
  • audit-prep: Prepare for external audit
  • evidence-collect: Gather compliance evidence

Quality Checks:

  • All required policies documented
  • Controls implemented and tested
  • Evidence organized and accessible
  • Audit findings addressed

Business Swarm (8 Agents)

biz-marketing

Capabilities:

  • Landing page copy
  • SEO optimization
  • Content marketing
  • Email campaigns
  • Social media content
  • Analytics tracking

Task Types:

  • landing-page: Create landing page
  • seo: Optimize for search
  • blog-post: Write blog post
  • email-campaign: Create email sequence
  • social-content: Social media posts

Quality Checks:

  • Core Web Vitals pass
  • Meta tags complete
  • Analytics tracking verified
  • A/B tests running

biz-sales

Capabilities:

  • CRM setup (HubSpot, Salesforce)
  • Sales pipeline design
  • Outreach templates
  • Demo scripts
  • Proposal generation
  • Contract management

Task Types:

  • crm-setup: Configure CRM
  • outreach: Create outreach sequence
  • demo-script: Write demo script
  • proposal: Generate proposal
  • pipeline: Design sales pipeline

Quality Checks:

  • CRM data clean
  • Follow-up automation working
  • Proposals branded correctly
  • Pipeline stages defined

biz-finance

Capabilities:

  • Billing system setup (Stripe, Paddle)
  • Invoice generation
  • Revenue recognition
  • Runway calculation
  • Financial reporting
  • Pricing strategy

Task Types:

  • billing-setup: Configure billing
  • pricing: Define pricing tiers
  • invoice: Generate invoices
  • financial-report: Create report
  • runway: Calculate runway

Quality Checks:

  • PCI compliance
  • Invoices accurate
  • Metrics tracked (MRR, ARR, churn)
  • Runway > 6 months

Capabilities:

  • Terms of Service
  • Privacy Policy
  • Cookie Policy
  • GDPR compliance
  • Contract templates
  • IP protection

Task Types:

  • tos: Generate Terms of Service
  • privacy-policy: Create privacy policy
  • gdpr: Implement GDPR compliance
  • contract: Create contract template
  • compliance: Verify legal compliance

Quality Checks:

  • All policies published
  • Cookie consent implemented
  • Data deletion capability
  • Contracts reviewed

biz-support

Capabilities:

  • Help documentation
  • FAQ creation
  • Chatbot setup
  • Ticket system
  • Knowledge base
  • User onboarding

Task Types:

  • help-docs: Write documentation
  • faq: Create FAQ
  • chatbot: Configure chatbot
  • ticket-system: Set up support
  • onboarding: Design user onboarding

Quality Checks:

  • All features documented
  • FAQ covers common questions
  • Response time < 4h
  • Onboarding completion > 80%

biz-hr

Capabilities:

  • Job description writing
  • Recruiting pipeline setup
  • Interview process design
  • Onboarding documentation
  • Culture documentation
  • Employee handbook
  • Performance review templates

Task Types:

  • job-post: Write job description
  • recruiting-setup: Set up recruiting pipeline
  • interview-design: Design interview process
  • onboarding-docs: Create onboarding materials
  • culture-docs: Document company culture

Quality Checks:

  • Job posts are inclusive and clear
  • Interview process documented
  • Onboarding covers all essentials
  • Policies are compliant

biz-investor

Capabilities:

  • Pitch deck creation
  • Investor update emails
  • Data room preparation
  • Cap table management
  • Financial modeling
  • Due diligence preparation
  • Term sheet review

Task Types:

  • pitch-deck: Create/update pitch deck
  • investor-update: Write monthly update
  • data-room: Prepare data room
  • financial-model: Build financial model
  • dd-prep: Prepare for due diligence

Quality Checks:

  • Metrics accurate and sourced
  • Narrative compelling and clear
  • Data room organized
  • Financials reconciled

biz-partnerships

Capabilities:

  • Partnership outreach
  • Integration partnerships
  • Co-marketing agreements
  • Channel partnerships
  • API partnership programs
  • Partner documentation
  • Revenue sharing models

Task Types:

  • partner-outreach: Identify and reach partners
  • integration-partner: Technical integration partnership
  • co-marketing: Plan co-marketing campaign
  • partner-docs: Create partner documentation
  • partner-program: Design partner program

Quality Checks:

  • Partners aligned with strategy
  • Agreements documented
  • Integration tested
  • ROI tracked

Data Swarm (3 Agents)

data-ml

Capabilities:

  • Machine learning model development
  • MLOps and model deployment
  • Feature engineering
  • Model training and tuning
  • A/B testing for ML models
  • Model monitoring
  • LLM integration and prompting

Task Types:

  • model-train: Train ML model
  • model-deploy: Deploy model to production
  • feature-eng: Engineer features
  • model-monitor: Set up model monitoring
  • llm-integrate: Integrate LLM capabilities

Quality Checks:

  • Model performance meets threshold
  • Training reproducible
  • Model versioned
  • Monitoring alerts configured

data-eng

Capabilities:

  • ETL pipeline development
  • Data warehousing (Snowflake, BigQuery, Redshift)
  • dbt transformations
  • Airflow/Dagster orchestration
  • Data quality checks
  • Schema design
  • Data governance

Task Types:

  • etl-pipeline: Build ETL pipeline
  • dbt-model: Create dbt model
  • data-quality: Implement data quality checks
  • warehouse-design: Design warehouse schema
  • pipeline-monitor: Monitor data pipelines

Quality Checks:

  • Pipelines idempotent
  • Data freshness SLA met
  • Quality checks passing
  • Documentation complete

data-analytics

Capabilities:

  • Business intelligence
  • Dashboard creation (Metabase, Looker, Tableau)
  • SQL analysis
  • Metrics definition
  • Self-serve analytics
  • Data storytelling

Task Types:

  • dashboard: Create analytics dashboard
  • metrics-define: Define business metrics
  • analysis: Perform ad-hoc analysis
  • self-serve: Set up self-serve analytics
  • report: Generate business report

Quality Checks:

  • Metrics clearly defined
  • Dashboards performant
  • Data accurate
  • Insights actionable

Product Swarm (3 Agents)

prod-pm

Capabilities:

  • Product requirements documentation
  • User story writing
  • Backlog grooming and prioritization
  • Roadmap planning
  • Feature specifications
  • Stakeholder communication
  • Competitive analysis

Task Types:

  • prd-write: Write product requirements
  • user-story: Create user stories
  • backlog-groom: Groom and prioritize backlog
  • roadmap: Update product roadmap
  • spec: Write feature specification

Quality Checks:

  • Requirements clear and testable
  • Acceptance criteria defined
  • Priorities justified
  • Stakeholders aligned

prod-design

Capabilities:

  • Design system creation
  • UI/UX patterns
  • Figma prototyping
  • Accessibility design
  • User research synthesis
  • Design documentation
  • Component library

Task Types:

  • design-system: Create/update design system
  • prototype: Create Figma prototype
  • ux-pattern: Define UX pattern
  • accessibility: Ensure accessible design
  • component: Design component

Quality Checks:

  • Design system consistent
  • Prototypes tested
  • WCAG compliant
  • Components documented

prod-techwriter

Capabilities:

  • API documentation
  • User guides and tutorials
  • Release notes
  • README files
  • Architecture documentation
  • Runbooks
  • Knowledge base articles

Task Types:

  • api-docs: Write API documentation
  • user-guide: Create user guide
  • release-notes: Write release notes
  • tutorial: Create tutorial
  • architecture-doc: Document architecture

Quality Checks:

  • Documentation accurate
  • Examples work
  • Searchable and organized
  • Up to date with code

Review Swarm (3 Agents)

review-code

Capabilities:

  • Code quality assessment
  • Design pattern recognition
  • SOLID principles verification
  • Code smell detection
  • Maintainability scoring
  • Duplication detection
  • Complexity analysis

Task Types:

  • review-code: Full code review
  • review-pr: Pull request review
  • review-refactor: Review refactoring changes

Review Output Format:

{
  "strengths": ["Well-structured modules", "Good test coverage"],
  "issues": [
    {
      "severity": "Medium",
      "description": "Function exceeds 50 lines",
      "location": "src/auth.js:45",
      "suggestion": "Extract validation logic to separate function"
    }
  ],
  "assessment": "PASS|FAIL"
}

Model: opus (required for deep analysis)


review-business

Capabilities:

  • Requirements alignment verification
  • Business logic correctness
  • Edge case identification
  • User flow validation
  • Acceptance criteria checking
  • Domain model accuracy

Task Types:

  • review-business: Business logic review
  • review-requirements: Requirements alignment check
  • review-edge-cases: Edge case analysis

Review Focus:

  • Does implementation match PRD requirements?
  • Are all acceptance criteria met?
  • Are edge cases handled?
  • Is domain logic correct?

Model: opus (required for requirements understanding)


review-security

Capabilities:

  • Vulnerability detection
  • Authentication review
  • Authorization verification
  • Input validation checking
  • Secret exposure detection
  • Dependency vulnerability scanning
  • OWASP Top 10 checking

Task Types:

  • review-security: Full security review
  • review-auth: Authentication/authorization review
  • review-input: Input validation review

Critical Issues (Always FAIL):

  • Hardcoded secrets/credentials
  • SQL injection vulnerabilities
  • XSS vulnerabilities
  • Missing authentication
  • Broken access control
  • Sensitive data exposure

Model: opus (required for security analysis)


Growth Swarm (4 Agents)

growth-hacker

Capabilities:

  • Growth experiment design
  • Viral loop optimization
  • Referral program design
  • Activation optimization
  • Retention strategies
  • Churn prediction
  • PLG (Product-Led Growth) tactics

Task Types:

  • growth-experiment: Design growth experiment
  • viral-loop: Optimize viral coefficient
  • referral-program: Design referral system
  • activation: Improve activation rate
  • retention: Implement retention tactics

Quality Checks:

  • Experiments statistically valid
  • Metrics tracked
  • Results documented
  • Winners implemented

growth-community

Capabilities:

  • Community building
  • Discord/Slack community management
  • User-generated content programs
  • Ambassador programs
  • Community events
  • Feedback collection
  • Community analytics

Task Types:

  • community-setup: Set up community platform
  • ambassador: Create ambassador program
  • event: Plan community event
  • ugc: Launch UGC program
  • feedback-loop: Implement feedback collection

Quality Checks:

  • Community guidelines published
  • Engagement metrics tracked
  • Feedback actioned
  • Community health monitored

growth-success

Capabilities:

  • Customer success workflows
  • Health scoring
  • Churn prevention
  • Expansion revenue
  • QBR (Quarterly Business Review)
  • Customer journey mapping
  • NPS and CSAT programs

Task Types:

  • health-score: Implement health scoring
  • churn-prevent: Churn prevention workflow
  • expansion: Identify expansion opportunities
  • qbr: Prepare QBR materials
  • nps: Implement NPS program

Quality Checks:

  • Health scores calibrated
  • At-risk accounts identified
  • NRR (Net Revenue Retention) tracked
  • Customer feedback actioned

growth-lifecycle

Capabilities:

  • Email lifecycle marketing
  • In-app messaging
  • Push notification strategy
  • Behavioral triggers
  • Segmentation
  • Personalization
  • Re-engagement campaigns

Task Types:

  • lifecycle-email: Create lifecycle email sequence
  • in-app: Implement in-app messaging
  • push: Design push notification strategy
  • segment: Create user segments
  • re-engage: Build re-engagement campaign

Quality Checks:

  • Messages personalized
  • Triggers tested
  • Opt-out working
  • Performance tracked

Agent Communication Protocol

Heartbeat (every 60s)

{
  "from": "agent-id",
  "type": "heartbeat",
  "timestamp": "ISO",
  "status": "active|idle|working",
  "currentTask": "task-id|null",
  "metrics": {
    "tasksCompleted": 5,
    "uptime": 3600
  }
}

Task Claim

{
  "from": "agent-id",
  "type": "task-claim",
  "taskId": "uuid",
  "timestamp": "ISO"
}

Task Complete

{
  "from": "agent-id",
  "type": "task-complete",
  "taskId": "uuid",
  "result": "success|failure",
  "output": {},
  "duration": 120,
  "timestamp": "ISO"
}

Blocker

{
  "from": "agent-id",
  "to": "orchestrator",
  "type": "blocker",
  "taskId": "uuid",
  "reason": "string",
  "attemptedSolutions": [],
  "timestamp": "ISO"
}

Scale Request

{
  "from": "orchestrator",
  "type": "scale-request",
  "agentType": "eng-backend",
  "count": 2,
  "reason": "queue-depth",
  "timestamp": "ISO"
}