Files
antigravity-skills-reference/skills/loki-mode/references/agents.md

1044 lines
22 KiB
Markdown

# 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`:
```markdown
# 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
---
### biz-legal
**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:**
```json
{
"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)
```json
{
"from": "agent-id",
"type": "heartbeat",
"timestamp": "ISO",
"status": "active|idle|working",
"currentTask": "task-id|null",
"metrics": {
"tasksCompleted": 5,
"uptime": 3600
}
}
```
### Task Claim
```json
{
"from": "agent-id",
"type": "task-claim",
"taskId": "uuid",
"timestamp": "ISO"
}
```
### Task Complete
```json
{
"from": "agent-id",
"type": "task-complete",
"taskId": "uuid",
"result": "success|failure",
"output": {},
"duration": 120,
"timestamp": "ISO"
}
```
### Blocker
```json
{
"from": "agent-id",
"to": "orchestrator",
"type": "blocker",
"taskId": "uuid",
"reason": "string",
"attemptedSolutions": [],
"timestamp": "ISO"
}
```
### Scale Request
```json
{
"from": "orchestrator",
"type": "scale-request",
"agentType": "eng-backend",
"count": 2,
"reason": "queue-depth",
"timestamp": "ISO"
}
```