CommunityPesquisa e Análise de Dadosgithub.com

grahama1970/argue

Orquestrador de debate estruturado com múltiplas personas. As personas pesquisam via /dogpile, consultam colegas via /ask e debatem em direção a uma síntese matizada — não a um vencedor.

O que é argue?

argue é uma skill multi-ferramenta que orquestra debates estruturados entre duas ou mais personas, cada uma com habilidades independentes como pesquisa profunda (/dogpile), consulta a colegas (/ask) e memória (/memory). O objetivo não é declarar um vencedor, mas produzir uma síntese matizada que capture pontos de acordo, desacordo genuíno, concessões e perguntas em aberto. A skill suporta plataformas compatíveis com o ecossistema de agents Claude Code, Cursor, Codex e SPARTA, e pode ser executada via CLI com `./run.sh argue`. O ciclo de debate inclui fases de pesquisa, argumentação, réplica e reflexão, com pontuação que premia concessões de qualidade e novidade argumentativa. O resultado final é um relatório estruturado que sintetiza as melhores evidências de cada persona, ideal para explorar problemas complexos onde respostas únicas são insuficientes.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/grahama1970/agent-skills/tree/main/skills/argue

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que argue faz?

Orquestrador de debate estruturado com múltiplas personas. Duas ou mais personas pesquisam independentemente via /dogpile, consultam colegas de domínio via /ask e debatem em direção a uma síntese matizada — não a um vencedor.

Por que não apenas perguntar a um único modelo?

Respostas de modelo único são confiantes, mas rasas. A compreensão real de problemas difíceis (Conjectura de Collatz, P vs NP, consciência, trade-offs de políticas) exige:

  • Múltiplas lentes de domínio sobre a mesma questão
  • Pressão adversarial — cada lado testa o raciocínio do outro
  • Profundidade de pesquisa — cada persona faz pesquisa /dogpile independente
  • Grafo social — personas podem /ask colegas por opiniões de especialistas
  • Registro de concessões — a síntese captura o que foi concedido e por quê
  • Raciocínio ponderado por BDI — os pesos das pontes da persona influenciam o estilo de argumentação

Arquitetura

┌──────────────────────────────────────────────────────────┐
│                  Orquestrador Argue                        │
│  - Ciclo de debate (pesquisar → argumentar → rebater → refletir) │
│  - Execução concorrente de personas                       │
│  - Terminação baseada em convergência                     │
│  - Geração de síntese                                     │
└──────────────────────────────────────────────────────────┘
         │                              │
    ┌────┴──────┐                 ┌─────┴─────┐
    │ Persona A  │                │ Persona B  │
    │ (Thread)   │                │ (Thread)   │
    ├────────────┤                ├────────────┤
    │ Skills:    │                │ Skills:    │
    │ - dogpile  │                │ - dogpile  │
    │ - ask      │                │ - ask      │
    │ - memory   │                │ - memory   │
    │ - taxonomy │                │ - taxonomy │
    └────────────┘                └────────────┘
         │                              │
         └──────────┬───────────────────┘
                    │
    ┌───────────────┴────────────────────┐
    │          Motor de Síntese           │
    │  - Argumentos mais fortes de cada   │
    │  - Pontos de concordância           │
    │  - Pontos de desacordo genuíno      │
    │  - Registro de concessões           │
    │  - Perguntas em aberto              │
    │  - Conclusão matizada               │
    └────────────────────────────────────┘

Comandos

# Duas personas debatem uma questão
./run.sh argue "A Conjectura de Collatz é decidível?" \
  --persona-a embry --persona-b horus --rounds 5

# Debate em painel com três participantes
./run.sh argue "Melhor abordagem para alinhamento de AGI" \
  --personas embry,horus,brandon --rounds 7

# Debate rápido de 3 rodadas com personas selecionadas automaticamente
./run.sh argue "Devemos usar microsserviços ou monolito?"

# Retomar debate interrompido
./run.sh resume <debate-id>

# Visualizar transcrição do debate
./run.sh transcript <debate-id>

# Gerar relatório de síntese
./run.sh synthesize <debate-id>

