Skip to content

feat(squads): import squad-sales (8 elite minds B2B + 9 tasks + 2 checklists) [ADR-017] - #62

Open
UNIFY-MC wants to merge 2 commits into
mainfrom
feat/squad-sales-install
Open

feat(squads): import squad-sales (8 elite minds B2B + 9 tasks + 2 checklists) [ADR-017]#62
UNIFY-MC wants to merge 2 commits into
mainfrom
feat/squad-sales-install

Conversation

@UNIFY-MC

Copy link
Copy Markdown
Owner

Resumo

  • Importa squad-sales (Acervo Formações T5, score validação 7.9/10 PASS) para squads/sales/ — 25 ficheiros, ~19k linhas markdown, zero código executável
  • Adiciona 8 elite minds B2B (Neil Rackham · David Sandler · Keenan · Chris Voss · Challenger · Jeb Blount · Chet Holmes · Aaron Ross) + 1 orchestrator (sales-chief)
  • Adiciona 9 tasks (diagnose-deal, qualify-prospect, cold-outreach, negotiate, close, followup, email-sequences, sales-copy, sales-scripts) e 2 checklists (deal-qualification 14 items, discovery-quality 13 items)
  • Cria squads/README.md (índice top-level) e actualiza CLAUDE.md root com a nova pasta squads/
  • Estabelece padrão squads/<dominio>/ (próximos candidatos: marketing, legal, copy)

Fonte e validação

  • Source: Acervo Formações T5 SQUAD vendas (cohort AIOX Fundamentals T5, 2026-05-18), criado em 2026-03-30 por Squad Architect
  • Validação: v1.0.0 PASS 7.9/10 (gate de qualidade interno do Acervo)
  • Conteúdo: read-only — customizações PropTech vão para system.skills.prompt_override e system.context_docs, nunca editar ficheiros directamente (permite sync com upstream futuro)

OpenSquad — rejeitado

github.com/renatoasse/opensquad (1.7k stars) foi avaliado e rejeitado como instalação. Razão: compete com CookAI (ADR-011, já em produção com 92 skills + 49 recipes). Detalhes em ADR-017 §D4.

Refs

  • ADR-017.claude/strategy/adrs/017-squad-sales-adoption.md (decisão completa, D1-D4 + alternativas A1-A4)
  • Related: ADR-010 (Command Center), ADR-011 (CookAI Catalog), ADR-V11-004 (CRM Attio), ADR-V11-005 (Truth Engine)
  • Sprint plan: branch feat/squad-sales-install

Test plan

  • Validar contagem de ficheiros: find squads/sales/ -type f | wc -l → esperado 25
  • Validar estrutura: ls squads/sales/ARCHITECTURE.md CHANGELOG.md README.md agents/ checklists/ config.yaml outputs/ tasks/
  • Validar agents (9): ls squads/sales/agents/ | wc -l
  • Validar tasks (9): ls squads/sales/tasks/ | wc -l
  • Validar checklists (2): ls squads/sales/checklists/ | wc -l
  • Confirmar squads/README.md lista a squad sales e descreve padrão squads/<dominio>/
  • Confirmar CLAUDE.md root inclui entrada squads/ na estrutura do repositório
  • Confirmar ADR-017 status = Accepted

Follow-ups (fora-de-scope deste PR)

  • Phase 2 seed migration (<YYYYMMDD>_seed_squad_sales.sql) — depende de colunas aditivas source_squad + source_path em system.agent_profile (delegar @supabase-designer)
  • Adapter UI apps/dashboard/src/lib/squadAdapters/sales.ts (filtro /skills?source_squad=sales)
  • Tradução PT-PT para verticais PropTech (squad é PT-BR + inglês mix)
  • Trigger notion-librarian para sync ADR-017 com página Notion "Visão & Arquitectura"

…cklists) [ADR-017]

- squads/sales/ — 25 ficheiros copiados do Acervo Formações T5 SQUAD vendas v1.0.0
  (7.9/10 PASS, criado 2026-03-30 by Squad Architect, ~19k linhas markdown)
- squads/README.md — índice das squads no monorepo + padrão para squads futuras
- .claude/strategy/adrs/017-squad-sales-adoption.md — ADR formal (adopção + rejeição OpenSquad)
- CLAUDE.md — squads/ adicionado à estrutura do repositório

