Project Knowledge Capture (PKC)
Continuous capture and materialization of meetings, experiments, discoveries, decisions, and WikiTicket work into a durable OKF knowledge graph.
Works on Claude Code, Grok Build, Codex, Agent Plugins 1.0, Grok Bot, and LangChain Deep Agents.
| Plugin name | project-knowledge-capture |
| Repo | SpillwaveSolutions/project-knowledge-capture |
| Version | 0.9.5 |
| License | MIT |
| Nouns this plugin owns | Meeting, Experiment, Discovery, Assumption, Question, Feature, Requirement, Specification, Design, Release, CodeChange, Package, Risk, Acceptance, DecisionRecord, TicketLink, Epic, Story, Task, Subtask, Bug, Branch, Project, Playbook, Runbook, Reference |
Multi-host
| Host | How it loads |
|---|---|
| Claude Code | Marketplace / local plugin (.claude-plugin) |
| Grok Build | Claude-compatible, zero-config (.grok-plugin pins identity) |
| Codex | .codex-plugin + existing hooks/hooks.json |
| Agent Plugins 1.0 | Root plugin.json |
| Grok Bot | Skills + docs/GROK_BOT.md (not a Claude-style install) |
| LangChain Deep Agents | skills= / SkillsMiddleware — docs/LANG_CHAIN_DEEP_AGENTS.md |
Write isolation (worktree + PR) is in docs/ISOLATION.md. Public examples use fictional lumenfield-detector and northstar-console only. Point SECOND_BRAIN_ROOT at a path the human already has. Never hard-code a private remote.
Why PKC
Software projects generate reasoning that disappears: meeting notes, spike results, discovery findings, and the why behind designs. PKC turns that into Git-native OKF concepts so agents and humans get institutional memory with impact analysis and progressive disclosure.
| System | Role | Repository |
|---|---|---|
| OKF Plugin | Graph format + impact / query / validate | okf-plugin |
| WikiTicket SDD | Event-sourced work + wiki publishing | wiki_ticket_sdd |
| PKC (this plugin) | Capture + materialization layer | this repo |
Nouns (this plugin)
PKC owns project memory and WikiTicket work types. Catalog and ContextPack live in okf-plugin.
Meeting, Experiment, Discovery, Assumption, Question, Feature, Requirement, Specification, Design, Release, CodeChange, Package, Risk, Acceptance, DecisionRecord, TicketLink, Epic, Story, Task, Subtask, Bug, Branch, Project, Playbook, Runbook, Reference.
| Group | Nouns |
|---|---|
| Capture | Meeting, Experiment, Discovery, Assumption, Question |
| Product | Feature, Requirement, Specification, Design, Release, Acceptance |
| Delivery | CodeChange, Package, Risk |
| Decisions / ops | DecisionRecord, Playbook, Runbook, Reference |
| Work (WikiTicket) | TicketLink, Epic, Story, Task, Subtask, Bug, Branch, Project |
Package is also a SAC runtime/build unit. PKC Package is project-memory (what shipped); SAC Package is the build artifact in the topology.
TicketLink emission:
bin/worklog fold | python3 scripts/pkc_ticket_link.py emit --bundle knowledge --open-only
Install
Claude Code
claude plugin marketplace add SpillwaveSolutions/project-knowledge-capture
claude plugin install project-knowledge-capture@pkc-plugin-marketplace
Grok Build
Grok Build discovers Claude-compatible plugins automatically — no separate Grok-only config required. Optional identity pin: .grok-plugin/marketplace.json.
Codex
Codex loads .codex-plugin/plugin.json and the same hooks/hooks.json (auto-context + post-edit curate).
Grok Bot / Deep Agents
Do not run /plugin marketplace add. Enable the skills in skills/ and follow:
- docs/ONBOARDING.md
- docs/GROK_BOT.md
- docs/LANG_CHAIN_DEEP_AGENTS.md
/pkc-sessionbefore writing a shared second brain
Recommended companions
claude plugin marketplace add SpillwaveSolutions/okf-plugin
claude plugin install okf-graph-eng@okf-plugin-marketplace
Quick start
/pkc-init— scaffoldknowledge//pkc-capture-meeting— paste notes → Meeting + DecisionRecords/pkc-retrieve— spawn knowledge-retriever for Feature/Decision context (card only)/pkc-materialize— sync WikiTicket fold into OKF- Run tests:
python3 tests/test_pkc.py
python3 scripts/pkc_validate.py --bundle sample-knowledge
python3 scripts/pkc_pack.py features/user-authentication.md --bundle sample-knowledge --hops 2
python3 scripts/pkc_action_items.py meetings/2026-08-03-auth-design.md --bundle sample-knowledge
Skills & commands
| Skill / command | Purpose |
|---|---|
pkc-init | Scaffold knowledge catalogs |
pkc-capture-meeting | Meeting → decisions (+ action items) |
pkc-capture-experiment | Spike / experiment write-up |
pkc-capture-discovery | Research / scan findings |
pkc-capture-decision | Lightweight ADR |
pkc-materialize | WikiTicket fold + docs → OKF |
pkc-promote | Informal → Feature / Requirement / ADR |
pkc-link | Typed edges |
pkc-context | Progressive disclosure pack (--tiny, mermaid) |
pkc-retrieve | Spawn knowledge-retriever; parent consumes a summary card only |
pkc-doctor | Bundle health: conflicts, thin features, stale |
pkc-capture-assumption | Working hypothesis (weaker than ADR) |
pkc-capture-question | Open question that may block a Feature |
pkc-capture-transcript | Fireflies/Otter/Granola/plain → Meeting |
pkc-capture-pr | GitHub PR → CodeChange |
pkc-import-adr | Import MADR/adr-tools ADRs |
pkc-federate | Multi-repo federation |
pkc-capture-thread | Slack/Discord paste capture |
pkc-release-notes | Release notes from graph edges |
pkc-digest | Weekly brief + verification queue |
pkc-search | Full-text search over concepts |
pkc-session | Open / close isolated write session (worktree + PR) |
Agent
- knowledge-capturer — capture, materialization, provenance
- knowledge-retriever — search, score, pack; returns a Retrieval card only
Hooks
Post-edit curation refreshes catalog indexes and runs a light validate when you edit knowledge Markdown.
Scripts
| Script | Role |
|---|---|
pkc_common.py | Frontmatter, catalogs, bundle init |
pkc_capture.py | Meeting / experiment / discovery / decision |
pkc_materialize.py | Worklog fold + docs |
pkc_link.py / pkc_promote.py | Edges + promotion |
pkc_pack.py | Context packs (2-hop default; --summary card) |
pkc_search.py | Full-text search (index → rg → scan) |
pkc_index.py | Disposable SQLite/FTS5 incremental index |
pkc_validate.py | Structure + links |
pkc_action_items.py | Meeting actions → TicketLink / worklog |
pkc_ticket_link.py | WikiTicket fold / GitHub Issues → TicketLink |
pkc-curate.sh | Post-edit hook helper |
pkc_auto_context.py | Prompt hook — injects a tiny pack when a Feature is named |
pkc_doctor.py | One-screen health check |
pkc_scrub.py | Secret/PII redaction |
pkc_transcript.py | Transcript normalizer |
pkc_pr_capture.py | PR → CodeChange |
brain_session.py | Isolation: worktree + branch + PR |
Sample knowledge
sample-knowledge/ — auth chain:
Discovery → Experiment → Meeting → Decision → Feature → Design → CodeChange → Release
Plus a Risk the decision mitigates and an Acceptance criterion the PR verifies.
Golden pack: sample-knowledge/packs/user-authentication-pack.md
Docs
- Noun-ownership migration — upgrade an existing PKC tree to 0.8.0
- Onboarding · Grok Bot · Deep Agents · Isolation
- PRD · Design · Integration
- Typed edges · Vision & brainstorm
- Roadmap — generated from
.work/bybin/worklog roadmap-render; edit work items, not the file
Config
License
MIT — see LICENSE.