# Verificar status do debate
./run.sh status

Ciclo do Debate

Cada rodada segue pesquisar → argumentar → rebater → refletir:

Rodada k:

┌─────────────────────────────────────────────────────────────┐
│                    1. FASE DE PESQUISA                       │
├─────────────────────────────────────────────────────────────┤
│ Cada Persona:                                                │
│ - /dogpile sua questão a partir de sua lente de domínio      │
│ - /ask um colega para contribuição de especialista           │
│ - /memory recordar argumentos anteriores e conhecimento relevante │
│ - Revisar argumentos anteriores do oponente em busca de fraquezas │
│ (Orçamento: máximo de 3 chamadas de pesquisa por persona por rodada) │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                    2. FASE DE ARGUMENTAÇÃO                    │
├─────────────────────────────────────────────────────────────┤
│ Cada Persona:                                                │
│ - Apresentar posição com evidências + citações               │
│ - Referenciar descobertas do /dogpile e respostas de /ask de colegas │
│ - Marcar argumentos com atributos de ponte /taxonomy         │
│ - Restringido pelo estado BDI da persona e pesos das pontes  │
│   (persona de Alta Precisão → provas formais)                │
│   (persona de Alta Resiliência → implicações práticas)       │
│   (persona de Alta Fragilidade → casos extremos, modos de falha) │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                    3. FASE DE RÉPLICA                         │
├─────────────────────────────────────────────────────────────┤
│ Cada Persona:                                                │
│ - Contra-atacar os pontos mais fracos do oponente            │
│ - Reconhecer os pontos mais fortes do oponente (concessão forçada) │
│ - Identificar lacunas na evidência do oponente               │
│ - Propor refinamentos ou um meio-termo                       │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                   4. FASE DE REFLEXÃO                         │
├─────────────────────────────────────────────────────────────┤
│ Cada Persona:                                                │
│ - Arquivar episódio da rodada (argumentos, evidências, concessões) │
│ - Armazenar argumentos bem-sucedidos em /memory              │
│ - Atualizar estado de crença com base na evidência do oponente │
│ - Avaliar própria confiança (0.0-1.0) na posição atual       │
│ - Identificar o que mudaria sua opinião                      │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                   5. PONTUAÇÃO & PONTO DE VERIFICAÇÃO          │
├─────────────────────────────────────────────────────────────┤
│ Orquestrador:                                                │
│ - Pontuar força do argumento, qualidade da evidência, novidade │
│ - Rastrear registro de concessões                            │
│ - Verificar condições de terminação                          │
│ - Salvar ponto de verificação                                │
└─────────────────────────────────────────────────────────────┘

Capacidades das Personas

Cada persona no debate tem acesso completo a:

SkillFinalidade
/dogpilePesquisa profunda de múltiplas fontes (ArXiv, Brave, GitHub, YouTube, Perplexity)
/askConsultar uma persona colega para conhecimento de domínio
/memoryRecuperar conhecimento prévio, debates passados, fatos aprendidos
/taxonomyClassificar argumentos com pontes da Taxonomia Federada
/consume-bookPesquisar livros ingeridos em busca de evidências de apoio
/consume-youtubePesquisar transcrições em busca de palestras relevantes

O Padrão de Colega /ask

Durante a fase de pesquisa, as personas podem consultar colegas de seu grafo social:

Embry (engenheira aeroespacial, Precisão=0.85):
  → /ask brandon "Qual é o ângulo de complexidade computacional sobre Collatz?"
  → Brandon (estagiário SPARTA, entusiasta): Retorna perspectiva da teoria da complexidade
  → Embry incorpora isso em seu argumento formal

Horus (IA, Resiliência=0.80):
  → /ask embry "A abordagem de sistemas dinâmicos realmente converge?"
  → (Embry está ocupado argumentando, então Horus consulta /memory por declarações anteriores de Embry)
  → Horus usa isso para desafiar a suposição de convergência

A consulta a colegas adiciona:

  • Diversidade de domínio além dos próprios debatedores
  • Prova social — "meu colega que é especialista em X confirma..."
  • Polinização cruzada — argumentos enriquecidos por expertise adjacente

