Pack Format
Context packs are YAML files stored in the packs/ directory.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | Unique pack identifier |
label |
string | Yes | Human-readable name |
description |
string | No | What this pack provides |
query |
string | No | Selector expression defining pack membership dynamically |
includes |
string[] | No | Explicit list of document paths or contextnest:// URIs |
excludes |
string[] | No | Documents to exclude from query results |
agent_instructions |
string | No | Prose guidance for agents on how to use the pack contents |
version |
integer | No | Pack version number |
Static vs dynamic packs
Static packs use includes to list specific documents:
id: onboarding-basics
label: Onboarding Basics
includes:
- nodes/team-handbook
- nodes/onboarding-guide
- nodes/development-setup
Dynamic packs use query to define membership via a selector:
id: all-published-engineering
label: All Published Engineering Docs
query: "tag:#engineering & status:published"
excludes:
- nodes/internal-notes
Agent instructions
The agent_instructions field is free-form prose that tells the agent how to interpret and use the pack contents:
agent_instructions: >
These documents describe the onboarding process. When helping
a new team member, walk through them in order: handbook first,
then the onboarding guide, then dev setup. Flag any steps that
look outdated.
Related pages
- Cloud PacksCloud packs will be hosted on the PromptOwl platform and queryable without downloading source files.
- Context Packs OverviewContext packs are curated bundles of documents with agent instructions. They let you define named collections of context that agents can request by name.
- PromptOwl DocumentationWelcome to the documentation for PromptOwl and Context Nest — the open protocol and hosted platform for giving AI agents structured, versioned, governed…
- Add DocumentsThis creates nodes/api-design.md from a frontmatter template as version 1, and regenerates the index. Tags accept a comma- or space-separated list; you…
- Addressing OverviewContext Nest uses the contextnest:// URI scheme to address documents, sections, tags, and folders within a vault.