Ligeiro Mindware

Conhecimento que deixa de ser arquivo e passa a ser capacidade.

Biblioteca pessoal de mindware: skills, referências e ferramentas que transformam livros, documentações e frameworks em conhecimento estruturado, reutilizável e acionável por agentes de IA.

O projeto nasce integrado ao Codex, mas a ideia é maior do que uma ferramenta específica: criar uma camada pessoal de conhecimento que possa evoluir, ser combinada e aplicada em diferentes contextos.

O que é mindware?

Mindware é conhecimento empacotado para uso prático. Em vez de apenas armazenar notas, este repositório organiza conceitos, padrões, decisões e instruções em skills que um agente consegue consultar e aplicar.

Cada skill pode reunir:

• instruções operacionais em SKILL.md;
• resumos e cheatsheets;
• glossários;
• padrões e exemplos;
• capítulos ou referências complementares.

O contrato portátil de cada skill é o padrão SKILL.md, com name e description no frontmatter. O catálogo pode ser instalado diretamente em agentes compatíveis ou empacotado com APM.

Estrutura

ligeiro-mindware/
├── AGENTS.md
├── skills/
│   └── <skill-name>/
│       ├── SKILL.md
│       ├── cheatsheet.md
│       ├── glossary.md
│       ├── patterns.md
│       └── chapters/
├── evals/
├── docs/
└── tools/
    ├── book-to-skill/
    ├── docs-to-skill/
    └── skill-engineering/

Fluxo para novas skills

1. Coloque o livro ou documento localmente fora do Git — ou em sources/ apenas durante o processamento.
2. Use o conversor adequado em tools/.
3. Grave o resultado final em skills/<slug>/.
4. Revise e valide skills/<slug>/SKILL.md.
5. Crie ou atualize cenários em evals/ quando mudar ativação, fluxo ou saída.
6. Faça commit apenas dos artefatos derivados permitidos, nunca dos arquivos-fonte protegidos.

Validação estrutural:

python3 tools/skill-engineering/validate_skills.py

Instalação em agentes compatíveis

A fonte de autoria é skills/<slug>/. O formato SKILL.md segue o Agent Skills open standard, mas cada produto possui seu próprio diretório de descoberta.

Ambiente	Onde instalar
Devin Desktop/Local	.agents/skills/<slug>/ no projeto ou catálogo do usuário
Claude Code	.claude/skills/<slug>/ no projeto ou ~/.claude/skills/<slug>/ para uso pessoal
Claude.ai/Cowork	ZIP de uma skill individual, enviado em Customize > Skills > Create skill > Upload a skill
Codex legado	~/.codex/skills/<slug>/

Devin Desktop/Local

mkdir -p ~/.agents/skills
cp -R ./skills/<slug> ~/.agents/skills/<slug>

Claude Code

mkdir -p .claude/skills
cp -R ./skills/<slug> .claude/skills/<slug>

Para uma skill pessoal disponível em todos os projetos, use ~/.claude/skills/<slug>/. O Claude Code também permite invocação direta com /<skill-name>.

Claude.ai/Cowork

Comprima somente a pasta de uma skill, mantendo o diretório contendo o SKILL.md na raiz do ZIP. Depois faça o upload em Customize > Skills. Skills compartilhadas em Team/Enterprise dependem das políticas e permissões da organização.

Windows — PowerShell

Copy-Item -Recurse -Force .\skills\<slug> ".claude\skills\<slug>"

Empacotamento com APM

O apm.yml usa skills/ como fonte única de autoria; não existe uma cópia paralela em .apm/. O pacote expõe apenas skills e declara alvos para Claude Code, Codex e o diretório genérico .agents/skills usado por Devin Desktop/Local.

O APM compile é voltado para primitives de instrução e contexto. Como este pacote é composto por skills, o fluxo é:

apm run validate
apm run pack

Para visualizar a instalação por alvo, use o bundle gerado em um projeto de teste:

apm install ./dist/ligeiro-mindware-0.1.0.zip --dry-run --target claude
apm install ./dist/ligeiro-mindware-0.1.0.zip --dry-run --target codex
apm install ./dist/ligeiro-mindware-0.1.0.zip --dry-run --target agent-skills

Instalação real do bundle:

apm install ./dist/ligeiro-mindware-0.1.0.zip --target claude

Ou diretamente do repositório público:

apm install nandoligeiro/ligeiro-mindware --target claude
apm install nandoligeiro/ligeiro-mindware --target codex
apm install nandoligeiro/ligeiro-mindware --target agent-skills

Princípios

• Conhecimento acionável: menos arquivo morto, mais capacidade aplicável.
• Estrutura antes de volume: uma skill útil vale mais do que uma pasta cheia de notas.
• Portabilidade: o conteúdo não deve depender para sempre de um único agente ou plataforma.
• Avaliação: ativação correta, fluxo correto e saída verificável fazem parte da qualidade.
• Curadoria humana: automação acelera; julgamento continua sendo responsabilidade de quem usa.
• Respeito às fontes: síntese e transformação não significam redistribuição indevida.

Política para o repositório público

Este repositório contém material autoral, referências públicas e sínteses transformativas. As skills não substituem as fontes originais e não devem reproduzir trechos extensos de livros, cursos ou documentações protegidas.

Não versione PDFs, EPUBs, exports privados, credenciais, dados pessoais, documentos internos, snapshots integrais de documentação ou qualquer arquivo-fonte que não possa ser redistribuído legalmente. Consulte sempre a licença e os termos da fonte antes de reutilizar o conteúdo.

O arquivo LICENSE cobre apenas código, ferramentas e outros artefatos originais explicitamente produzidos neste projeto. Marcas, APIs, livros, documentações e demais conteúdos de terceiros permanecem sujeitos aos seus respectivos titulares e termos.

---

Ligeiro Mindware — conhecimento organizado para pensar melhor, decidir melhor e construir melhor.