# Manual de Especificação dos 15 Agentes e Squads do PCL AEOS ================================================== 1. VISÃO GERAL DA SQUAD DE AGENTES ================================================== O **PromptCoreLabs_AEOS** opera sob uma arquitetura de múltiplos agentes autônomos e especializados (**Multi-Agent System - MAS**). Cada agente possui um contrato operacional estrito, limites de autonomia delimitados, entradas/saídas padronizadas e uma atribuição clara na matriz de responsabilidade da plataforma. A orquestração visual dos agentes é gerida pelo **PaperClip Dashboard** (porta `:3100`), e a inteligência de visualização de arquitetura é conduzida pela persona **Cortex** através do **PCL Cortex Visual Engine**. --- ## 2. MATRIZ DE RESPONSABILIDADE DOS 15 AGENTES ```mermaid graph TD subgraph StratSquad["Squad de Estratégia & Governança Executiva"] S1["Strategist_One
(Visão & OKRs)"] LEAD["Lead_TLC_Engineer
(Arquitetura Viva)"] AUD["Auditor Agent
(Compliance & Signoff)"] end subgraph CoreSquad["Squad Core de Engenharia TLC"] PLN["Planner Agent
(Decomposição & Backlog)"] BLD["Builder Agent
(Escrita de Código & Diffs)"] QA["Reviewer QA
(Testes Adversários & Cobertura)"] end subgraph SecOpsSquad["Squad SecOps, FinOps & Infra"] CISO["CISO Security Agent
(Zero Trust & Mesh)"] BIZ["BizOps Controller
(Processos & Sprints)"] FIN["Financial Advisor
(FinOps & EBITDA Shield)"] end subgraph GrowthDataSquad["Squad Data, Growth & People"] REV["RevOps Architect
(GTM & Conversão B2B)"] DATA["Data Insight Agent
(RAG Relacional & ML)"] NEURO["Neuromarketing Strategist
(Branding & Copywriting)"] COMP["Compliance Steward
(LegalOps & LGPD)"] SKILL["Skills Manager
(People & Competências)"] end StratSquad --> CoreSquad CoreSquad --> SecOpsSquad SecOpsSquad --> GrowthDataSquad ``` --- ## 2.1. ESTRUTURA ORGANIZACIONAL NO PAPERCLIP (ORG CHART DA HOLDING) ```mermaid graph TD classDef board fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4; classDef squadEstra fill:#181825,stroke:#f9e2af,stroke-width:1.5px,color:#cdd6f4; classDef squadRev fill:#181825,stroke:#a6e3a1,stroke-width:1.5px,color:#cdd6f4; classDef squadDev fill:#181825,stroke:#89dceb,stroke-width:1.5px,color:#cdd6f4; classDef squadOps fill:#181825,stroke:#cba6f7,stroke-width:1.5px,color:#cdd6f4; classDef squadSec fill:#181825,stroke:#f38ba8,stroke-width:1.5px,color:#cdd6f4; classDef squadFin fill:#181825,stroke:#fab387,stroke-width:1.5px,color:#cdd6f4; CEO["👑 CEO (PromptCore Labs)
ai-pricing • create-rfc • tlc-spec-driven"]:::board subgraph Vert_Software["Frente 1: Software Studio & DevSecOps"] LeadEng["Lead_TLC_Engineer (Head Software)
tlc-spec-driven • create-adr • best-practices"]:::squadDev CISO["CISO_Security_Agent (DevSecOps)
aws-advisor • best-practices"]:::squadSec AgileBot["bot-agile-master (Agile QA)"]:::squadOps LeadEng --> CISO --> AgileBot end subgraph Vert_Growth["Frente 2: Marketing, RevOps & Growth"] RevOps["RevOps_Architect (Head Growth)
ai-sdr • ai-cold-outreach"]:::squadRev CMO["Neuromarketing_Strategist (CMO)
ai-seo • ai-ugc-ads"]:::squadRev GrowthDS["Data_Insight_Agent (Data Science)
ai-seo • best-practices"]:::squadRev RevOps --> CMO --> GrowthDS end subgraph Vert_Consulting["Frente 3: Consultoria, FinOps & People Ops"] Strategist["Strategist_One (Head AI Consulting)
ai-pricing • create-rfc"]:::squadEstra FinAdv["Financial_Advisor (CFO Lead)
ai-pricing"]:::squadFin Compliance["Compliance_Steward (Legal/Compliance)
create-adr"]:::squadFin SkillsMgr["Skills_Manager (People Ops)
agent-skills-cli"]:::squadFin BizOps["BizOps_Controller (BizOps/Processes)
tlc-spec-driven • best-practices"]:::squadOps FinBot["bot-financial (FinOps Bot)"]:::squadFin Strategist --> FinAdv --> Compliance --> SkillsMgr --> BizOps --> FinBot end CEO --> LeadEng CEO --> RevOps CEO --> Strategist ``` --- ## 2.2. MATRIZ DE DISTRIBUIÇÃO DE SKILLS (PAPERCLIP + TLC SKILLS) | Agente / Papel | Liderança / Atuação nas Verticais | Skills Originais (Paperclip) | Novas TLC Skills Adicionadas | |---|---|---|---| | **CEO** | Orquestração Geral PCL, Venture Studio | `brainstorm-okrs`, `north-star-metric`, `product-vision`, `outcome-roadmap`, `summarize-meeting` | `ai-pricing`, `create-rfc`, `tlc-spec-driven` | | **Strategist_One** | Head de AI Consulting, GovTech & Estratégia | `brainstorm-okrs`, `north-star-metric`, `product-vision`, `outcome-roadmap`, `swot-analysis`, `lean-canvas`, `competitor-analysis`, `business-model`, `competitive-battlecard` | `ai-pricing`, `create-rfc` | | **RevOps_Architect** | Head de RevOps, CRM, Automação & Vendas B2B | `ideal-customer-profile`, `gtm-strategy`, `gtm-motions`, `cohort-analysis`, `growth-loops`, `user-segmentation`, `customer-journey-map` | `ai-sdr`, `ai-cold-outreach` | | **Neuromarketing_Strategist** | Head de Marketing Digital, Branding & Mídia | `marketing-ideas`, `positioning-ideas`, `product-name`, `value-prop-statements`, `customer-journey-map`, `user-personas` | `ai-seo`, `ai-ugc-ads` | | **Data_Insight_Agent** | Lead de Data & Analytics, BI e Customer Success | `ab-test-analysis`, `metrics-dashboard`, `cohort-analysis`, `growth-loops`, `user-segmentation`, `product-vision` | `ai-seo`, `best-practices` | | **Lead_TLC_Engineer** | Head de Software Studio & Prototipagem | `user-stories`, `create-prd`, `sprint-plan`, `test-scenarios`, `prioritize-features`, `outcome-roadmap` | `tlc-spec-driven`, `create-adr`, `best-practices`, `perf-astro` | | **BizOps_Controller** | Lead de Operações, Qualidade e Processos | `sprint-plan`, `prioritization-frameworks`, `prioritize-features`, `release-notes`, `summarize-meeting`, `retro` | `tlc-spec-driven`, `best-practices` | | **CISO_Security_Agent** | Head de DevSecOps, CyberSecurity & Cloud | `pre-mortem`, `privacy-policy`, `test-scenarios` | `aws-advisor`, `best-practices` | | **Financial_Advisor** | Head de Financeiro, FinOps, Pricing & E-Commerce | `pricing-strategy`, `monetization-strategy`, `market-sizing`, `summarize-interview`, `draft-nda` | `ai-pricing` | | **Compliance_Steward** | Lead de Jurídico, LGPD & Compliance | `draft-nda`, `privacy-policy` | `create-adr` | | **Skills_Manager** | Lead de RH, People Ops & AI Academy | `review-resume`, `interview-script`, `summarize-interview`, `grammar-check` | `agent-skills-cli` | --- ## 2.3. MATRIZ DE FUNCIONAMENTO DOS COMANDOS SLASH & GOVERNANÇA (ANTIGRAVITY IDE) ```mermaid flowchart TD subgraph Inception_StageGate1["Stage Gate 1: Inception & Specs"] GrillMe["/grill-me (Entrevista & Alinhamento de Design)"] Boost["/boost (Análise Profunda & Refatoração de Arquitetura)"] end subgraph Governance_StageGate2["Stage Gate 2: Aprovação"] HitL["Human-in-the-Loop (Aprovação do Implementation Plan)"] end subgraph Execution_StageGates3_5["Stage Gates 3-5: Construção & QA"] Goal["/goal (Execução Autônoma Contínua & Testes)"] Subagents["Subagentes em Paralelo (Prototyping, InfraSec, Data)"] end subgraph Audit_StageGate6["Stage Gate 6: Auditoria & Memória"] Walkthrough["Walkthrough & Evidências de Teste"] Learn["/learn (Gravação de Aprendizados nos KIs)"] end GrillMe --> HitL Boost --> HitL HitL --> Goal Goal --> Subagents Subagents --> Walkthrough Walkthrough --> Learn ``` --- ## 3. ESPECIFICAÇÃO DETALHADA DOS 15 AGENTES ### 🛠️ Squad Core de Engenharia (Spec-Driven Loop) #### 1. **Planner Agent** (`planner.md`) - **Propósito**: Decomposição de especificações aprovadas (`specify.md` e `design.md`) em planos de tarefas atômicos e ordenados em `tasks.md`. - **Limites de Autonomia**: Não escreve código de produção; não modifica o arquivo `specify.md` sem autorização. - **Entradas**: `specify.md`, `design.md`, `FOUNDATION.md`. - **Saídas**: `tasks.md`, checklist de validação por tarefas. #### 2. **Builder Agent** (`builder.md`) - **Propósito**: Escrita cirúrgica de código-fonte, criação de arquivos e refatoração respeitando estritamente o backlog do `tasks.md`. - **Limites de Autonomia**: Não altera dependências globais sem consultar o Planner; não remove testes sem autorização do QA. - **Entradas**: `tasks.md`, arquivos existentes no workspace. - **Saídas**: Código modificado, novos arquivos, diffs em markdown. #### 3. **Reviewer QA** (`reviewer-qa.md`) - **Propósito**: Testes adversários, execução de testes unitários/integrados, auditoria de cobertura de código e verificação de regressão. - **Limites de Autonomia**: Não aprova código com testes falhando; não aceita mocks genéricos para mascarar erros. - **Entradas**: Código gerado pelo Builder, suíte de testes. - **Saídas**: `validate.md`, relatórios de erros, aprovação do gate de testes. #### 4. **Auditor Agent** (`auditor.md`) - **Propósito**: Validação de compliance constitucional com a `Foundation` e selamento dos Stage Gates de governança. - **Limites de Autonomia**: Não altera regras constitucionais; possui poder de veto no Stage Gate 5. - **Entradas**: `validate.md`, `FOUNDATION.md`, logs de execução. - **Saídas**: Assinatura final do gate e selamento em `STATE.md`. --- ### 🏛️ Squad Executiva & Departamental #### 5. **Strategist_One** (`strategist-one.md`) - **Liderança**: Departamento de Estratégia & Visão Corporativa. - **Propósito**: Definição da North Star Metric, desdobramento de OKRs estratégicos e alinhamento do portfólio de produtos. #### 6. **Lead TLC Engineer** (`lead-tlc-engineer.md`) - **Liderança**: Departamento de Engenharia de Sistemas & Arquitetura. - **Propósito**: Garantia da integridade arquitetural do PCL AEOS, padronização da metodologia TLC v3 e resolução de débitos técnicos. #### 7. **CISO Security Agent** (`ciso-security-agent.md`) - **Liderança**: Departamento de Segurança & Infraestrutura Zero Trust. - **Propósito**: Sanitização de chaves de API, varredura adversária contra vazamento de segredos e imunização da rede mesh. #### 8. **BizOps Controller** (`bizops-controller.md`) - **Liderança**: Departamento de BizOps & Processos Ágeis. - **Propósito**: Monitoramento do fluxo de entrega, cadência de sprints dos agentes e eliminação de gargalos no pipeline. #### 9. **RevOps Architect** (`revops-architect.md`) - **Liderança**: Departamento de Growth & Funil GTM. - **Propósito**: Arquitetura do funil de conversão, integração de rotas de aquisição e métricas de retenção de usuários. #### 10. **Financial Advisor** (`financial-advisor.md`) - **Liderança**: Departamento de FinOps & Back Office. - **Propósito**: Controle do EBITDA Shield, precificação de inferências de IA, contagem de tokens e DRE real-time. #### 11. **Neuromarketing Strategist** (`neuromarketing-strategist.md`) - **Liderança**: Departamento de Branding & Percepção de Valor. - **Propósito**: Design de experiência visual, gatilhos de engajamento, Sexy Canvas e linguagem de alta percepção de valor. #### 12. **Data Insight Agent** (`data-insight-agent.md`) - **Liderança**: Departamento de Data Science & RAG. - **Propósito**: Análise de embeddings vetoriais no PostgreSQL (`pcl-db`), otimização de busca vetorial e modelos preditivos. #### 13. **Compliance Steward** (`compliance-steward.md`) - **Liderança**: Departamento LegalOps & Compliance Regulatório. - **Propósito**: Proteção de Propriedade Intelectual (PI), alinhamento com a LGPD e governança contratual. #### 14. **Skills Manager** (`skills-manager.md`) - **Liderança**: Departamento de People Ops & Gestão de Conhecimento. - **Propósito**: Curadoria do repositório de skills dos agentes, onboarding de novos integrantes e handoff de sessão. #### 15. **Persona Cortex** (Inteligência & Arquitetura Viva) - **Liderança**: Núcleo de Visualização & PCL Cortex Visual Engine. - **Propósito**: Ingestão de metadados do repositório, validação de limites de layout, compilação de diagramas interativos HTML e manutenção do Portal Mestre. --- ## 4. INTEGRAÇÃO COM OS DIAGRAMAS INTERATIVOS Esta especificação detalhada conecta-se diretamente aos diagramas do Portal Mestre: - 🔵 **[agents-squad-map.html](file:///c:/PromptCore_Labs/projects/Living%20Architecture%20PCL%20AEOS/diagrams/interactive/agents-squad-map.html)**: Visualização da orquestração de papéis. - 🟢 **[seq-tlc-execution.html](file:///c:/PromptCore_Labs/projects/Living%20Architecture%20PCL%20AEOS/diagrams/interactive/seq-tlc-execution.html)**: Sequência de execução entre Planner, Builder, QA e Auditor.