agentic-team

Quick Start: Execute npx @genxlabs/agentic-team in any project directory to instantly install the AI team.

A structured, modular AI agent toolkit designed to orchestrate software delivery teams directly within your workspace.

Built natively to integrate tightly with agentic assistants like Antigravity, Claude Code, and OpenAI Codex CLI.

🚀 Overview

The agentic-team transforms your AI coding assistant from a single generalized bot into a massive 140-person specialist team (8 Core SDLC agents + 132 specialized department agents). Each agent simulates a defined role with explicit inputs, outputs, constraints, and operational guidelines.

Credits & Acknowledgements: The 132 specialized department personas (spanning Marketing, Engineering, Design, Sales, and more) were adapted and structurally migrated from the excellent agency-agents repository by msitarzewski.

Instead of writing massive prompts, the agent workspace uses a sophisticated routing framework (AGENTS.md) to dynamically load context-specific personas into your AI on demand.

👥 The Roles

| Phase | Role | Trigger | Instruction File to Read | |-------|------|---------|--------------------------| | Status | Orchestrator | status | skills/_core_sdlc/orchestrator.md | | P1 | Product Manager | PM: or As PM: | skills/_core_sdlc/product-manager.md | | P2a | Architect (design) | Architect: or As Architect: | skills/_core_sdlc/architect.md | | P2b | DBA | DBA: or As DBA: | skills/_core_sdlc/dba.md | | P3 | UI Designer (design) | UI: or As UI Designer: | skills/_core_sdlc/ui-designer.md | | P3b | UI Designer — Design Review | UI review: | skills/_core_sdlc/ui-designer.md | | P4 | Project Manager | Project Manager: | skills/_core_sdlc/project-manager.md | | P5a | Backend Engineer — API Contract | API contract: / Java contract: / Python contract: | skills/_core_sdlc/backend-engineer.md | | P5b | Technical Plan | Plan: | Uses P5a schema rules to write plan.md | | P6a | Frontend Engineer | Frontend: or As Frontend: | skills/_core_sdlc/frontend-engineer.md | | P6b | Backend Engineer — Backend Dev | .NET: / Java: / Python: | skills/_core_sdlc/backend-engineer.md | | P6c | Architect — Code Review | Code review: | skills/_core_sdlc/architect.md | | P7 | QA Engineer | QA: | skills/_core_sdlc/qa-engineer.md | | P8 | DevOps Engineer | DevOps: | skills/_core_sdlc/devops-engineer.md |

Design Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Brand Guardian | Brand Guardian: or As Brand Guardian: | skills/design/design-brand-guardian.md | | Image Prompt Engineer | Image Prompt Engineer: or As Image Prompt Engineer: | skills/design/design-image-prompt-engineer.md | | Inclusive Visuals Specialist | Inclusive Visuals Specialist: or As Inclusive Visuals Specialist: | skills/design/design-inclusive-visuals-specialist.md | | UI Designer | UI Designer: or As UI Designer: | skills/design/design-ui-designer.md | | UX Architect | UX Architect: or As UX Architect: | skills/design/design-ux-architect.md | | UX Researcher | UX Researcher: or As UX Researcher: | skills/design/design-ux-researcher.md | | Visual Storyteller | Visual Storyteller: or As Visual Storyteller: | skills/design/design-visual-storyteller.md | | Whimsy Injector | Whimsy Injector: or As Whimsy Injector: | skills/design/design-whimsy-injector.md |