Sistema de Pontuação

Ao contrário de battle (que tem um vencedor), argue pontua a qualidade do debate:

MétricaPesoDescrição
Qualidade da Evidência2xFontes citadas, profundidade /dogpile, revisadas por pares
Novidade do Argumento1.5xNova perspectiva não levantada antes
Qualidade da Concessão2xReconhecer pontos fortes do oponente (isso é BOM)
Coerência Lógica1xConsistência interna
Precisão da Réplica1xAborda alegações específicas, não homens de palha
Calibração da Confiança0.5xConfiança corresponde à força da evidência

Diferença chave de battle: Concessões são pontuadas POSITIVAMENTE. Uma persona que concede um ponto forte e refina sua posição pontua mais alto do que uma que mantém posição dogmaticamente sem evidência.

Condições de Terminação

O debate termina quando QUALQUER condição é atendida:

  1. Convergência: Deltas de confiança de todas as personas < 0.1 por 2 rodadas (elas concordam)
  2. Produção Nula: Nenhum novo argumento ou evidência por 2 rodadas
  3. Rodadas Máximas: Limite configurado atingido
  4. Síntese Pronta: Orquestrador detecta material suficiente para conclusão matizada
  5. Interrupção: Terminação manual via ./run.sh stop

Saída da Síntese

Após a terminação, o orquestrador gera uma síntese estruturada:

# Síntese do Debate: A Conjectura de Collatz é Decidível?

## Participantes
- **Embry** (Engenheira Aeroespacial, Precisão=0.85) — Lente formal/matemática
- **Horus** (IA, Resiliência=0.80) — Lente computacional/prática

## Rodadas: 5 | Terminação: Convergência

## Pontos de Concordância
1. O problema generalizado 3n+1 é indecidível (Conway 1972)
2. Abordagens atuais via tempos de parada mostram convergência estatística
3. Uma prova provavelmente requer novo maquinário matemático

## Pontos de Desacordo Genuíno
1. Se abordagens da teoria da medida podem preencher a lacuna (Embry: sim, Horus: insuficiente)
2. A relevância da verificação computacional até 2^68 (Horus: significativa, Embry: irrelevante para a prova)

## Registro de Concessões
- Rodada 2: Embry concedeu que a verificação até 2^68 fornece confiança heurística útil
- Rodada 3: Horus concedeu que o resultado de indecidibilidade de Conway para formas generalizadas
  não implica diretamente indecidibilidade do caso específico 3n+1
- Rodada 4: Ambos concederam que o teorema da densidade de Terras é o resultado positivo mais forte

## Argumentos Mais Fortes
1. [Embry, Rodada 3] Análise da função de Syracuse via sistemas dinâmicos mostra...
2. [Horus, Rodada 2] A equivalência FRACTRAN demonstra riqueza computacional...

## Perguntas em Aberto
1. Os resultados parciais de Tao (2019) sobre "quase todos" os inteiros podem ser estendidos?
2. Existe uma barreira de complexidade para uma prova elementar?

## Conclusão Matizada
A Conjectura de Collatz ocupa uma posição única: comprovadamente difícil em sua forma generalizada (Conway), mas o caso específico 3n+1 pode ser tratável. A evidência mais forte para resolução eventual vem do resultado de Tao de 2019 mostrando que quase todas as órbitas atingem valores próximos a 1. No entanto, a lacuna entre "quase todos" e "todos" pode exigir técnicas fundamentalmente novas...

## Fontes
- [ArXiv] Tao (2019) "Almost all orbits of the Collatz map attain..."
- [ArXiv] Conway (1972) "Unpredictable iterations"
- ...

Arquitetura de Memória

Cada persona mantém memória de debate isolada:

