Carlomos7/commander-vault

Cofre de Decks Commander (líder)

Solicitação: $ARGUMENTS

Carregue agora: mtg-research e commander-deckbuilding (o conhecimento), depois leia references/theme-rules.md. Invocado como /mtg:commander-vault quando instalado como plugin. Caminhos para briefs: MTGDB=${CLAUDE_PLUGIN_ROOT}/scripts/mtgdb.py (os mesmos comandos das ferramentas MCP mtgdb; subagentes podem usar qualquer um). Scripts de página: PAGES=${CLAUDE_SKILL_DIR}/scripts (veja references/pages.md). Execute cada script com uv run. Passe --themes vault/themed-printings.json (e --reasons vault/<slug>/off-theme.json) em execuções de cofre que tenham um tema.

Estado atual

test -f vault/plan.md && { echo "RETOMANDO. plan.md:"; cat vault/plan.md; } || echo "Execução nova, sem vault/ aqui."
test -f deck-brief.md && { echo "DECK EM ANDAMENTO. deck-brief.md:"; cat deck-brief.md; ls *.txt 2>/dev/null; } || echo "Nenhum deck em andamento aqui."

Retomando: continue a partir do primeiro portão não verificado. Não refaça um portão aprovado a menos que solicitado.

Começando pelo deck em que você está trabalhando. Se a solicitação estiver vazia ou disser "este deck" (ou nomear um arquivo de deck), e houver um deck em andamento (um deck-brief.md e seu <commander-slug>.txt da skill de construção de deck, nesta pasta ou mais cedo nesta conversa), construa o cofre em torno dele em vez de pedir uma colagem:

• O brief preenche a solicitação: comandante, bracket, linhas duras, resposta de dinheiro, preferência de coleção, deve/nunca incluir, tema.
• A lista existente se torna o deck daquele comandante no seu bracket: copie para vault/<slug>/b<N>.txt, execute as verificações G2 nele, e não o reconstrua a menos que uma verificação falhe.
• Faça uma pergunta (AskUserQuestion): "O que o cofre deve adicionar?" com "Brackets vizinhos para este comandante (Recomendado)" · "Outros comandantes também (nomeie-os)" · "Apenas uma página para este deck" (esta última: renderize conforme references/pages.md e pare; nenhum agente necessário).

Modelo de precisão (por que os portões existem)

1. Fatos computados (legalidade, impressões, preços, Game Changers, contagens): apenas de mtgdb.py. Agentes não podem afirmá-los de outra forma.
2. Alegações com fonte (planos, must-plays, combos, cEDH): registradas em claims.jsonl, auditadas por script.
3. Verificação independente: vault-verifier, que não escreveu o trabalho, reabre fontes e reexecuta verificações.
4. Julgamento do líder: você resolve toda alegação de alto impacto refutada ou não verificável.
5. Divulgação: a página mostra datas dos dados, verificações executadas e o que permaneceu não verificado.

Captação

A solicitação é colada após o comando ou passada como arquivo, e geralmente segue o modelo vault-request.md do repositório (linhas como Brackets: 2 e 3; texto entre parênteses é uma dica, não uma resposta) (seções: sobre o que é, tabela e carteira, suas cartas, o que vai na página). Resolva: comandantes, brackets + padrão, orçamento, estilo de preço, linhas duras, preferência de coleção e cartas próprias, deve/nunca incluir, agrupamento de abas, extras da página, estilo de rótulo (vereditos neutros padrão: Jogar, Bom, Situacional, Encadernar, Bracket 4+; nunca "fraco"), e tema (padrão nenhum; se desejado, a pergunta de captação themes.md: modo, franquia, limites, premium). Extras que o modelo de página ainda não pode renderizar (comandantes alternativos, planejador de coleção, dividir uma pilha entre jogadores) vão como arquivos Markdown em vault/ (alternatives.md, collection-plan.md): cada colocação passa mtgdb.py validate identidade de cor para aquele deck, e cartas que não cabem em nenhum comandante são listadas com suas cores. Anote a lacuna do modelo em plan.md. Pergunte (AskUserQuestion, múltipla escolha) apenas para aqueles; para o resto, use padrões. Se o usuário fizer uma pergunta, responda-a e não construa. Acima de 6 comandantes ou 18 decks: informe a escala e confirme. Escreva vault/plan.md: entradas, slugs, matriz de brackets, padrões, a estimativa de custo, e a lista de verificação G0 a G5.

G0 Configuração (você)

• mtgdb.py status --remote, então mtgdb.py sync para qualquer coisa desatualizada (cartas, tags, rulings, combos, regras; cerca de um minuto), depois mtgdb.py selftest. Uma falha interrompe a execução até ser explicada.
• Leia o mais recente anúncio de bracket / Game Changers / banimento da Wizards. Se for mais novo que commander-deckbuilding/references/brackets.md, anote as mudanças em plan.md e inclua-as em cada brief.
• Verifique add-ons chamando-os, não lendo nomes, conforme as regras de add-on na skill mtg-research (references/sources.md, "Servidores MCP Opcionais"): uma chamada barata por capacidade (dados EDHREC, links de deck, estimativa de bracket, transcrições, pesquisa web). Escreva quais capacidades responderam em plan.md; para cada uma ausente, diga quais verificações não serão executadas.
• Tema (pule quando o modo for nenhum): escreva vault/theme-spec.json e construa vault/themed-printings.json com theme-build (theme-rules.md). Para estrito, execute theme-pool por comandante. Depois verifique o mapa em ambos os sentidos:
  • Falsos positivos: contact-sheet de cada impressão de Secret Lair mapeada; olhe você mesmo e remova qualquer coisa fora do tema.
  • Lacunas: execute search para o tema em nomes, arte (art:) e sabor (ft:) em todos os conjuntos e diferencie do mapa.
  • Mostre ao usuário a lista final de remoções/conjuntos em uma linha.
