# Notas e especificações

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

Fonte: https://ardumaker.com/pt/docs/notas-y-especificaciones/

- 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`

## 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](https://ardumaker.com/pt/docs/archivos-adjuntos). 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](https://ardumaker.com/pt/docs/plantillas).

## 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](https://ardumaker.com/pt/mcp/proyectos) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Anexos](https://ardumaker.com/pt/docs/archivos-adjuntos/)
- [Modelos de projeto](https://ardumaker.com/pt/docs/plantillas/)
- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Servidor MCP](https://ardumaker.com/pt/docs/servidor-mcp/)