project-knowledgelisted

Build and maintain a durable, project-local knowledge base with provenance-tracked sources, injection-linted pages, and a generated index, using the bundled deterministic knowledge_tool.py CLI. Use when the user says "build a project knowledge base", "set up a knowledge layer", "register this source", "draft a knowledge page", "lint the knowledge pages", "regenerate the knowledge index", "export a knowledge bundle", or "/agent-collab:project-knowledge." Also offer this proactively when agent memory limits truncate project context across sessions, or when the same sources keep being re-read and re-synthesized because no durable, citable project-local record exists.
sumitake/agent-collab · ★ 0 · AI & Automation · score 61

Install: claude install-skill sumitake/agent-collab

# Project knowledge — durable, provenance-tracked project memory Maintain a `knowledge/` directory inside the user's project as a durable synthesis surface between immutable source material and agent answers. The layer reduces repeated re-reading and re-synthesis while preserving source provenance, trust boundaries, and review state. It is file-based, offline, and deterministic: no network, no daemon, no automatic context injection. ## The bundled CLI Resolve the **plugin root** from this loaded file: `SKILL.md` is at `<plugin-root>/skills/project-knowledge/SKILL.md`. The deterministic tool is `<plugin-root>/knowledge_tool.py` (stdlib-only, Python 3.10+): ```text python3 "<plugin-root>/knowledge_tool.py" init --root <project>/knowledge python3 "<plugin-root>/knowledge_tool.py" validate --root <project>/knowledge python3 "<plugin-root>/knowledge_tool.py" lint --root <project>/knowledge python3 "<plugin-root>/knowledge_tool.py" index --root <project>/knowledge python3 "<plugin-root>/knowledge_tool.py" draft --root <project>/knowledge --title T --source-id S python3 "<plugin-root>/knowledge_tool.py" export --root <project>/knowledge --page P.md --out /tmp/bundle.md ``` Every command re-reads state fresh and traverses in sorted order. `index` overwrites only `index.md` and appends one `log.md` row; `draft` and `export` create exactly one NEW file each (exclusive create, symlink-refusing); `validate` and `lint` are read-only. ## Layout - `knowledge/sou