Notas e especificações

Notas de texto do projeto para specs, decisões e acessos, com arquivos associados e leitura via MCP.

  • Categoria: Projetos e empresas
  • Estado: Disponível
  • Requisitos: Acesso de nível aportar ou superior na seção Anexos
  • Ferramentas MCP (Só leem): ver_adjunto, listar_adjuntos, buscar_en_proyecto
  • Ferramentas MCP (Escrevem ou modificam): crear_adjunto, editar_adjunto

Markdown

O que permite fazer?

Não há um módulo de especificações à parte: as notas são anexos do tipo nota e vivem junto dos outros anexos. As etapas e tarefas têm ainda a sua própria descrição.

  • Escrever texto livre: requisitos, decisões, procedimentos, acessos.
  • Associar arquivos à nota (um contrato com os anexos, por exemplo).
  • Editar o texto sem perder os comentários.
  • Marcá-la como secreta.

Quando convém usar?

  • Para deixar o contexto do projeto escrito e ao alcance da equipe.
  • Para que um agente leia as especificações antes de criar tarefas.
  • Para que cada projeto novo comece com notas de base, carregadas em um modelo.

Como funciona na ArduMaker?

  • O texto de uma nota edita-se no lugar; os outros tipos de anexo não têm texto editável.
  • A pesquisa do projeto encontra notas por nome, slug ou texto.
  • Uma nota secreta só é vista por completo por quem a criou ou por quem administra a seção Anexos.

O que muda realmente?

  • Cada criação ou edição fica no histórico do projeto.
  • Apagar uma nota é reversível durante 30 dias.

Resultado esperado

A nota fica no repositório do projeto e pode ser citada a partir de comentários e checklists.

Erros e resolução

  • Tentar alterar o texto de um anexo que não é nota dá erro: não tem texto editável.
  • Uma nota muito longa lê-se por partes via MCP; contenido_recortado indica como pedir a seguinte.

Relação com MCP

  • Ler: ver_adjunto (até 30000 caracteres por parte), listar_adjuntos e buscar_en_proyecto.
  • Escrever: crear_adjunto com tipo='nota' e editar_adjunto para o texto.
  • Um agente não pode criar notas secretas nem tocar nas que já o são.

Mais em /mcp/proyectos e /mcp/docs.

Funcionalidades relacionadas