version: "1.0.1"
Skill: bushido-py-devkit overview
Quando usar
Use esta skill quando a IA precisar gerar código para projetos internos de IA, ML, LLM, agentes, MCP ou RAG.
Ordem de leitura recomendada
- README.md
- docs/architecture.md
- skill específica do módulo
- examples/
- contratos públicos no
__init__.py
Regras de uso
- Sempre prefira factories
create_*() antes de instanciar adapters diretamente. - Sempre configure por variáveis de ambiente primeiro.
- Não importe SDKs opcionais fora dos adapters.
- Não acople o código da aplicação ao SDK do provedor.
- Para troca de provedor, dependa das interfaces e não dos clients concretos.
Mapa rápido
- storage -> arquivos em clouds
- secrets -> segredos multi-cloud
- db -> SQL/Mongo
- llm -> chat/imagem/áudio
- guardrails -> proteção e validação
- agents -> agentes com ferramentas
- mcp -> servidor de ferramentas
- rag -> chunking, index e top-k