Esta "semente" (seed) de cofre (vault) é uma base flexível para conhecimento local-first: arquivos puros, estrutura inicial, automações básicas, publicação Astro e um Lab Marimo opcional sem impor o uso final do vault.
Template original: https://github.com/aretw0/vault-seed
Use este repositório como template quando você quer começar um vault versionado sem montar toda a estrutura do zero. Ele pode virar site pessoal, blog simples, documentação coletiva ou cartão de visita. Os guias de orientação ficam em 99 - Meta e Anexos/ — seu conteúdo de conhecimento vai nas pastas PARA (40 - Recursos/, 20 - Projetos/, 30 - Áreas/ e afins).
Para utilizar este template e criar seu próprio cofre de conhecimento, você precisará ter:
- Git instalado no seu sistema (https://git-scm.com/downloads).
- Uma conta no GitHub (https://github.com/).
- Obsidian (https://obsidian.md/) ou Visual Studio Code (https://code.visualstudio.com/) instalados.
- Node.js instalado (https://nodejs.org/) e o CLI
dgkinstalado via npm (veja abaixo).
Este repositório é um template projetado para simplificar a criação do seu próprio cofre de conhecimento. Siga os passos abaixo para começar:
Clique no botão "Use this template" no topo da página do GitHub ou use este link: 
Após criar seu repositório, o GitHub Actions iniciará automaticamente um processo de inicialização. Este processo irá:
- Limpar o arquivo
CHANGELOG.md. - Resetar a versão inicial para
0.0.1. - Personalizar o
README.mde oCONTRIBUTING.mdpara o seu novo cofre. - Remover o próprio workflow de inicialização para garantir que ele rode apenas uma vez.
É crucial que você aguarde a conclusão deste processo. Você pode acompanhar o progresso na aba "Actions" do seu novo repositório no GitHub. O primeiro commit após a criação do repositório será o "commit de fundação" do seu cofre.
Após a inicialização automática ser concluída, clone o repositório que você acabou de criar para a sua máquina local:
git clone https://github.com/SEU-USUARIO/NOME-DO-SEU-REPOSITORIO.gitAgora seu cofre está pronto. Instale o CLI dgk, faça o bootstrap local e verifique a saúde do vault:
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/aretw0/vault-seed/main/install.sh | sh
# Windows PowerShell
irm https://raw.githubusercontent.com/aretw0/vault-seed/main/install.ps1 | iex
# ou diretamente
npm install -g @aretw0/dgk-clidgk setup # configura git, dependências e ferramentas Python
dgk check # verifica onboarding, auditoria IA e revisão de textoAbra a pasta no Obsidian ou Visual Studio Code.
Para começar, abra a nota Guia do Jardineiro Digital. Depois, siga Exploração Guiada do Vault para uma primeira visita de 30 minutos sem precisar entender Git, plugins ou automações de uma vez.
Se este for seu primeiro vault versionado, abra também Preparando seu Computador para o Vault para configurar Obsidian, VS Code, Git, GitHub Desktop e sincronização sem conflitos entre dispositivos.
Quando a recepção automática do template terminar, abra Depois da Recepção do Template para conferir o que ficou com você, o que não deve ser sincronizado manualmente e como operar o vault entre desktop e celular.
O vault inclui um prompt de projeto em AGENTS.md para orientar assistentes de
IA sobre a estrutura PARA, o fluxo com Git e as convenções de escrita. Arquivos
de compatibilidade apontam para essa mesma fonte: GEMINI.md é um link
simbólico para AGENTS.md, e CLAUDE.md importa AGENTS.md com a sintaxe
suportada pelo Claude Code.
No Obsidian, plugins de IA da comunidade podem usar esse prompt de duas formas:
aponte o plugin para AGENTS.md quando ele aceitar arquivo de contexto, ou cole
o conteúdo de AGENTS.md no campo de system prompt/instruções quando ele aceitar
apenas texto.
Para usuários do vault, o comando de verificação de saúde é:
dgk checkEsse comando roda auditoria IA, validação de onboarding e revisão de texto em português. É o ponto de entrada recomendado para confirmar que o vault está coerente.
Para contribuidores do template, o pipeline completo de qualidade é:
pnpm run validateEsse comando roda a régua canônica de qualidade: lint Markdown, auditoria de arquitetura de informação, auditoria da sidebar, testes dos scripts, validação do onboarding, revisão de acentos em português, contraste dos temas, Mermaid e smokes de template. Ele verifica se o vault continua publicável, navegável e coerente antes de ir para o CI ou para o deploy do site.
| Tarefa | Recurso |
|---|---|
| Setup local (fnm, uv, pnpm) | docs/compatibilidade-de-ambiente-e-setup.md |
| Devcontainer do template | .devcontainer/ |
| Guia de contribuição | CONTRIBUTING.md |
| Arquitetura e decisões | docs/INDEX.md |
| Release e publish dry-run | pnpm run release:package:smoke |
| Verificação de saúde (usuário) | dgk check |
Contribuidores trabalham no template original e usam pnpm run validate como pipeline de qualidade. Usuários que geraram um vault a partir dele usam dgk check para verificar a saúde do vault sem precisar seguir o fluxo interno de release do template.
A língua principal deste projeto (template) é o Português (Brasil). Contribuições que adicionem traduções da documentação ou melhorias ao template original são muito bem-vindas! Por favor, veja o nosso Guia de Contribuição para mais detalhes.
The main language of this project (template) is Portuguese (Brazil). Contributions that add documentation translations or improvements to the original template are very welcome! Please see our Contribution Guide for more details.