Engineering Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | AI Engineer | AI Engineer: or As AI Engineer: | skills/engineering/engineering-ai-engineer.md | | Autonomous Optimization Architect | Autonomous Optimization Architect: or As Autonomous Optimization Architect: | skills/engineering/engineering-autonomous-optimization-architect.md | | Backend Architect | Backend Architect: or As Backend Architect: | skills/engineering/engineering-backend-architect.md | | Code Reviewer | Code Reviewer: or As Code Reviewer: | skills/engineering/engineering-code-reviewer.md | | Data Engineer | Data Engineer: or As Data Engineer: | skills/engineering/engineering-data-engineer.md | | Database Optimizer | Database Optimizer: or As Database Optimizer: | skills/engineering/engineering-database-optimizer.md | | DevOps Automator | DevOps Automator: or As DevOps Automator: | skills/engineering/engineering-devops-automator.md | | Embedded Firmware Engineer | Embedded Firmware Engineer: or As Embedded Firmware Engineer: | skills/engineering/engineering-embedded-firmware-engineer.md | | Feishu Integration Developer | Feishu Integration Developer: or As Feishu Integration Developer: | skills/engineering/engineering-feishu-integration-developer.md | | Frontend Developer | Frontend Developer: or As Frontend Developer: | skills/engineering/engineering-frontend-developer.md | | Git Workflow Master | Git Workflow Master: or As Git Workflow Master: | skills/engineering/engineering-git-workflow-master.md | | Incident Response Commander | Incident Response Commander: or As Incident Response Commander: | skills/engineering/engineering-incident-response-commander.md | | Mobile App Builder | Mobile App Builder: or As Mobile App Builder: | skills/engineering/engineering-mobile-app-builder.md | | Rapid Prototyper | Rapid Prototyper: or As Rapid Prototyper: | skills/engineering/engineering-rapid-prototyper.md | | SRE (Site Reliability Engineer) | SRE (Site Reliability Engineer): or As SRE (Site Reliability Engineer): | skills/engineering/engineering-sre.md | | Security Engineer | Security Engineer: or As Security Engineer: | skills/engineering/engineering-security-engineer.md | | Senior Developer | Senior Developer: or As Senior Developer: | skills/engineering/engineering-senior-developer.md | | Software Architect | Software Architect: or As Software Architect: | skills/engineering/engineering-software-architect.md | | Solidity Smart Contract Engineer | Solidity Smart Contract Engineer: or As Solidity Smart Contract Engineer: | skills/engineering/engineering-solidity-smart-contract-engineer.md | | Technical Writer | Technical Writer: or As Technical Writer: | skills/engineering/engineering-technical-writer.md | | Threat Detection Engineer | Threat Detection Engineer: or As Threat Detection Engineer: | skills/engineering/engineering-threat-detection-engineer.md | | WeChat Mini Program Developer | WeChat Mini Program Developer: or As WeChat Mini Program Developer: | skills/engineering/engineering-wechat-mini-program-developer.md |

Game Development Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Game Audio Engineer | Game Audio Engineer: or As Game Audio Engineer: | skills/game-development/game-audio-engineer.md | | Game Designer | Game Designer: or As Game Designer: | skills/game-development/game-designer.md | | Level Designer | Level Designer: or As Level Designer: | skills/game-development/level-designer.md | | Narrative Designer | Narrative Designer: or As Narrative Designer: | skills/game-development/narrative-designer.md | | Technical Artist | Technical Artist: or As Technical Artist: | skills/game-development/technical-artist.md |

Marketing Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | App Store Optimizer | App Store Optimizer: or As App Store Optimizer: | skills/marketing/marketing-app-store-optimizer.md | | Baidu SEO Specialist | Baidu SEO Specialist: or As Baidu SEO Specialist: | skills/marketing/marketing-baidu-seo-specialist.md | | Bilibili Content Strategist | Bilibili Content Strategist: or As Bilibili Content Strategist: | skills/marketing/marketing-bilibili-content-strategist.md | | Book Co-Author | Book Co-Author: or As Book Co-Author: | skills/marketing/marketing-book-co-author.md | | Carousel Growth Engine | Carousel Growth Engine: or As Carousel Growth Engine: | skills/marketing/marketing-carousel-growth-engine.md | | China E-Commerce Operator | China E-Commerce Operator: or As China E-Commerce Operator: | skills/marketing/marketing-china-ecommerce-operator.md | | Content Creator | Content Creator: or As Content Creator: | skills/marketing/marketing-content-creator.md | | Cross-Border E-Commerce Specialist | Cross-Border E-Commerce Specialist: or As Cross-Border E-Commerce Specialist: | skills/marketing/marketing-cross-border-ecommerce.md | | Douyin Strategist | Douyin Strategist: or As Douyin Strategist: | skills/marketing/marketing-douyin-strategist.md | | Growth Hacker | Growth Hacker: or As Growth Hacker: | skills/marketing/marketing-growth-hacker.md | | Instagram Curator | Instagram Curator: or As Instagram Curator: | skills/marketing/marketing-instagram-curator.md | | Kuaishou Strategist | Kuaishou Strategist: or As Kuaishou Strategist: | skills/marketing/marketing-kuaishou-strategist.md | | LinkedIn Content Creator | LinkedIn Content Creator: or As LinkedIn Content Creator: | skills/marketing/marketing-linkedin-content-creator.md | | Livestream Commerce Coach | Livestream Commerce Coach: or As Livestream Commerce Coach: | skills/marketing/marketing-livestream-commerce-coach.md | | Podcast Strategist | Podcast Strategist: or As Podcast Strategist: | skills/marketing/marketing-podcast-strategist.md | | Private Domain Operator | Private Domain Operator: or As Private Domain Operator: | skills/marketing/marketing-private-domain-operator.md | | Reddit Community Builder | Reddit Community Builder: or As Reddit Community Builder: | skills/marketing/marketing-reddit-community-builder.md | | SEO Specialist | SEO Specialist: or As SEO Specialist: | skills/marketing/marketing-seo-specialist.md | | Short-Video Editing Coach | Short-Video Editing Coach: or As Short-Video Editing Coach: | skills/marketing/marketing-short-video-editing-coach.md | | Social Media Strategist | Social Media Strategist: or As Social Media Strategist: | skills/marketing/marketing-social-media-strategist.md | | TikTok Strategist | TikTok Strategist: or As TikTok Strategist: | skills/marketing/marketing-tiktok-strategist.md | | Twitter Engager | Twitter Engager: or As Twitter Engager: | skills/marketing/marketing-twitter-engager.md | | WeChat Official Account Manager | WeChat Official Account Manager: or As WeChat Official Account Manager: | skills/marketing/marketing-wechat-official-account.md | | Weibo Strategist | Weibo Strategist: or As Weibo Strategist: | skills/marketing/marketing-weibo-strategist.md | | Xiaohongshu Specialist | Xiaohongshu Specialist: or As Xiaohongshu Specialist: | skills/marketing/marketing-xiaohongshu-specialist.md | | Zhihu Strategist | Zhihu Strategist: or As Zhihu Strategist: | skills/marketing/marketing-zhihu-strategist.md |

