SpillwaveSolutions/project-knowledge-capture

Última actividad de origen registrada: 21 de octubre de 2026 a las 22:41

Catálogo de SkillsMP actualizado: 12 de noviembre de 2026 a las 12:52

skills recopiladas: 28

Estrellas en GitHub: 1
Forks en GitHub: 1

Instalar con un asistente de IA

Copia este prompt en el asistente de IA que estés usando.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/SpillwaveSolutions/project-knowledge-capture.

README del repositorio

Archivo de origen del README: README.md

Leer el README original

Mostrar README completo

# Project Knowledge Capture (PKC) **Continuous capture and materialization** of meetings, experiments, discoveries, decisions, and WikiTicket work into a durable [OKF](https://github.com/SpillwaveSolutions/okf-plugin) 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](https://github.com/SpillwaveSolutions/project-knowledge-capture) | | **Version** | 0.10.1 | | **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, Persona, UserJourney, JourneyStage, Scenario, UserStory | ## 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](docs/GROK_BOT.md) (not a Claude-style install) | | LangChain Deep Agents | `skills=` / SkillsMiddleware — [docs/LANG_CHAIN_DEEP_AGENTS.md](docs/LANG_CHAIN_DEEP_AGENTS.md) | Write isolation (worktree + PR) is in [docs/ISOLATION.md](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](https://github.com/SpillwaveSolutions/okf-plugin) | | **WikiTicket SDD** | Event-sourced work + wiki publishing | [wiki_ticket_sdd](https://github.com/SpillwaveSolutions/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](https://github.com/SpillwaveSolutions/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: ```bash bin/worklog fold | python3 scripts/pkc_ticket_link.py emit --bundle knowledge --open-only ``` ## Install ### Claude Code ```bash 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/ONBOARDING.md) - [docs/GROK_BOT.md](docs/GROK_BOT.md) - [docs/LANG_CHAIN_DEEP_AGENTS.md](docs/LANG_CHAIN_DEEP_AGENTS.md) - `/pkc-session` before writing a shared second brain ### Recommended companions ```bash claude plugin marketplace add SpillwaveSolutions/okf-plugin claude plugin install okf-graph-eng@okf-plugin-marketplace ``` ## Quick start 1. `/pkc-init` — scaffold `knowledge/` 2. `/pkc-capture-meeting` — paste notes → Meeting + DecisionRecords 3. `/pkc-retrieve` — spawn knowledge-retriever for Feature/Decision context (card only) 4. `/pkc-materialize` — sync WikiTicket fold into OKF 5. Run tests: `python3 tests/test_pkc.py` ```bash 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-prd` | PRD journey → persona, journey, stage, scenario, user story, epic | | `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 / PRD journey | | `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/`](./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`](./sample-knowledge/packs/user-authentication-pack.md) ## Docs - **[Noun-ownership migration](./docs/user_guide/noun-ownership-migration.md)** — upgrade an existing PKC tree to 0.8.0 - [Onboarding](./docs/ONBOARDING.md) · [Grok Bot](./docs/GROK_BOT.md) · [Deep Agents](./docs/LANG_CHAIN_DEEP_AGENTS.md) · [Isolation](./docs/ISOLATION.md) - [PRD](./docs/prd.md) · [Design](./docs/design.md) · [Integration](./docs/integration-okf-wikiticket.md) - [Typed edges](./docs/typed-edges.md) · [Vision & brainstorm](./docs/vision.md) - [Roadmap](./docs/roadmap.md) — generated from `.work/` by `bin/worklog roadmap-render`; edit work items, not the file ## Config See [`.pkc/config.example.yml`](./.pkc/config.example.yml). ## License MIT — see [LICENSE](./LICENSE).

Cargando el README del repositorio…

Skills en este repositorio

Desarrolladores de software Otras ocupaciones informáticas Empleados de oficina generales Administradores de redes y sistemas informáticos

6 categorías ocupacionales · 79% clasificado

skill

ocupación

descripción

actualizado

pkc-capture-prd

sin clasificar

Ingest a PRD journey section as Persona, UserJourney, JourneyStage, Scenario, and UserStory concepts, and link them to Features, Epics, and work Stories. Use when a PRD must drive story mapping.

Idioma del texto original: inglés

2026-10-21

pkc-setup

sin clasificar

Check PKC toolchain (python, ripgrep, SQLite FTS5) and optionally install ripgrep after the user consents. Use when search/pack is slow, rg is missing, or the user asks to set up PKC.

Idioma del texto original: inglés

2026-09-19

grok-bot-project-knowledge-capture

sin clasificar

Bind a Grok Bot agent to Project Knowledge Capture. Isolation, identity, deterministic capture.

Idioma del texto original: inglés

2026-09-12

pkc-context

sin clasificar

Build a progressive-disclosure context pack for a Feature (or any concept). Supports --tiny (1 hop / 8 nodes) for chat focus and mermaid graphs. Auto-run when starting work on a Feature.

Idioma del texto original: inglés

2026-09-12

pkc-retrieve

sin clasificar

Spawn the knowledge-retriever sub-agent to search and pack project memory without contaminating parent context. Use before answering from the OKF tree, or when starting work that needs Feature/Decision context.

Idioma del texto original: inglés

2026-09-12

pkc-search

sin clasificar

Full-text search over the knowledge bundle (AND terms, type filters). Use when finding decisions, meetings, or features by keyword.

Idioma del texto original: inglés

2026-09-12

pkc-doctor

Empleados de oficina generales

Run a one-screen health check on a PKC knowledge bundle — broken links, orphans, thin Features, decision conflicts, open Questions, stale Discoveries/Assumptions, toolchain (ripgrep). Use when auditing knowledge quality or before a release.

