Skip to content

docs(assistente): o cartão de Alinhamento do Assistente - #973

Draft
leandrotcawork wants to merge 6 commits into
mainfrom
docs/conexus-assistant-align-card
Draft

leandrotcawork wants to merge 6 commits into
mainfrom
docs/conexus-assistant-align-card

Conversation

@leandrotcawork

@leandrotcawork leandrotcawork commented Nov 11, 2026 •

Copy link
Copy Markdown
Collaborator

O que é

O cartão de Alinhamento do Assistente, docs/steps/assistente-alinhamento-do-assistente.md, para a aprovação da página do fundador. Só documentos.

É o segundo cartão do trilho do Assistente. Ele espera no seu rascunho até O Assistente do dia a dia fechar (delivery L5). Por isso a verificação second-card fica vermelha nele de propósito, como no #951.

De onde vem

Três estudos fora do repositório (Ferramentas e web, Contexto e instruções, Conectores e máquina), o estudo do harness do Claude Code, e as palavras do fundador de 2026-11-11: "Proposta sua concordo" aos onze itens de engenharia; "1. B e D 2. B e C 3. A gente via implementar o Knowledge … 4. A" às escolhas de memória e busca; "Decisões: A - A" às duas decisões da página (cargo e área; a permissão D11 só dessas duas colunas); e, ao estudo do harness, "A1, porém estudar profudanmente vendo referencias e documentação usar context7 /mastra e o que precisar B2 Sim inclua vamos deixar nossa harness o mais alinhada possivel".

O ajudante de pesquisa (A1) foi estudado a fundo: a documentação instalada do @mastra/core 1.82.0 (AgentController.subagents), o código dele (createSubagentTool), o Context7 /mastra-ai/mastra para conferir, o explore e a ligação do Mastra Code (mastra-1.82@6e8dfcb8), e os tipos públicos do Agent SDK do Claude Code (AgentDefinition, 0.3.322) com as páginas de subagentes. Três achados entram na U12: o ajudante do Mastra nasce sem processadores, e usa a conta do turno pelo resolveSubagentModel, como o título; ele não enxerga a conversa (o contexto copiado leva resourceId: ''), e as leituras dele são montadas pelo tools do controlador com o escopo do principal; e a numeração dos arquivos das leituras passa a contar pela chave do turno, senão o ajudante sobrescreveria o primeiro arquivo do turno.

As unidades

Ordem do pull request: U1, U10, U2, U3, U4, U5, U11, U6, U12, U7, U8, U9.

  • U1 a máquina da conversa não morre mais a cada Release (Máquina da conversa: todo Release troca o nome do molde e a primeira mensagem seguinte apaga a máquina com os arquivos #971) e a frase dos caminhos (40 linhas)
  • U10 a frase em português de cada comando na máquina, para o Assistente e o Builder (40)
  • U2 as ferramentas de um passo em paralelo e a web do provedor (140)
  • U3 a linha "Fontes" (180)
  • U4 o contexto do Assistente: tarefas como estado, frases pelo papel no bloco, dia da semana, Observador, o que é um lembrete (165)
  • U5 a leitura grande diz linhas e bytes e manda abrir o arquivo (60)
  • U11 a prova com 27 perguntas para revisão do fundador e o placar por pergunta (0 de código; cerca de 300 de teste)
  • U6 as leituras tipadas sob demanda (320)
  • U12 o ajudante de pesquisa, só leitura, na conta da conversa, com a linha "Pesquisando:" (190)
  • U7 o recall e a memória de trabalho com o modelo de quatro seções, e a tela para ver e corrigir (450)
  • U8 cargo e área na conta (430)
  • U9 a memória e as instruções da empresa no Knowledge, contido por ser experimental (880)

Total: cerca de 2.895 linhas de código alterado, sem testes nem gerados (delivery L2).

Decisões na página

Nenhuma nova: as duas da rodada anterior têm a palavra do fundador, gravada na página. O item 5 do estudo do harness (skills de volta depois da observação) fica condicionado ao placar da U11. As palavras ainda não vão para docs/approvals.md: o cartão não foi aprovado; a aprovação da página entra lá quando vier (L6).

O que rodou

npm run docs: limpo, a não ser o second-card esperado. npm run radius lê as tabelas de raio das unidades novas sem recusa de padrão. Um leitor Sonnet que não escreveu o cartão leu o diff da rodada e as linhas citadas na versão instalada; os achados dele estão no último commit.

This branch has not been deployed

No deployments
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.

2 participants