Paid Media Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Ad Creative Strategist | Ad Creative Strategist: or As Ad Creative Strategist: | skills/paid-media/paid-media-creative-strategist.md | | PPC Campaign Strategist | PPC Campaign Strategist: or As PPC Campaign Strategist: | skills/paid-media/paid-media-ppc-strategist.md | | Paid Media Auditor | Paid Media Auditor: or As Paid Media Auditor: | skills/paid-media/paid-media-auditor.md | | Paid Social Strategist | Paid Social Strategist: or As Paid Social Strategist: | skills/paid-media/paid-media-paid-social-strategist.md | | Programmatic & Display Buyer | Programmatic & Display Buyer: or As Programmatic & Display Buyer: | skills/paid-media/paid-media-programmatic-buyer.md | | Search Query Analyst | Search Query Analyst: or As Search Query Analyst: | skills/paid-media/paid-media-search-query-analyst.md | | Tracking & Measurement Specialist | Tracking & Measurement Specialist: or As Tracking & Measurement Specialist: | skills/paid-media/paid-media-tracking-specialist.md |

Product Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Behavioral Nudge Engine | Behavioral Nudge Engine: or As Behavioral Nudge Engine: | skills/product/product-behavioral-nudge-engine.md | | Feedback Synthesizer | Feedback Synthesizer: or As Feedback Synthesizer: | skills/product/product-feedback-synthesizer.md | | Sprint Prioritizer | Sprint Prioritizer: or As Sprint Prioritizer: | skills/product/product-sprint-prioritizer.md | | Trend Researcher | Trend Researcher: or As Trend Researcher: | skills/product/product-trend-researcher.md |

Project Management Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Experiment Tracker | Experiment Tracker: or As Experiment Tracker: | skills/project-management/project-management-experiment-tracker.md | | Jira Workflow Steward | Jira Workflow Steward: or As Jira Workflow Steward: | skills/project-management/project-management-jira-workflow-steward.md | | Project Shepherd | Project Shepherd: or As Project Shepherd: | skills/project-management/project-management-project-shepherd.md | | Senior Project Manager | Senior Project Manager: or As Senior Project Manager: | skills/project-management/project-manager-senior.md | | Studio Operations | Studio Operations: or As Studio Operations: | skills/project-management/project-management-studio-operations.md | | Studio Producer | Studio Producer: or As Studio Producer: | skills/project-management/project-management-studio-producer.md |

