Multi-Agent Retrieval & Proposal Workflow

Bounded Retrieval Over Full-Repo Dumps

Instead of pasting 20,000+ tokens of Markdown into every CLAUDE.md or .cursorrules file, configure agents to retrieve bounded, line-cited excerpts on demand:

# Retrieve a 1,500-token cited excerpt for the task at hand
npx okfshare@latest context "$OKF_SHARE_ID" "What are our database migration and error envelope rules?" --max-tokens 1500

Installing Native Agent Skills

Run the skill installer once in any repository to wire up Claude Code, Cursor, Windsurf, OpenCode, Codex, Copilot, Gemini CLI, and Antigravity:

npx okfshare@latest skills install

Fixing Agent Mistakes Permanently

When an agent hits a project-specific gotcha during a session:

1. Update the relevant Markdown file in ./knowledge/ (or submit an agent proposal via npx okfshare@latest propose).
2. Validate locally with npx okfshare@latest validate ./knowledge.
3. Merge to main so CI publishes a new immutable revision via npx okfshare@latest update.