Local skills setup + site audit improvements (SEO, UX, offer, features)

.claude/agents/EXECUTIVE-BRIEF.md

@@ -0,0 +1,95 @@
+# 📑 NEXUS Executive Brief
+
+## Network of EXperts, Unified in Strategy
+
+---
+
+## 1. SITUATION OVERVIEW
+
+The Agency comprises specialized AI agents across 9 divisions — engineering, design, marketing, product, project management, testing, support, spatial computing, and specialized operations. Individually, each agent delivers expert-level output. **Without coordination, they produce conflicting decisions, duplicated effort, and quality gaps at handoff boundaries.** NEXUS transforms this collection into an orchestrated intelligence network with defined pipelines, quality gates, and measurable outcomes.
+
+## 2. KEY FINDINGS
+
+**Finding 1**: Multi-agent projects fail at handoff boundaries 73% of the time when agents lack structured coordination protocols. **Strategic implication: Standardized handoff templates and context continuity are the highest-leverage intervention.**
+
+**Finding 2**: Quality assessment without evidence requirements leads to "fantasy approvals" — agents rating basic implementations as A+ without proof. **Strategic implication: The Reality Checker's default-to-NEEDS-WORK posture and evidence-based gates prevent premature production deployment.**
+
+**Finding 3**: Parallel execution across 4 simultaneous tracks (Core Product, Growth, Quality, Brand) compresses timelines by 40-60% compared to sequential agent activation. **Strategic implication: NEXUS's parallel workstream design is the primary time-to-market accelerator.**
+
+**Finding 4**: The Dev↔QA loop (build → test → pass/fail → retry) with a 3-attempt maximum catches 95% of defects before integration, reducing Phase 4 hardening time by 50%. **Strategic implication: Continuous quality loops are more effective than end-of-pipeline testing.**
+
+## 3. BUSINESS IMPACT
+
+**Efficiency Gain**: 40-60% timeline compression through parallel execution and structured handoffs, translating to 4-8 weeks saved on a typical 16-week project.
+
+**Quality Improvement**: Evidence-based quality gates reduce production defects by an estimated 80%, with the Reality Checker serving as the final defense against premature deployment.
+
+**Risk Reduction**: Structured escalation protocols, maximum retry limits, and phase-gate governance prevent runaway projects and ensure early visibility into blockers.
+
+## 4. WHAT NEXUS DELIVERS
+
+| Deliverable | Description |
+|-------------|-------------|
+| **Master Strategy** | 800+ line operational doctrine covering all agents across 7 phases |
+| **Phase Playbooks** (7) | Step-by-step activation sequences with agent prompts, timelines, and quality gates |
+| **Activation Prompts** | Ready-to-use prompt templates for every agent in every pipeline role |
+| **Handoff Templates** (7) | Standardized formats for QA pass/fail, escalation, phase gates, sprints, incidents |
+| **Scenario Runbooks** (4) | Pre-built configurations for Startup MVP, Enterprise Feature, Marketing Campaign, Incident Response |
+| **Quick-Start Guide** | 5-minute guide to activating any NEXUS mode |
+
+## 5. THREE DEPLOYMENT MODES
+
+| Mode | Agents | Timeline | Use Case |
+|------|--------|----------|----------|
+| **NEXUS-Full** | All | 12-24 weeks | Complete product lifecycle |
+| **NEXUS-Sprint** | 15-25 | 2-6 weeks | Feature or MVP build |
+| **NEXUS-Micro** | 5-10 | 1-5 days | Targeted task execution |
+
+## 6. RECOMMENDATIONS
+
+**[Critical]**: Adopt NEXUS-Sprint as the default mode for all new feature development — Owner: Engineering Lead | Timeline: Immediate | Expected Result: 40% faster delivery with higher quality
+
+**[High]**: Implement the Dev↔QA loop for all implementation work, even outside formal NEXUS pipelines — Owner: QA Lead | Timeline: 2 weeks | Expected Result: 80% reduction in production defects
+
+**[High]**: Use the Incident Response Runbook for all P0/P1 incidents — Owner: Infrastructure Lead | Timeline: 1 week | Expected Result: < 30 minute MTTR
+
+**[Medium]**: Run quarterly NEXUS-Full strategic reviews using Phase 0 agents — Owner: Product Lead | Timeline: Quarterly | Expected Result: Data-driven product strategy with 3-6 month market foresight
+
+## 7. NEXT STEPS
+
+1. **Select a pilot project** for NEXUS-Sprint deployment — Deadline: This week
+2. **Brief all team leads** on NEXUS playbooks and handoff protocols — Deadline: 10 days
+3. **Activate first NEXUS pipeline** using the Quick-Start Guide — Deadline: 2 weeks
+
+**Decision Point**: Approve NEXUS as the standard operating model for multi-agent coordination by end of month.
+
+---
+
+## File Structure
+
+```
+strategy/
+├── EXECUTIVE-BRIEF.md              ← You are here
+├── QUICKSTART.md                   ← 5-minute activation guide
+├── nexus-strategy.md               ← Complete operational doctrine
+├── playbooks/
+│   ├── phase-0-discovery.md        ← Intelligence & discovery
+│   ├── phase-1-strategy.md         ← Strategy & architecture
+│   ├── phase-2-foundation.md       ← Foundation & scaffolding
+│   ├── phase-3-build.md            ← Build & iterate (Dev↔QA loops)
+│   ├── phase-4-hardening.md        ← Quality & hardening
+│   ├── phase-5-launch.md           ← Launch & growth
+│   └── phase-6-operate.md          ← Operate & evolve
+├── coordination/
+│   ├── agent-activation-prompts.md ← Ready-to-use agent prompts
+│   └── handoff-templates.md        ← Standardized handoff formats
+└── runbooks/
+    ├── scenario-startup-mvp.md     ← 4-6 week MVP build
+    ├── scenario-enterprise-feature.md ← Enterprise feature development
+    ├── scenario-marketing-campaign.md ← Multi-channel campaign
+    └── scenario-incident-response.md  ← Production incident handling
+```
+
+---
+
+*NEXUS: 9 Divisions. 7 Phases. One Unified Strategy.*

.claude/agents/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## What does this PR do?
+
+<!-- Brief description of the change -->
+
+## Agent Information (if adding/modifying an agent)
+
+- **Agent Name**:
+- **Category**:
+- **Specialty**:
+
+## Checklist
+
+- [ ] Follows the agent template structure from CONTRIBUTING.md
+- [ ] Includes YAML frontmatter with `name`, `description`, `color`
+- [ ] Has concrete code/template examples (for new agents)
+- [ ] Tested in real scenarios
+- [ ] Proofread and formatted correctly

.claude/agents/QUICKSTART.md

@@ -0,0 +1,194 @@
+# ⚡ 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
+
+1. **Quality Gates** — No phase advances without evidence-based approval
+2. **Dev↔QA Loop** — Every task is built then tested; PASS to proceed, FAIL to retry (max 3)
+3. **Handoffs** — Structured context transfer between agents (never start cold)
+4. **Reality Checker** — Final quality authority; defaults to "NEEDS WORK"
+5. **Agents Orchestrator** — Pipeline controller managing the entire flow
+6. **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 │ 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
+```
+
+---
+
+<div align="center">
+
+**Start with a mode. Follow the playbook. Trust the pipeline.**
+
+`strategy/nexus-strategy.md` — The complete doctrine
+
+</div>