pan-knowledge · diff
git:20260714.4a4964b to git:20260721.84ab3d0
10 added, 0 removed. Audit A to A.
---
name: pan-knowledge
description: "pan knowledge <id> — spawn a knowledge agent to maintain the project's Open Knowledge Format (OKF) bundle"
triggers:
- pan knowledge
- knowledge agent
- okf agent
- run okf
- knowledge sync
- knowledge study
- knowledge retro
+ - knowledge open
allowed-tools:
- Bash
- Read
---
# pan knowledge
Run the command now:
```bash
pan knowledge <issue-id>
```
## Usage
```
pan knowledge PAN-123 # Sync project knowledge
pan knowledge PAN-123 --focus "auth flow" # Study a topic, then sync
pan knowledge PAN-123 --retro # Capture retro knowledge, then sync
pan knowledge PAN-123 --model claude-sonnet-5 # Override the knowledge role model
pan knowledge PAN-123 --effort high # Raise reasoning effort for the agent
+ pan knowledge open # Open this project's OKF bundle in the viewer
+ pan knowledge open --no-install --no-browser # Never install or launch a browser
```
## What It Does
`pan knowledge <id>` spawns a dedicated knowledge agent that maintains the
project's OKF bundle (`<project>-knowledge` by default). The agent reads
`roles/knowledge.md` for its contract and is allowed only to open PRs against
the knowledge repository — it never merges code, transitions the implementation
issue, or runs `pan done`.
The agent runs a sequence of `/okf` commands depending on the flags you pass:
- No flags: run `/okf sync`.
- `--focus "<topic>"`: run `/okf study "<topic>"`, then `/okf sync --topic "<topic>"`.
- `--retro`: run `/okf retro`, then `/okf sync`.
- Both flags: study, retro, then sync scoped to the topic.
The command first tries to ensure `mnemos` is available on `PATH` (installing it
on demand if necessary) and ingest the resolved bundle. If mnemos is unavailable,
it resolves the installed `okf` skill and falls back to its bundled `scripts/` directory.
+
+ `pan knowledge open` resolves the current project's bundle through
+ `projects.yaml` or `.okf.yml`, progressively installs the separately licensed
+ `@inkeep/open-knowledge` program when needed, starts or reuses a verified viewer
+ against a disposable snapshot, and opens the URL. Viewer edits never touch the
+ canonical PR-gated bundle. Use `--no-install` to require a preinstalled `ok` binary and
+ `--no-browser` to print the URL without launching a browser.
## When to Use
- After merging a feature to capture knowledge that would have helped the work
(`pan knowledge <id> --retro`).
- Before starting a focused feature to document current behavior
(`pan knowledge <id> --focus "<topic>"`).
- When code or docs change and the knowledge bundle needs a routine update
(`pan knowledge <id>`).
## Configuration
The knowledge agent resolves the OKF bundle in this order:
1. `projects.yaml` `knowledge_repo:` for the project.
2. `.okf.yml` `bundle:` in the code repository root.
If neither is configured, the command errors with instructions to run
`/okf init` first.
## See Also
- `/okf` skill — the standalone OKF command reference
- `roles/knowledge.md` — the knowledge agent's role contract
- `pan start <id>` — spawn an implementation agent for the same issue