archive

Visão geral da skill archive

O que a skill archive faz

A archive skill é um fluxo focado de Document Filing em um vault no estilo OrbitOS. A função dela é simples: localizar projetos concluídos e notas da inbox já processadas, confirmar o que pode ser movido com segurança e então arquivar esses itens em pastas datadas sem perder a rastreabilidade. Se você quer manter as pastas ativas mais limpas, mas ainda precisa de um histórico confiável, esta archive skill foi feita exatamente para esse trabalho de manutenção.

Quem deve instalar archive

Instale archive se o seu workspace usa notas em markdown estruturadas, frontmatter como status: done ou status: processed, e pastas previsíveis como 20_Project/, 00_Inbox/ e 99_System/Archives/. Ela é indicada para quem já segue uma convenção de organização e quer um arquivamento repetível — não para quem procura um assistente genérico de gestão do conhecimento.

Por que os usuários escolhem esta skill archive

O principal diferencial é que archive faz mais do que simplesmente “mover arquivos antigos”. Primeiro, ela identifica candidatos ao arquivamento, separa projetos de itens da inbox, pede confirmação de escopo e organiza os itens em caminhos de arquivo por ano ou por mês. Isso a torna mais confiável do que um prompt genérico, especialmente quando você quer que um agente preserve a estrutura e gere um resumo do que mudou.

Como usar a skill archive

Contexto de instalação e estrutura de vault esperada

Esta instalação de archive funciona melhor como uma skill de repositório ou de vault, não como um app independente. As evidências no repositório mostram que o fluxo espera:

• 20_Project/ para projetos
• 00_Inbox/ para itens da inbox
• 99_System/Archives/Projects/YYYY/
• 99_System/Archives/Inbox/YYYY/MM/

Antes de usar archive, confirme se o seu sistema de notas realmente segue esse layout ou adapte os caminhos no prompt. Leia SKILL.md primeiro, porque esse arquivo contém toda a lógica; não há scripts auxiliares nem arquivos de referência que expliquem comportamentos ocultos.

Que entrada a archive skill precisa para funcionar bem

A archive skill funciona melhor quando você fornece regras concretas em vez de algo como “limpe minhas notas”. Entradas fortes incluem:

• o caminho raiz do seu vault
• se o frontmatter usa status: done e status: processed
• se notas processadas da inbox também podem ser identificadas por links [[ProjectName]]
• se você quer arquivar todos os candidatos ou apenas um subconjunto
• se o agente deve apenas pré-visualizar as movimentações ou executá-las

Um prompt melhor seria:
“Use the archive skill on my vault. Scan 20_Project/ for notes with status: done and 00_Inbox/ for notes with status: processed or clear conversion links. Show candidates first, then archive only confirmed items into dated folders and provide a summary report.”

Fluxo prático de uso da archive skill

Um bom fluxo de archive usage é:

1. Pedir apenas a descoberta dos itens.
2. Revisar a lista de candidatos.
3. Aprovar todos, apenas projetos, apenas inbox ou itens selecionados.
4. Deixar o agente mover os arquivos para as pastas de arquivo.
5. Solicitar um relatório final com caminhos antigos, novos caminhos e quaisquer casos de exceção.

Esse padrão em duas etapas importa porque a skill foi desenhada em torno de confirmação antes de mover conteúdo. Isso reduz o risco de arquivar por engano notas que ainda estão ativas e torna o resultado mais fácil de auditar.

Caminho de leitura do repositório e dicas de qualidade

Para este guia da archive skill, o arquivo principal é EN/.agents/skills/archive/SKILL.md. Leia primeiro as seções “Identify Items to Archive” e “Archive Process”. Elas mostram as condições reais de disparo e a estrutura de destino.

Dicas de qualidade que melhoram os resultados:

• Normalize o frontmatter antes de rodar archive; campos de status inconsistentes enfraquecem a detecção.
• Se faltarem datas de conclusão, informe ao agente qual fonte de data usar para o arquivamento por ano.
• Peça “summary report + exceptions” para identificar links quebrados, datas ausentes ou casos mistos de pasta de projeto.
• Se o seu vault não seguir a nomenclatura do OrbitOS, especifique diretamente no prompt quais são os caminhos equivalentes.

FAQ da skill archive

A archive skill é melhor do que um prompt normal de organização?

Sim, se as suas notas já seguem um sistema estável. Um prompt comum pode sugerir arquivamento, mas a archive skill entrega um fluxo de decisão específico: detectar candidatos, apresentar escolhas, mover por tipo de conteúdo e organizar o arquivo por data. Isso reduz a necessidade de adivinhação e facilita a manutenção recorrente.

archive é adequada para iniciantes?

archive é amigável para iniciantes apenas se o seu vault já for estruturado. Se as notas não têm marcação, os status são inconsistentes ou as pastas foram criadas de forma ad hoc, essa skill será menos útil até que você padronize as entradas. Ela não é uma ferramenta mágica de limpeza para coleções desorganizadas de notas.

Quando você não deve usar archive?

Não use archive for Document Filing quando os itens ainda estiverem ativos, quando o status de conclusão for ambíguo ou quando você precisar de migração entre vaults em vez de um arquivamento simples. Ela também é uma escolha fraca se o seu sistema não usa arquivos markdown e estados baseados em frontmatter.

Quais são os principais limites deste guia de archive?

As evidências do repositório mostram um único arquivo central e nenhum script de automação, então o valor da skill está no prompting e na disciplina do fluxo de trabalho, não em tooling executável. Espere uma lógica de arquivamento clara, não validação profunda, reparo automático de links ou código de migração personalizado — a menos que você adicione isso ao seu próprio fluxo com agentes.

Como melhorar a skill archive

Dê à archive sinais de decisão mais claros

A forma mais rápida de melhorar os resultados da archive skill é tornar os metadados de origem mais consistentes. Use valores de status padronizados, inclua datas de conclusão e deixe explícitos os links de projeto nas notas da inbox. A archive skill depende desses sinais para distinguir candidatos seguros ao arquivamento de materiais que ainda estão ativos.

Evite modos de falha comuns da archive skill

Os problemas mais comuns são falsos positivos, datas ausentes e ambiguidade de destino entre pastas de projeto e arquivos individuais. Para reduzir erros, peça ao agente que:

• faça uma prévia dos candidatos antes de mover qualquer coisa
• sinalize notas com metadados incompletos
• separe “ready to archive” de “needs review”
• relate qualquer conflito de caminho antes da execução

Escreva prompts melhores para uso da archive skill

Um pedido fraco é “archive my vault.” Um mais forte seria:
“Run the archive skill in preview mode. Detect completed projects in 20_Project/ and processed inbox notes in 00_Inbox/. Use frontmatter first, then project links as a secondary signal. Show proposed destination paths under 99_System/Archives/, highlight uncertain items, and wait for approval before moving files.”

Esse prompt melhora a saída porque define escopo, ordem de detecção, modo de execução e expectativas de relatório.

Itere após a primeira passagem da archive skill

Depois da primeira execução, revise o que a skill deixou passar ou classificou incorretamente. Em seguida, ajuste o prompt ou as regras do vault: adicione campos de status que faltam, defina como lidar com notas sem data e esclareça se notas da inbox convertidas devem sempre ser arquivadas. A archive install fica mais valiosa com o tempo à medida que suas regras de organização se tornam explícitas e repetíveis.