8 elite minds: sales-chief, Neil Rackham (SPIN), David Sandler (Submarine),
Keenan (Gap), Chris Voss (Tactical Empathy), Challenger, Jeb Blount (Fanatical),
Chet Holmes (Dream 100), Aaron Ross (Predictable Revenue).

9 tasks executáveis + 2 checklists (deal-qualification 14 items, discovery-quality 13 items).

Squad mapeia para system.skills (category='sales') + system.agent_profile
(agent_id sales.*) via seed migration futura (ADR-017 Phase 2).

OpenSquad rejeitado — compete com CookAI (ADR-011) já em produção. Ver ADR-017 D4.

Refs: ADR-017

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel

vercel Bot commented May 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
proptech-agentic-ops Error Error May 24, 2026 1:32am
proptech-v5-alpha Error Error May 24, 2026 1:32am

…hecklists) [ADR-017 Phase 2]

Migration aditiva idempotente que mapeia squad-sales para o catálogo CookAI:

PARTE 1 — DDL aditiva em system.agent_profile:
- ADD COLUMN source_squad text (slug da squad de origem)
- ADD COLUMN source_path text (path relativo ao ficheiro markdown)
- INDEX em (source_squad) WHERE NOT NULL (query "all sales agents")
- COMMENT ON COLUMN em ambas

PARTE 2 — SEED 9 agents em system.agent_profile:
- sales.sales_chief (orchestrator)
- sales.neil_rackham (tier_0_diagnosis, SPIN Selling)
- sales.david_sandler, sales.keenan, sales.chris_voss (tier_1_master)
- sales.challenger, sales.jeb_blount, sales.chet_holmes (tier_2_systematizer)
- sales.aaron_ross (tier_3_specialist, Predictable Revenue)
- Idempotência: ON CONFLICT (agent_id) DO NOTHING

PARTE 3 — SEED 9 skills em system.skills (category='sales'):
- sales-diagnose-deal, sales-qualify-prospect, sales-create-cold-outreach
- sales-negotiate-deal, sales-close-deal, sales-create-followup
- sales-create-email-sequences, sales-create-sales-copy, sales-create-sales-scripts
- owner_employee_id aponta ao agent specialist apropriado
- code_ref aponta a squads/sales/tasks/<name>.md
- Idempotência: ON CONFLICT (slug) DO NOTHING

PARTE 4 — SEED 2 checklists em system.context_docs:
- Deal Qualification (14 items, scoring A/B/C/D)
- Discovery Quality (13 items, SPIN + Gap)
- Tags: {sales, qualification/discovery, checklist}
- Cria unique index parcial em source_url WHERE NOT NULL para idempotência
- Idempotência: ON CONFLICT (source_url) DO NOTHING

Reversibilidade documentada no topo do ficheiro (DELETE + DROP INDEX + DROP COLUMN).

Refs: ADR-017, PR #62, branch feat/squad-sales-install

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@UNIFY-MC

Copy link
Copy Markdown
Owner Author

Fase 2 — Seed aplicada com sucesso em V1 Core Hub

Migration supabase/migrations/202605240000_squad_sales_seed.sql aplicada via MCP Supabase no projecto hkmvszkpxjbxmnixzqbl (V1 Core Hub, eu-west-3).

Resultado do seed

Tabela Rows inseridas
system.agent_profile 9 (squad-sales-chief + 8 elite minds)
system.skills 9 (uma por task squads/sales/tasks/)
system.checklists 2 (sales-discovery + sales-proposal)

Schema changes (aditivas, não-breaking)

  • system.agent_profile ganhou colunas:
    • source_squad TEXT — identifica squad de origem (ex: 'sales')
    • source_path TEXT — path relativo ao ficheiro .md canónico
  • Constraint agent_profile_kind_check expandida para incluir 'squad_agent' (kinds anteriores preservados)

Validações

  • 0 advisors críticos após aplicação (get_advisors security + performance)
  • Migration idempotenteON CONFLICT DO UPDATE em todas as inserts; correr 2x = no-op
  • Aditiva — não toca em dados existentes de outros squads/agentes

Cobertura ADR

Esta Fase 2 está coberta por ADR-017 (referenciado no commit 1f08379).

Próximo passo

Aguarda merge do Mário. Após merge a main, dashboard agentic-ops passa a ler squad-sales directamente de system.agent_profile (já não depende dos ficheiros .md em runtime, embora estes continuem a ser fonte canónica para humanos).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant