mirror of
https://github.com/msitarzewski/agency-agents
synced 2026-04-25 11:18:05 +00:00
c23287d83f
Remove all hardcoded "51" agent counts from README and strategy docs to avoid future maintenance burden as new agents are contributed. Add Image Prompt Engineer (Design), Sales Data Extraction Agent, Data Consolidation Agent, and Report Distribution Agent (Specialized) to all roster listings. Fix slug-style name on Image Prompt Engineer frontmatter. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
8.2 KiB
8.2 KiB
⚡ NEXUS Quick-Start Guide
Get from zero to orchestrated multi-agent pipeline in 5 minutes.
What is NEXUS?
NEXUS (Network of EXperts, Unified in Strategy) turns The Agency's AI specialists into a coordinated pipeline. Instead of activating agents one at a time and hoping they work together, NEXUS defines exactly who does what, when, and how quality is verified at every step.
Choose Your Mode
| I want to... | Use | Agents | Time |
|---|---|---|---|
| Build a complete product from scratch | NEXUS-Full | All | 12-24 weeks |
| Build a feature or MVP | NEXUS-Sprint | 15-25 | 2-6 weeks |
| Do a specific task (bug fix, campaign, audit) | NEXUS-Micro | 5-10 | 1-5 days |
🚀 NEXUS-Full: Start a Complete Project
Copy this prompt to activate the full pipeline:
Activate Agents Orchestrator in NEXUS-Full mode.
Project: [YOUR PROJECT NAME]
Specification: [DESCRIBE YOUR PROJECT OR LINK TO SPEC]
Execute the complete NEXUS pipeline:
- Phase 0: Discovery (Trend Researcher, Feedback Synthesizer, UX Researcher, Analytics Reporter, Legal Compliance Checker, Tool Evaluator)
- Phase 1: Strategy (Studio Producer, Senior Project Manager, Sprint Prioritizer, UX Architect, Brand Guardian, Backend Architect, Finance Tracker)
- Phase 2: Foundation (DevOps Automator, Frontend Developer, Backend Architect, UX Architect, Infrastructure Maintainer)
- Phase 3: Build (Dev↔QA loops — all engineering + Evidence Collector)
- Phase 4: Harden (Reality Checker, Performance Benchmarker, API Tester, Legal Compliance Checker)
- Phase 5: Launch (Growth Hacker, Content Creator, all marketing agents, DevOps Automator)
- Phase 6: Operate (Analytics Reporter, Infrastructure Maintainer, Support Responder, ongoing)
Quality gates between every phase. Evidence required for all assessments.
Maximum 3 retries per task before escalation.
🏃 NEXUS-Sprint: Build a Feature or MVP
Copy this prompt:
Activate Agents Orchestrator in NEXUS-Sprint mode.
Feature/MVP: [DESCRIBE WHAT YOU'RE BUILDING]
Timeline: [TARGET WEEKS]
Skip Phase 0 (market already validated).
Sprint team:
- PM: Senior Project Manager, Sprint Prioritizer
- Design: UX Architect, Brand Guardian
- Engineering: Frontend Developer, Backend Architect, DevOps Automator
- QA: Evidence Collector, Reality Checker, API Tester
- Support: Analytics Reporter
Begin at Phase 1 with architecture and sprint planning.
Run Dev↔QA loops for all implementation tasks.
Reality Checker approval required before launch.
🎯 NEXUS-Micro: Do a Specific Task
Pick your scenario and copy the prompt:
Fix a Bug
Activate Backend Architect to investigate and fix [BUG DESCRIPTION].
After fix, activate API Tester to verify the fix.
Then activate Evidence Collector to confirm no visual regressions.
Run a Marketing Campaign
Activate Social Media Strategist as campaign lead for [CAMPAIGN DESCRIPTION].
Team: Content Creator, Twitter Engager, Instagram Curator, Reddit Community Builder.
Brand Guardian reviews all content before publishing.
Analytics Reporter tracks performance daily.
Growth Hacker optimizes channels weekly.
Conduct a Compliance Audit
Activate Legal Compliance Checker for comprehensive compliance audit.
Scope: [GDPR / CCPA / HIPAA / ALL]
After audit, activate Executive Summary Generator to create stakeholder report.
Investigate Performance Issues
Activate Performance Benchmarker to diagnose performance issues.
Scope: [API response times / Page load / Database queries / All]
After diagnosis, activate Infrastructure Maintainer for optimization.
DevOps Automator deploys any infrastructure changes.
Market Research
Activate Trend Researcher for market intelligence on [DOMAIN].
Deliverables: Competitive landscape, market sizing, trend forecast.
After research, activate Executive Summary Generator for executive brief.
UX Improvement
Activate UX Researcher to identify usability issues in [FEATURE/PRODUCT].
After research, activate UX Architect to design improvements.
Frontend Developer implements changes.
Evidence Collector verifies improvements.
📁 Strategy Documents
| Document | Purpose | Location |
|---|---|---|
| Master Strategy | Complete NEXUS doctrine | strategy/nexus-strategy.md |
| Phase 0 Playbook | Discovery & intelligence | strategy/playbooks/phase-0-discovery.md |
| Phase 1 Playbook | Strategy & architecture | strategy/playbooks/phase-1-strategy.md |
| Phase 2 Playbook | Foundation & scaffolding | strategy/playbooks/phase-2-foundation.md |
| Phase 3 Playbook | Build & iterate | strategy/playbooks/phase-3-build.md |
| Phase 4 Playbook | Quality & hardening | strategy/playbooks/phase-4-hardening.md |
| Phase 5 Playbook | Launch & growth | strategy/playbooks/phase-5-launch.md |
| Phase 6 Playbook | Operate & evolve | strategy/playbooks/phase-6-operate.md |
| Activation Prompts | Ready-to-use agent prompts | strategy/coordination/agent-activation-prompts.md |
| Handoff Templates | Standardized handoff formats | strategy/coordination/handoff-templates.md |
| Startup MVP Runbook | 4-6 week MVP build | strategy/runbooks/scenario-startup-mvp.md |
| Enterprise Feature Runbook | Enterprise feature development | strategy/runbooks/scenario-enterprise-feature.md |
| Marketing Campaign Runbook | Multi-channel campaign | strategy/runbooks/scenario-marketing-campaign.md |
| Incident Response Runbook | Production incident handling | strategy/runbooks/scenario-incident-response.md |
🔑 Key Concepts in 30 Seconds
- Quality Gates — No phase advances without evidence-based approval
- Dev↔QA Loop — Every task is built then tested; PASS to proceed, FAIL to retry (max 3)
- Handoffs — Structured context transfer between agents (never start cold)
- Reality Checker — Final quality authority; defaults to "NEEDS WORK"
- Agents Orchestrator — Pipeline controller managing the entire flow
- Evidence Over Claims — Screenshots, test results, and data — not assertions
🎭 The Agents at a Glance
ENGINEERING │ DESIGN │ MARKETING
Frontend Developer │ UI Designer │ Growth Hacker
Backend Architect │ UX Researcher │ Content Creator
Mobile App Builder │ UX Architect │ Twitter Engager
AI Engineer │ Brand Guardian │ TikTok Strategist
DevOps Automator │ Visual Storyteller │ Instagram Curator
Rapid Prototyper │ Whimsy Injector │ Reddit Community Builder
Senior Developer │ Image Prompt Eng. │ App Store Optimizer
│ │ Social Media Strategist
────────────────────┼─────────────────────┼──────────────────────
PRODUCT │ PROJECT MGMT │ TESTING
Sprint Prioritizer │ Studio Producer │ Evidence Collector
Trend Researcher │ Project Shepherd │ Reality Checker
Feedback Synthesizer│ Studio Operations │ Test Results Analyzer
│ Experiment Tracker │ Performance Benchmarker
│ Senior Project Mgr │ API Tester
│ │ Tool Evaluator
│ │ Workflow Optimizer
────────────────────┼─────────────────────┼──────────────────────
SUPPORT │ SPATIAL │ SPECIALIZED
Support Responder │ XR Interface Arch. │ Agents Orchestrator
Analytics Reporter │ macOS Spatial/Metal │ Data Analytics Reporter
Finance Tracker │ XR Immersive Dev │ LSP/Index Engineer
Infra Maintainer │ XR Cockpit Spec. │ Sales Data Extraction
Legal Compliance │ visionOS Spatial │ Data Consolidation
Exec Summary Gen. │ Terminal Integration│ Report Distribution
Start with a mode. Follow the playbook. Trust the pipeline.
strategy/nexus-strategy.md — The complete doctrine