• Defina o corte de recência SINCE = data da atualização mais recente de banimentos/Game Changers.
• Escreva vault/config.json: {"since": SINCE, "budget": <número ou null>, "commanders": {"<slug>": 1 ou 2}}. O hook do plugin o lê: toda vez que alguém escreve vault/<slug>/b<N>.txt ou um claims*.jsonl, o hook o valida e alimenta falhas diretamente de volta ao escritor. Hooks não substituem seus portões; eles param arquivos ruins cedo.
• Extras de dados: mtgdb.py sync prices (uma vez por execução) para preços de fornecedor na escada de preço; se o usuário tiver uma coleção, collection show e pergunte se as cartas próprias devem ser preferidas.

G1 Pesquisa (vault-researcher, paralelo, 2 a 3 comandantes cada)

Brief: references/briefs.md §1. Portão: para cada comandante, mtgdb.py audit-claims vault/<slug>/claims.jsonl --since SINCE passa; research.md tem todas as seções.

G2 Piloto, depois decks (vault-deckbuilder)

Construa o bracket padrão para um comandante primeiro (§2). Execute as verificações G2 nele. Corrija o brief se o agente leu algo errado. Depois distribua. Portão, todo deck, executado por você (nunca confie no relatório do agente):

• mtgdb.py --themes vault/themed-printings.json validate <deck> --bracket N [--budget X]
• mtgdb.py combos <deck> (dados Spellbook locais; B1 a B3: sem combos de 2 cartas) e, se um add-on oferecer, uma estimativa de bracket
• Avisos themed_printing_available corrigidos ou justificados
• Cada par consider.json passa swaptest

G3 Mesclagem (vault-merger, um por aba)

§3. Portão: toda carta em merged.json aparece em pelo menos um dos arquivos consider.json daquela aba; contagem corresponde; cada par passa swaptest (reexecute você mesmo uma amostra de 25%, todas para B3 e abaixo).

G4 Verificar (vault-verifier, contexto novo, um por 3 a 4 comandantes)

§4. Ele verifica 100% das alegações de alto impacto e uma amostra de 20% do resto, reexecuta toda verificação de deck, e verifica impressões disputadas olhando a arte. Portão: mtgdb.py audit-claims vault/<slug>/claims.verified.jsonl --since SINCE --require-verified passa, e cada item refuted / unverifiable em verification.md é resolvido por você: corrigido, removido ou mantido com um rótulo visível "não verificado".

G5 Página (você, seguindo references/pages.md)

1. site_data.py init vault/site-data.json (com --themes se temático), então para cada deck add-deck (deck-notes.md dos agentes condensado em notes.json por deck), add-tier por aba de nível (números EDHREC com n), add-swaps por aba, add-claims com cada claims.verified.jsonl.
2. build_site.py vault/site-data.json --out vault/site. Corrija todo erro.
3. Siga os passos 4 e 5 do pages.md: olhe em desktop e 390 px, verifique 10 cartas aleatórias contra mtgdb.py, publique.
4. Responda em poucas linhas: o que há nele, contagens de tema (cofres temáticos), resumo de precisão (alegações verificadas / rotuladas não verificadas, datas dos dados), exceções aceitas.

Não construa ou reestilize a página manualmente. Se o modelo estiver faltando algo que todo cofre precisa, anote em plan.md como uma mudança de modelo para depois.

Quando as coisas mudam no meio da execução

• Redirecionamentos do usuário (novo foco de bracket, regra de tema, orçamento): atualize plan.md e config.json primeiro, depois SendMessage para cada agente em execução a mudança exata, então reavalie qualquer coisa já construída sob a regra antiga.
• Agentes morrem (reinício de sessão, falha): verifique quais arquivos existem, reinicie apenas o trabalho faltante, ou faça você mesmo se for pequeno. Nunca espere por um agente que não está rodando.
• Uma ferramenta está fora: diga qual verificação não foi executada e marque itens afetados como não verificados. Nunca preencha a lacuna manualmente.

Escala e custo (decida na captação, escreva em plan.md)

Tempo aproximado de agente: cerca de 10 a 20 minutos por comandante para pesquisa, cerca de 10 por deck para construir, e verificação cerca de metade do tempo de construção novamente. Um cofre de 12 comandantes e 40 decks levou várias horas.

• Escopo padrão: o bracket do usuário mais um acima. B5 apenas quando solicitado, e apenas para comandantes com evidência real de cEDH (entradas EDHTop16). Para outros, diga "não é um comandante cEDH real" em vez de construir uma lista B5 que ninguém vai jogar.
• Tamanho padrão: até 6 comandantes. Acima disso, confirme a estimativa primeiro, ou divida em vários cofres.
• Escopo do verificador: 100% das alegações de alto impacto, mas com limite de 40 por comandante. Se houver mais, verifique as 40 que aparecem na página (must-plays, combos, cEDH) e rotule o resto como não verificado.
• Dados pesados opcionais: prices-sync --history (um download grande) apenas se a página mostrar tendências de preço.
• Pule o que é barato pular: sem passagem comunitária para B5 (dados de torneio decidem), sem pesquisa no YouTube para comandantes com menos de cerca de 200 decks EDHREC (pouco conteúdo existe; apenas dados e Spellbook).
• Nunca corte: validação, verificações de combo Spellbook, o hook, as verificações de mapa de tema, a verificação de renderização G5.

Custo e contexto

• Agentes escrevem arquivos e retornam relatórios curtos. Leia seus arquivos apenas nos portões.
• Sem chamadas Scryfall ao vivo por carta; o índice cobre isso.
• Registre toda correção que você fizer em plan.md para que uma execução retomada saiba.