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 componentpage-layout: Create page layoutstyling: Implement designsaccessibility-fix: Fix a11y issuesfrontend-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 endpointservice: Build microserviceintegration: Third-party API integrationauth: Authentication/authorizationbusiness-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 schemamigration: Create migrationquery-optimize: Optimize slow queriesindex: Add/optimize indexesdata-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 screennative-feature: Camera, GPS, biometricsoffline-sync: Offline data handlingpush-notification: Notification systemapp-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 specsdk-generate: Generate client SDKswebhook: Implement webhook systemapi-docs: Generate documentationversioning: 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 testsintegration-test: Write integration testse2e-test: Write E2E testsload-test: Performance/load testingtest-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 performancebenchmark: Create performance benchmarksoptimize: Optimize identified bottleneckcache-strategy: Design/implement cachingbundle-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 Dockerfilek8s-manifest: Write K8s manifestshelm-chart: Develop Helm chartsiac-review: Review Terraform/Pulumi codecontainer-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 pipelinecd-pipeline: Set up CD pipelineinfrastructure: Provision infrastructurecontainer: Dockerize applicationk8s: 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 scansvulnerability-fix: Fix vulnerabilitiespenetration-test: Conduct pen testcompliance-check: Verify compliancesecurity-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 monitoringdashboard: Create dashboardalert-rule: Define alert ruleslog-pipeline: Configure loggingtracing: 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 runbookauto-remediation: Script auto-fixincident-response: Handle incidentrca: Root cause analysispostmortem: 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 releasechangelog: Generate changelogfeature-flag: Implement feature flagcanary: Canary deploymentrollback: 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 spendingright-size: Optimize resourcesspot-strategy: Implement spot instancesbudget-alert: Set up alertscost-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 SLIserror-budget: Track and manage error budgetscapacity-plan: Plan for scalechaos-test: Run chaos experimentstoil-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 statepolicy-write: Write security policiescontrol-implement: Implement required controlsaudit-prep: Prepare for external auditevidence-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 pageseo: Optimize for searchblog-post: Write blog postemail-campaign: Create email sequencesocial-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 CRMoutreach: Create outreach sequencedemo-script: Write demo scriptproposal: Generate proposalpipeline: 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 billingpricing: Define pricing tiersinvoice: Generate invoicesfinancial-report: Create reportrunway: Calculate runway
Quality Checks:
- PCI compliance
- Invoices accurate
- Metrics tracked (MRR, ARR, churn)
- Runway > 6 months
biz-legal
Capabilities:
- Terms of Service
- Privacy Policy
- Cookie Policy
- GDPR compliance
- Contract templates
- IP protection
Task Types:
tos: Generate Terms of Serviceprivacy-policy: Create privacy policygdpr: Implement GDPR compliancecontract: Create contract templatecompliance: 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 documentationfaq: Create FAQchatbot: Configure chatbotticket-system: Set up supportonboarding: 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 descriptionrecruiting-setup: Set up recruiting pipelineinterview-design: Design interview processonboarding-docs: Create onboarding materialsculture-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 deckinvestor-update: Write monthly updatedata-room: Prepare data roomfinancial-model: Build financial modeldd-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 partnersintegration-partner: Technical integration partnershipco-marketing: Plan co-marketing campaignpartner-docs: Create partner documentationpartner-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 modelmodel-deploy: Deploy model to productionfeature-eng: Engineer featuresmodel-monitor: Set up model monitoringllm-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 pipelinedbt-model: Create dbt modeldata-quality: Implement data quality checkswarehouse-design: Design warehouse schemapipeline-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 dashboardmetrics-define: Define business metricsanalysis: Perform ad-hoc analysisself-serve: Set up self-serve analyticsreport: 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 requirementsuser-story: Create user storiesbacklog-groom: Groom and prioritize backlogroadmap: Update product roadmapspec: 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 systemprototype: Create Figma prototypeux-pattern: Define UX patternaccessibility: Ensure accessible designcomponent: 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 documentationuser-guide: Create user guiderelease-notes: Write release notestutorial: Create tutorialarchitecture-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 reviewreview-pr: Pull request reviewreview-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 reviewreview-requirements: Requirements alignment checkreview-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 reviewreview-auth: Authentication/authorization reviewreview-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 experimentviral-loop: Optimize viral coefficientreferral-program: Design referral systemactivation: Improve activation rateretention: 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 platformambassador: Create ambassador programevent: Plan community eventugc: Launch UGC programfeedback-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 scoringchurn-prevent: Churn prevention workflowexpansion: Identify expansion opportunitiesqbr: Prepare QBR materialsnps: 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 sequencein-app: Implement in-app messagingpush: Design push notification strategysegment: Create user segmentsre-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"
}