Sales Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Account Strategist | Account Strategist: or As Account Strategist: | skills/sales/sales-account-strategist.md | | Deal Strategist | Deal Strategist: or As Deal Strategist: | skills/sales/sales-deal-strategist.md | | Discovery Coach | Discovery Coach: or As Discovery Coach: | skills/sales/sales-discovery-coach.md | | Outbound Strategist | Outbound Strategist: or As Outbound Strategist: | skills/sales/sales-outbound-strategist.md | | Pipeline Analyst | Pipeline Analyst: or As Pipeline Analyst: | skills/sales/sales-pipeline-analyst.md | | Proposal Strategist | Proposal Strategist: or As Proposal Strategist: | skills/sales/sales-proposal-strategist.md | | Sales Coach | Sales Coach: or As Sales Coach: | skills/sales/sales-coach.md | | Sales Engineer | Sales Engineer: or As Sales Engineer: | skills/sales/sales-engineer.md |

Spatial Computing Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Terminal Integration Specialist | Terminal Integration Specialist: or As Terminal Integration Specialist: | skills/spatial-computing/terminal-integration-specialist.md | | XR Cockpit Interaction Specialist | XR Cockpit Interaction Specialist: or As XR Cockpit Interaction Specialist: | skills/spatial-computing/xr-cockpit-interaction-specialist.md | | XR Immersive Developer | XR Immersive Developer: or As XR Immersive Developer: | skills/spatial-computing/xr-immersive-developer.md | | XR Interface Architect | XR Interface Architect: or As XR Interface Architect: | skills/spatial-computing/xr-interface-architect.md | | macOS Spatial/Metal Engineer | macOS Spatial/Metal Engineer: or As macOS Spatial/Metal Engineer: | skills/spatial-computing/macos-spatial-metal-engineer.md | | visionOS Spatial Engineer | visionOS Spatial Engineer: or As visionOS Spatial Engineer: | skills/spatial-computing/visionos-spatial-engineer.md |

Specialized Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Accounts Payable Agent | Accounts Payable Agent: or As Accounts Payable Agent: | skills/specialized/accounts-payable-agent.md | | Agentic Identity & Trust Architect | Agentic Identity & Trust Architect: or As Agentic Identity & Trust Architect: | skills/specialized/agentic-identity-trust.md | | Agents Orchestrator | Agents Orchestrator: or As Agents Orchestrator: | skills/specialized/agents-orchestrator.md | | Blockchain Security Auditor | Blockchain Security Auditor: or As Blockchain Security Auditor: | skills/specialized/blockchain-security-auditor.md | | Compliance Auditor | Compliance Auditor: or As Compliance Auditor: | skills/specialized/compliance-auditor.md | | Corporate Training Designer | Corporate Training Designer: or As Corporate Training Designer: | skills/specialized/corporate-training-designer.md | | Cultural Intelligence Strategist | Cultural Intelligence Strategist: or As Cultural Intelligence Strategist: | skills/specialized/specialized-cultural-intelligence-strategist.md | | Data Consolidation Agent | Data Consolidation Agent: or As Data Consolidation Agent: | skills/specialized/data-consolidation-agent.md | | Developer Advocate | Developer Advocate: or As Developer Advocate: | skills/specialized/specialized-developer-advocate.md | | Document Generator | Document Generator: or As Document Generator: | skills/specialized/specialized-document-generator.md | | Government Digital Presales Consultant | Government Digital Presales Consultant: or As Government Digital Presales Consultant: | skills/specialized/government-digital-presales-consultant.md | | Healthcare Marketing Compliance Specialist | Healthcare Marketing Compliance Specialist: or As Healthcare Marketing Compliance Specialist: | skills/specialized/healthcare-marketing-compliance.md | | Identity Graph Operator | Identity Graph Operator: or As Identity Graph Operator: | skills/specialized/identity-graph-operator.md | | LSP/Index Engineer | LSP/Index Engineer: or As LSP/Index Engineer: | skills/specialized/lsp-index-engineer.md | | MCP Builder | MCP Builder: or As MCP Builder: | skills/specialized/specialized-mcp-builder.md | | Model QA Specialist | Model QA Specialist: or As Model QA Specialist: | skills/specialized/specialized-model-qa.md | | Recruitment Specialist | Recruitment Specialist: or As Recruitment Specialist: | skills/specialized/recruitment-specialist.md | | Report Distribution Agent | Report Distribution Agent: or As Report Distribution Agent: | skills/specialized/report-distribution-agent.md | | Sales Data Extraction Agent | Sales Data Extraction Agent: or As Sales Data Extraction Agent: | skills/specialized/sales-data-extraction-agent.md | | Study Abroad Advisor | Study Abroad Advisor: or As Study Abroad Advisor: | skills/specialized/study-abroad-advisor.md | | Supply Chain Strategist | Supply Chain Strategist: or As Supply Chain Strategist: | skills/specialized/supply-chain-strategist.md | | ZK Steward | ZK Steward: or As ZK Steward: | skills/specialized/zk-steward.md |

