library

## O que é Este repositório é a biblioteca oficial de módulos para a CLI **start**. Ele coleta módulos CUE que descrevem agentes de IA, funções, contextos, tarefas e habilidades, e os publica no CUE Central Registry sob `github.com/p3bot/library` para que a CLI possa resolvê-los em tempo de execução. ## Estrutura O README documenta estes diretórios de nível superior: - `agents/` – modelos de comando para ferramentas de CLI de IA - `roles/` – definições de prompt de sistema e comportamento - `contexts/` – definições de contexto ambiental - `tasks/` – definições de instruções de tarefa - `skills/` – habilidades do agente, cada uma com um `SKILL.md` e recursos opcionais - `schemas/` – definições de esquema CUE - `index/` – índice de descoberta de módulos - `docs/` – catálogos de nomenclatura, publicação, autoria e padrões ## Como os módulos são usados Módulos podem ser importados diretamente no CUE, por exemplo: ```cue import "github.com/p3bot/library/roles/golang/assistant@v0" ``` Mais comumente, eles são consumidos indiretamente através da CLI start: ``` start --role golang/assistant start task review/pre-commit ``` ## Esquema de endereçamento Endereços totalmente qualificados voltados para o usuário assumem a forma `category:name`, como `agents:claude/interactive`, `roles:golang/assistant`, `contexts:cwd/agents-md`, `tasks:review/pre-commit` ou `skills:finding/one-by-one`. Nomes simples sem o prefixo `category:` funcionam como buscas entre categorias. O README observa que os caminhos de módulos em importações CUE permanecem baseados em barras — a forma com dois pontos aplica-se apenas à entrada e exibição para o usuário. ## Documentação referenciada A biblioteca direciona os leitores para `docs/naming.md` (convenções de nomenclatura), `docs/publishing.md` (publicação no CUE Central Registry), `docs/authoring.md` (criação ou atualização de um módulo), `docs/agent-patterns.md` e `docs/role-patterns.md` (padrões de autoria), além de uma referência de esquema em `schemas/README.md`. ## Licença MPL-2.0.