library

## What it is This repository is the official module library for the **start** CLI. It collects CUE modules that describe AI agents, roles, contexts, tasks and skills, and publishes them to the CUE Central Registry under `github.com/p3bot/library` so the CLI can resolve them at runtime. ## Structure The README documents these top-level directories: - `agents/` – command templates for AI CLI tools - `roles/` – system prompt and behaviour definitions - `contexts/` – environmental context definitions - `tasks/` – task instruction definitions - `skills/` – agent skills, each a `SKILL.md` with optional resources - `schemas/` – CUE schema definitions - `index/` – module discovery index - `docs/` – naming, publishing, authoring and pattern catalogs ## How modules are used Modules can be imported directly in CUE, for example: ```cue import "github.com/p3bot/library/roles/golang/assistant@v0" ``` More commonly they are consumed indirectly through the start CLI: ``` start --role golang/assistant start task review/pre-commit ``` ## Address scheme User-facing, fully qualified addresses take the form `category:name`, such as `agents:claude/interactive`, `roles:golang/assistant`, `contexts:cwd/agents-md`, `tasks:review/pre-commit` or `skills:finding/one-by-one`. Bare names without a `category:` prefix act as cross-category lookups. The README notes that module paths in CUE imports stay slash-based — the colon form applies only to user-facing input and display. ## Documentation referenced The library points readers to `docs/naming.md` (naming conventions), `docs/publishing.md` (publishing to the CUE Central Registry), `docs/authoring.md` (creating or updating a module), `docs/agent-patterns.md` and `docs/role-patterns.md` (authoring patterns), plus a schema reference in `schemas/README.md`. ## Licence MPL-2.0.