ai-agent-team

40 specialized AI agents for software engineering, orchestrated by a Manager agent. Works with opencode, Claude Code, Cursor, Windsurf, or any project-local setup.

Quick Start

Option 1: Universal Installer (recommended)

# For opencode (default)
curl -sSL https://raw.githubusercontent.com/NabilJint/ai-agent-team/main/scripts/install.sh | bash

# For project-local (any framework)
curl -sSL https://raw.githubusercontent.com/NabilJint/ai-agent-team/main/scripts/install.sh | bash -s ./project/.agents project

# For Claude Code
curl -sSL https://raw.githubusercontent.com/NabilJint/ai-agent-team/main/scripts/install.sh | bash -s ~/.claude claude

Option 2: Manual Install

git clone https://github.com/NabilJint/ai-agent-team.git
cp -r ai-agent-team/agents/* ~/.config/opencode/agent/
cp -r ai-agent-team/skills/* ~/.config/opencode/skills/
cp -r ai-agent-team/templates/* ~/.config/opencode/templates/

Agent Team Overview (40 Agents)

Core Orchestration

| Agent | Role | Mode | |-------|------|------| | manager | Primary orchestrator — routes ALL requests | primary | | prompt-engineer | Turns requests into detailed implementation prompts | subagent | | ceo-assistant | Executive summaries, decision briefs, scheduling | subagent |

Engineering Specialists (18)

| Agent | Domain | |-------|--------| | software-architect | System design, ADRs, API contracts, tech stack | | backend-engineer | APIs, server logic, databases, auth | | frontend-engineer | React/Next.js/UI components, state, performance | | mobile-engineer | iOS/Android/React Native/Flutter | | devops-engineer | CI/CD, IaC, Kubernetes, monitoring | | database-engineer | Schema, migrations, queries, optimization | | platform-engineer | Internal tools, CLIs, golden paths, DX | | ai-ml-engineer | ML models, prompt pipelines, RAG, embeddings | | mlops-engineer | Model deployment, monitoring, pipelines, A/B tests | | data-engineer | ETL/ELT, warehouses, streaming, dbt, Airflow | | integration-engineer | Third-party APIs, webhooks, OAuth, sync pipelines | | realtime-engineer | WebSockets, presence, CRDTs, collaborative editing | | observability-engineer | Logs, metrics, traces, SLOs, OpenTelemetry | | ai-safety-engineer | Guardrails, evals, red-teaming, alignment | | security-engineer | Threat modeling, auth/z, vuln scanning, secrets | | performance-engineer | Latency, throughput, profiling, bottlenecks | | finops-engineer | Cloud costs, token budgets, rightsizing, anomalies | | qa-engineer | Test plans, automation, coverage, bug reports |

Product & Design (7)

| Agent | Domain | |-------|--------| | product-manager | PRDs, roadmap, prioritization, metrics | | project-manager | Sprints, tickets, dependencies, tracking | | business-analyst | Requirements, user stories, edge cases | | ux-researcher | Interviews, surveys, usability, personas | | ui-ux-designer | Wireframes, design systems, interactions | | brand-designer | Visual identity, logos, brand guidelines | | technical-writer | API docs, guides, README, changelogs |

Content & Marketing (4)

| Agent | Domain | |-------|--------| | content-writer | Blog posts, landing pages, marketing copy | | marketing-strategist | GTM, positioning, channel strategy | | seo-specialist | Keywords, on-page SEO, technical audits | | personal-linkedin-writer | First-person technical LinkedIn posts |

Support & Governance (4)

| Agent | Domain | |-------|--------| | code-reviewer | Pre-merge code quality, style, bugs | | release-manager | Versioning, rollout, rollback, release notes | | customer-success | Support responses, FAQ, feedback synthesis | | legal-compliance | GDPR, privacy, ToS, licensing, regulatory |

Strategic Advisors (2 Personas)

| Agent | Trigger Keywords | Permissions | |-------|------------------|-------------| | elon-musk | first principles, moonshot, 10x, physics, vertical integration | webfetch only | | mark-zuckerberg | network effects, platform, distribution, open source, flywheel | webfetch only |

Utility (5)

| Agent | Domain | |-------|--------| | skill-developer | Creates new skills/agents | | analytics-engineer | Event tracking, dashboards, metrics | | docs-memory-agent | Logs outcomes to docs/agents/memory-log.md | | prompt-engineer | Optimizes prompts for all agents | | tool-runner | CLI operations, installs, builds |

How It Works

User Request
    │
    ▼
┌─────────────────────────────────────┐
│        MANAGER (primary)            │
│  • Reads AGENTS.md                  │
│  • Identifies domain(s)             │
│  • Routes to Prompt Engineer        │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│     PROMPT ENGINEER                 │
│  • Loads relevant skills            │
│  • Inspects codebase                │
│  • Writes detailed prompt file      │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│      CEO ASSISTANT                  │
│  • Presents prompt for approval     │
│  • User confirms or modifies        │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│    SPECIALIST AGENT(S)              │
│  • Execute in their domain only     │
│  • Respect architectural boundaries │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│    CODE REVIEWER → QA ENGINEER      │
│  • Review diff  • Run checks        │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│    CEO ASSISTANT → USER             │
│  • Final report                     │
└─────────────────────────────────────┘
    │
    ▼
┌─────────────────────────────────────┐
│   DOCS MEMORY AGENT                 │
│  • Logs to memory-log.md            │
└─────────────────────────────────────┘

Framework Compatibility

| Framework | Setup | |-----------|-------| | opencode | Native — copy to ~/.config/opencode/ | | Claude Code | Copy to ~/.claude/agents/, add tools in .claude/settings.json | | Cursor | Copy to .cursor/agents/ or project .cursorrules | | Windsurf | Copy to .windsurf/agents/ | | Project-local | Copy to ./.agents/, reference in AGENTS.md |

See PERMISSIONS_MAP.md for tool permission translation.

Key Files

| File | Purpose | |------|---------| | AGENTS.md | Master orchestration doc (copy to project root) | | agents/*.md | 40 agent definitions with frontmatter | | skills/*/SKILL.md | 5 reusable skills | | templates/EXPERT_AGENT_TEMPLATE.md | Template for creating new agents | | tools/tool-runner.md | CLI operations agent | | scripts/install.sh | Universal installer | | docs/CROSS_AGENT_COMPATIBILITY.md | Framework-specific guides |

Creating Custom Agents

Use the agent-development skill:

# In opencode/Claude Code:
> Use the agent-development skill to create a new agent for [your use case]

Or use the template:

cp templates/EXPERT_AGENT_TEMPLATE.md agents/my-new-agent.md
# Edit frontmatter and system prompt

License

MIT — Free for personal and commercial use. See LICENSE.

Contributing

See CONTRIBUTING.md — PRs welcome for new agents, skills, or framework guides.