Support Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | Analytics Reporter | Analytics Reporter: or As Analytics Reporter: | skills/support/support-analytics-reporter.md | | Executive Summary Generator | Executive Summary Generator: or As Executive Summary Generator: | skills/support/support-executive-summary-generator.md | | Finance Tracker | Finance Tracker: or As Finance Tracker: | skills/support/support-finance-tracker.md | | Infrastructure Maintainer | Infrastructure Maintainer: or As Infrastructure Maintainer: | skills/support/support-infrastructure-maintainer.md | | Legal Compliance Checker | Legal Compliance Checker: or As Legal Compliance Checker: | skills/support/support-legal-compliance-checker.md | | Support Responder | Support Responder: or As Support Responder: | skills/support/support-support-responder.md |

Testing Department

| Role | Trigger | Instruction File to Read | |------|---------|--------------------------| | API Tester | API Tester: or As API Tester: | skills/testing/testing-api-tester.md | | Accessibility Auditor | Accessibility Auditor: or As Accessibility Auditor: | skills/testing/testing-accessibility-auditor.md | | Evidence Collector | Evidence Collector: or As Evidence Collector: | skills/testing/testing-evidence-collector.md | | Performance Benchmarker | Performance Benchmarker: or As Performance Benchmarker: | skills/testing/testing-performance-benchmarker.md | | Reality Checker | Reality Checker: or As Reality Checker: | skills/testing/testing-reality-checker.md | | Test Results Analyzer | Test Results Analyzer: or As Test Results Analyzer: | skills/testing/testing-test-results-analyzer.md | | Tool Evaluator | Tool Evaluator: or As Tool Evaluator: | skills/testing/testing-tool-evaluator.md | | Workflow Optimizer | Workflow Optimizer: or As Workflow Optimizer: | skills/testing/testing-workflow-optimizer.md |

🛠️ How to Use

Because agentic-team is entirely modular and distributed via NPM, you can instantly turn any project on your computer into an AI workspace!

1. Installation

Simply navigate to your new or existing project directory in your terminal and run the global installer:

npx @genxlabs/agentic-team

This automatically downloads and securely drops the AGENTS.md and skills/ directly into your workspace.

To view the help and usage instructions without installing anything, run:

npx @genxlabs/agentic-team --help

2. Activating a Persona

Simply prefix your message to the AI with the role you want it to adopt.

Example 1: Product Management

PM: I want to build a user permissions module with role assignments.

The AI reads skills/product-manager.md, asks 2-5 clarifying questions, and then drafts a robust requirement.md artifact.

Example 2: UX Design

UI: Generate a sleek wireframe for the new permissions dashboard based on the PM's requirements.

The UI Designer natively integrates with Google Stitch MCP. If configured, it will instantly generate a high-fidelity visual design system and screen mockups directly in your Google Stitch workspace. If not configured, it gracefully falls back to generating semantic HTML and markdown artifacts.

Example 3: End-to-End Workflow (e.g. RAG Chatbot) You can trigger the entire team sequentially to build a complex feature from scratch:

1. PM: I want to build a RAG-based chatbot query endpoint that retrieves company documents.

2. Architect: Design the architecture using Milvus and OpenAI.

3. DBA: Design the database tables for the chat history and document metadata.

4. Python contract: Define the FastAPI endpoint for the chat query.

5. Python: Implement the backend code using LangChain and the defined API contract.

3. Checking Progress

Not sure where you are in the iteration? You can summon the built-in orchestrator:

status

This triggers the Orchestrator (defined in skills/orchestrator.md), which will scan the .ai/ directory and print out a Gate Review card indicating which documents are completed and what role needs to be executed next!

📂 Architecture

For maximum maintainability and AI reliability, the repository is cleanly divided:

• AGENTS.md — The lightweight master router file (starts here).
• skills/*.md — The massive individual personas for the 10 distinct agent types.
• .ai/context/ — (Optional) Hard configurations you can define to constrain the AI's behavior (e.g., brand colors, enforced frameworks like Vue over React).

📜 License

MIT. Copyright 2026. See LICENSE.