debates/<debate-id>/
├── config.json              # Pergunta, personas, configurações
├── transcript.md            # Transcrição completa do debate
├── synthesis.md             # Relatório final de síntese
├── persona_a/
│   ├── research/            # Resultados do /dogpile por rodada
│   ├── colleague_consults/  # Respostas do /ask
│   ├── arguments/           # Argumentos submetidos por rodada
│   ├── concessions.json     # O que concederam e quando
│   └── confidence.json      # Trajetória de confiança ao longo das rodadas
├── persona_b/
│   └── ...
└── scoring/
    ├── round_001.json
    ├── round_002.json
    └── summary.json

Personas não podem acessar a pesquisa do oponente — apenas seus argumentos publicados. Isso evita curto-circuito da pressão adversarial.

Modos de Debate

1. Adversarial (padrão)

Duas personas assumem posições opostas. Bom para perguntas com lados claros.

./run.sh argue "Monolito vs microsserviços" --mode adversarial

2. Painel

Três ou mais personas discutem de diferentes ângulos. Bom para perguntas complexas.

./run.sh argue "Abordagens para alinhamento de AGI" --mode panel --personas embry,horus,brandon

3. Socrático

Uma persona faz perguntas investigativas, a outra defende. Bom para testar ideias sob pressão.

./run.sh argue "Nossa arquitetura SPARTA é sólida" --mode socratic --questioner horus --defender embry

4. Advogado do Diabo

Uma persona é forçada a argumentar contra uma posição com a qual poderia concordar. Bom para encontrar pontos cegos.

./run.sh argue "Rust é melhor que C++ para sistemas embarcados" --mode devils-advocate --advocate embry

Skills Utilizadas

SkillUsada PorFinalidade
dogpileTodas as personasPesquisa profunda de múltiplas fontes por rodada
askTodas as personasConsultar personas colegas para contribuição de especialista
memoryTodas as personasRecuperar conhecimento prévio + armazenar aprendizados do debate
taxonomyTodas as personasMarcar argumentos com atributos de ponte
consume-bookTodas as personasPesquisar livros ingeridos em busca de evidências
consume-youtubeTodas as personasPesquisar transcrições de palestras em busca de evidências
episodic-archiverOrquestradorArquivar debates concluídos
task-monitorOrquestradorAcompanhamento de progresso para debates longos

Sessão de Exemplo

# Embry e Horus debatem a Conjectura de Collatz
./run.sh argue "A Conjectura de Collatz é decidível?" \
  --persona-a embry --persona-b horus --rounds 5

# Saída:
# ID do Debate: argue_20260212_153000
# Pergunta: A Conjectura de Collatz é decidível?
# Personas: Embry (Precisão=0.85) vs Horus (Resiliência=0.80)
# Modo: Adversarial
#
# Rodada 1/5
# [Embry] Pesquisando via /dogpile "Collatz dynamical systems Terras theorem"...
# [Embry] /ask brandon "ângulo da teoria da complexidade sobre tempos de parada de Collatz"
# [Horus] Pesquisando via /dogpile "Collatz undecidability Conway FRACTRAN"...
# [Horus] /ask embry "a teoria da medida fecha a lacuna sobre quase todos..."

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

grahama1970/acceptance-contract

Turn a client brief, zip bundle, directory, or single requirements file into a typed acceptance-contract bundle with extracted requirements, acceptance checks, open questions, an immutable-goal draft, and a create-report-backed decision report. Use when users say acceptance contract, brief to requirements, freeze the goal, create immutable goal, amend immutable goal, build a Battle requirements bundle, or extract requirements from this bundle.

grahama1970/agent-ecosystem

Canonical map and shared contracts for the agent-governance ecosystem: the pi.receipt_envelope.v1 boundary envelope, the component graph, and the rules for which component owns which schema. Use when wiring a skill or extension into the shared receipt world, when asking how shame, triage-error, tau, ask, project-watchdog, ops-herdr, ponytail, and Memory fit together, or when validating an envelope.

grahama1970/agentic-evals

Agentic evaluation of skills using multi-trial fixtures, deterministic command assertions, trajectory checks, safety constraints, and evidence-backed readiness scoring. Use when users ask for agentic evals, multi-trial skill evaluation, skill trajectory validation, or readiness scoring for a skill workflow.

grahama1970/agent-inbox

