Library

O que é a Library?

A Library é um navegador de arquivos para o filesystem compartilhado da sua organização — acessível pela aba Library no topo do painel principal. É a janela voltada para pessoas sobre os mesmos arquivos que seus agents leem e escrevem: tudo o que um agent salva no filesystem da org aparece aqui, e tudo o que você solta aqui fica disponível para seus agents.

Pense nela como o drive compartilhado da sua organização, com algumas áreas bem conhecidas.

Sua pasta home

A Library abre na pasta da sua própria organização, com o nome da sua org. Ela é compartilhada e de formato livre: é aqui que os agents registram conhecimento durável e onde você guarda o contexto que quer deixar ao alcance de todos os agents. Todo mundo na org pode editar.

Pastas de sistema

Três pastas dentro dela são preenchidas pelo produto, não à mão. Elas têm um ícone de pasta cinza distinto, fácil de diferenciar das pastas que seu time criou:

uploads — arquivos anexados a conversas caem aqui automaticamente. Quando você solta um arquivo num chat, ele fica disponível para o agent sem nenhum passo de cópia.
outputs — arquivos que um agent produz durante uma execução aparecem aqui, agrupados por execução.
skills — conjuntos de skills curados e somente leitura, sincronizados a partir de repositórios versionados, expostos para os agents consultarem. Somente leitura: eles são atualizados a partir da fonte no GitHub, não editados aqui.

Por baixo dos panos são volumes separados (veja a tabela de mounts abaixo), mas você navega por eles como uma única árvore.

Navegação

Navegue pelos breadcrumbs — a trilha sempre começa na pasta da sua org e é o único lugar em que a pasta atual é nomeada. A localização atual é refletida na URL da página, então você pode mandar para um colega o link direto de uma pasta.

A busca acompanha você: na tela inicial ela busca todos os arquivos da org, e dentro de uma pasta ela busca só aquela pasta e tudo abaixo dela (o placeholder diz qual dos dois). Um feed de Recently added que cruza todos os volumes fica no final da tela inicial, para você voltar rapidamente a qualquer coisa que você (ou seus agents) tocou por último.

Você pode arrastar e soltar arquivos diretamente em qualquer pasta editável para fazer upload.

Brands

A Library tem suporte nativo para org brands — uma pasta de identidade estruturada que seus agents e a skill de slides usam para produzir outputs on-brand.

Uma brand fica em org/home/brands/<nome>/ e contém quatro arquivos:

Arquivo	Propósito
`tokens.css`	Variáveis CSS para cores, tipografia, espaçamento, raio e sombra
`brand.md`	Diretrizes escritas da marca: voz, tom e notas de identidade visual
`logo`	Arquivo de logo (SVG, PNG ou similar)
`slides-theme.html`	Um deck de exemplo que também serve como shell de geração para a skill de slides

Criando e editando uma brand

Brands aparecem como cards diretamente na Library. Clique em um card de brand para abrir o editor no painel lateral, que permite:

Editar paletas de cores (primária, secundária, neutros) com preview em bandas em tempo real
Ajustar tipografia, espaçamento, raio e sombra
Escrever ou refinar as diretrizes de voz e tom da marca
Visualizar a brand aplicada a um deck de exemplo e componentes de UI em tempo real

Para criar uma brand do zero, peça para qualquer agent: "Crie uma brand para [nome]" — agents com acesso à skill core/brand vão montar toda a estrutura de pastas e populá-la com valores iniciais sensatos.

O arquivo slides-theme.html dentro de uma pasta de brand funciona ao mesmo tempo como shell de geração e deck de exemplo editável. Modificá-lo diretamente muda o ponto de partida de todos os decks que a skill de slides gera com essa brand.

Arquivos e pastas no volume Home podem ser compartilhados fora da sua organização. Cada nó tem um modo de compartilhamento, definido pelo menu de contexto ou pelo ícone de compartilhamento no seu card:

Modo	Quem pode acessar
Org only	Apenas membros da organização (padrão)
Public	Qualquer pessoa com o link — sem necessidade de login
Password	Qualquer pessoa com o link que inserir a senha correta

Um badge no card reflete o modo de compartilhamento atual. Para nós protegidos por senha, o link compartilhado abre um formulário de senha antes de servir o conteúdo; um desbloqueio bem-sucedido cobre o nó e toda a sua subárvore (para pastas) durante a sessão do navegador.

Uma senha é definida no nível da pasta e cobre tudo dentro dela. Arquivos dentro de uma pasta protegida por senha herdam a senha da pasta pai — não é possível sobrescrever com uma senha diferente em um nó filho.

Arquivos que herdam o compartilhamento de um pai mostram um indicador somente leitura "shared via a parent folder" em vez dos controles de compartilhamento. Altere o modo de compartilhamento do pai para afetá-los.

Como ela mapeia para o sandbox

A Library e o sandbox do agent são duas visões do mesmo filesystem. A Library nomeia sua pasta home com o nome da sua org e aninha as pastas de sistema dentro dela, mas os caminhos que os agents usam nunca mudam — eles são montados em org/:

Pasta na Library	Caminho no sandbox
`<sua-org>` (home)	`org/home/`
`<sua-org>/uploads`	`org/upload`
`<sua-org>/outputs`	`org/output`
`<sua-org>/skills/<set>`	`org/public/<set>`

Arquivos escritos na sua pasta home e em outputs sincronizam com o cloud storage da sua organização e ficam visíveis para todos os membros e agents. Mudanças externas aparecem dentro de um sandbox em execução em cerca de um segundo.

Para entender como os agents usam essas pastas em runtime — registrando conhecimento durável, lendo anexos de chat, escrevendo o output de uma execução — veja Decopilot → Visão geral.