Idioma del texto original: inglés

2026-08-30

pkc-index

Administradores de redes y sistemas informáticos

Refresh, inspect, or drop the disposable SQLite/FTS5 knowledge index. Use when search/pack/validate is slow, after a large git checkout, or when the user asks about the PKC index.

Idioma del texto original: inglés

2026-08-30

pkc-init

Especialistas en gestión de proyectos

Scaffold a Project Knowledge Capture OKF bundle with all PKC catalogs (meetings, experiments, discoveries, decisions, features, …), root index.md, and log.md. Use when starting knowledge capture in a repo or creating knowledge/ / .okf for PKC.

Idioma del texto original: inglés

2026-08-30

cursor-project-knowledge-capture

Otras ocupaciones informáticas

Bind a Cursor agent (including Grok Bot cloud sessions) to the project-knowledge-capture ContentPack.

Idioma del texto original: inglés

2026-08-18

project-knowledge-capture-deep-agents

Desarrolladores de software

Bind Project Knowledge Capture for LangChain Deep Agents / Deep Agents Code.

Idioma del texto original: inglés

2026-08-16

pkc-session

Desarrolladores de software

Open or close an isolated second-brain write session (worktree + PR). Use before capturing or materializing when multiple agents share one knowledge remote.

Idioma del texto original: inglés

2026-08-16

pkc-capture-thread

Empleados de oficina generales

Capture Slack/Discord/chat thread paste as Meeting or Discovery. Scrubs secrets/PII. Use when user pastes a conversation.

Idioma del texto original: inglés

2026-08-04

pkc-digest

Empleados de oficina generales

Weekly/daily knowledge digest — recent captures, decisions, open questions, unvalidated assumptions, needs-verification queue, doctor highlights.

Idioma del texto original: Sin determinar

2026-08-04

pkc-federate

Desarrolladores de software

Multi-repo federated knowledge roots — list remotes, search across them, write shadow federation index. Remotes are read-only; link with maps_to.

Idioma del texto original: inglés

2026-08-04

pkc-import-adr

Desarrolladores de software

Import MADR or adr-tools Architecture Decision Record directories into OKF DecisionRecords.

Idioma del texto original: inglés

2026-08-04

pkc-release-notes

Desarrolladores de software

Generate release notes from Release concepts and Feature/CodeChange edges (released_in, lands_in, implements).

Idioma del texto original: inglés

2026-08-04

pkc-capture-assumption

Otras ocupaciones informáticas

Capture an Assumption (weaker than a Decision) linked to Features. Promote to DecisionRecord when validated. Use for working hypotheses and unproven beliefs.

Idioma del texto original: inglés

2026-08-04

pkc-capture-pr

Otras ocupaciones informáticas

Capture a GitHub PR as an OKF CodeChange concept via gh pr view (or JSON fixture). Use when documenting significant merges.

Idioma del texto original: inglés

2026-08-04

pkc-capture-question

Otras ocupaciones informáticas

Capture an open Question that may block a Feature until answered. Use for unresolved design questions and research gaps.

Idioma del texto original: inglés

2026-08-04

pkc-capture-transcript

Otras ocupaciones informáticas

Ingest Fireflies, Otter, Granola, or plain speaker-labeled transcripts into a Meeting concept. Always scrubs secrets/PII. Use when user pastes or provides a transcript export.

Idioma del texto original: inglés

2026-08-04

pkc-capture-decision

Desarrolladores de software

Capture a short decision statement as an OKF DecisionRecord (ADR-style) linked to Features, Designs, Requirements, Meetings, or Experiments. Use for ADRs, architecture choices, and lightweight decision logging.

Idioma del texto original: inglés

2026-08-04

pkc-capture-discovery

Analistas de investigación de mercados y especialistas en marketing

Capture research, competitive scans, user findings, and discovery notes as OKF Discovery concepts with source, confidence, and informs links. Use for research dumps, market scans, and exploratory findings.

Idioma del texto original: inglés

2026-08-04

pkc-capture-experiment

Desarrolladores de software

Capture experiment or spike results into an OKF Experiment concept with hypothesis, method, results, conclusion, and typed informs links. Use for spikes, A/B tests, POC write-ups, and engineering experiments.

Idioma del texto original: inglés

2026-08-04

pkc-capture-meeting

Empleados de oficina generales

Capture meeting notes into OKF Meeting concepts, extract DecisionRecords, and optionally create WikiTicket action items + TicketLinks. Use when the user pastes meeting notes, transcripts, or asks to record a meeting decision trail.

Idioma del texto original: inglés

2026-08-04

pkc-link

Desarrolladores de software

Add a typed edge between two OKF concepts (satisfies, implements, designed_by, decides, informs, originates_from, tracks, maps_to, etc.). Use when connecting meetings to decisions, features to requirements, or tickets to work concepts.

Idioma del texto original: inglés

2026-08-04

pkc-materialize

Desarrolladores de software

Materialize WikiTicket worklog fold and docs/ artifacts into OKF concepts (Features, TicketLinks, Designs, DecisionRecords, Releases, Specs). Use when syncing work items into the knowledge graph or after major planning/docs updates.

Idioma del texto original: inglés

2026-08-04

pkc-promote

Desarrolladores de software

Promote a Discovery, Experiment, or Meeting into a formal Requirement, Feature, Specification, Design, or DecisionRecord while preserving originates_from / informs provenance. Use when informal knowledge is ready to become durable product structure.

Idioma del texto original: inglés

2026-08-04

Mostrando 28 de 28 skills recopiladas.