File-based inter-agent messaging with headless dispatch. Check inbox, send bugs/requests to other projects, automatically spawn headless agents to fix bugs, and track progress via task-monitor.

grahama1970/agents-registry

Generate and query the centralized agent identity registry. Scans .pi/agents/*/AGENTS.md, parses frontmatter, outputs agents-registry.json and optionally syncs to /memory for semantic search.

grahama1970/agent-status

Artifact-driven status surfaces for long-running project-agent work. Maintains status.json, events.jsonl, proof manifests, and a stale-aware STATUS.html so humans can tell where the agent is, what passed, what is still unproven, and what decision or action is next — without dashboard theater.

grahama1970/align

Round-based context alignment before execution. Use when the human, project agent, WebGPT, scillm, ask, dogpile, memory, or project-knowledge may each hold different facts about a task; especially before ambiguous design, infographic, product workflow, high-stakes implementation, plan-iterate, project-infographic, or multi-review work.

grahama1970/analytics

Flexible data science analytics for any dataset. Auto-discovers schema, recommends charts, exports to create-figure. Works with JSONL, JSON, CSV from any source.

grahama1970/analyze-chatterbox-emotions

Evaluate generated Chatterbox voice files as voice-quality artifacts: affect match, arousal/valence proxies, pause placement, intelligibility inputs, clipping, loudness, and discontinuity flags. Use when reviewing Chatterbox emotional tags, pauses, Turbo/base affect delivery, Persona Dream utterance renders, or whether generated speech matches an intended product-facing affect.

grahama1970/analyze-elf

Reverse-engineer features from ELF binaries. Extracts CLI commands, state machines, protocols, Zod schemas, and data models. Automatically generates a /create-walkthrough prosecution brief with Mermaid diagrams. Uses /treesitter for AST analysis of bundled JS/TS source.

grahama1970/animation-vocabulary

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

grahama1970/anonymize-data

Anonymize supported CSV, JSON, UTF-8 text, and SQLite files using an explicit policy through the oai-trial project. Use for anonymize data, pseudonymize exports, redact policy literals, or discover and explicitly approve fuzzy name aliases. The skill is a thin CLI/Docker interface, not another engine.

grahama1970/anvil

Heavy-duty "No-Vibes" debugging and hardening orchestrator. Use this for complex, stubborn bugs where `review-code` has failed, or for "Red Teaming" (hardening) a codebase. Runs multiple agents in parallel (Thunderdome) using git worktree isolation.

grahama1970/apple-design

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

grahama1970/arxiv

Search arXiv for papers and extract knowledge into memory. Use `search` to find papers, `learn` to extract knowledge.

grahama1970/ask

Use when the user asks to query project memory, ask an oracle, use supported browser-backed reviewers, run Tau roundtable/single-handler workflows, ask Pi-native subagents from within Pi, run persona/deep-review workflows, generate image prompts, check OS/project health through composed skills, or run an ask DAG. This skill is the executable /ask runtime; do not replace it with an informal subagent, plain web search, or hand-written review; inside Pi, explicit Pi-native subagent targets are routed through the pi-subagents tool as an Ask target type.

grahama1970/assess

Step back and critically reassess project state. Use when asked to "assess", "step back", "fresh eyes", "check alignment", "sanity check", "health check", "prune documentation", or "evaluate what's working". Offers documentation pruning and doc-code alignment analysis. Offer to run after major changes (don't auto-run).

grahama1970/assistant

Shared GPT + classifier inference gateway for persona monitor tasks. Routes validation and classification through a 4-tier cascade: heuristic → classifier → local GPT → scillm.

grahama1970/assistant-lab

Self-improvement workbench for /assistant. All the tools needed to diagnose, train, evaluate, and promote models in a continuous loop. The "warm pond" where /assistant evolves its own inference stack.

grahama1970/batch-quality

Pre-flight validation and quality gates for batch LLM operations. ACTUALLY tests samples through LLM before burning tokens. Uses SPARTA contracts for DuckDB validation queries. Integrates with task-monitor for enforced quality gates.

Habilidades Relacionadas