stripped down to skeleton

2026-09-11 09:40:02 +02:00
commit 638cbe6b39
30 changed files with 3384 additions and 0 deletions
@@ -0,0 +1,63 @@
+---
+id: knowledge-base/home
+title: Knowledge Base
+type: hub
+status: active
+tags: [knowledge-base, agents, docs, para]
+last_reviewed: 2026-09-11
+---
+
+# Knowledge Base
+
+A Markdown knowledge graph for engineering agents, organized with the
+[PARA method](https://fortelabs.com/blog/para/) — notes live by **actionability**,
+not by topic.
+
+This repository is the empty **framework**: tooling, agents, skills and the PARA
+skeleton, with no notes in it. Clone it, run the bootstrap below, and start
+writing notes.
+
+## Layout
+
+```
+01_projects/    active efforts with a goal and an end (features in flight)
+02_areas/       ongoing responsibilities & standards (policies, value streams, decisions)
+03_resources/   reference material (repo info, ingested externals)
+04_archives/    inactive items moved out of the three live categories
+index/          generated graph (index/graph.json)
+scripts/        graph generator, link inventory, MCP server, git hook
+agents/         subagent definitions, symlinked into .claude/agents/
+skills/         skill definitions, symlinked into .claude/skills/
+tests/          unit tests for the tooling
+```
+
+The PARA buckets start empty — add notes per the layout above, each in its own
+folder with an `index.md`.
+
+## Bootstrap
+
+```sh
+make install-hooks           # pre-commit hook: regenerate + validate the graph
+make install-global-claude   # link skills & agents into ~/.claude so any repo can use them
+make install-mcp-claude      # register scripts/mcp-server.py as the knowledge-database MCP server
+make graph                   # generate index/graph.json and validate it
+make test                    # run the tooling tests
+```
+
+## Generation
+- Run `make graph`
+- Output is written to `index/graph.json`
+
+## Rules
+- Markdown is the source of truth
+- `index/graph.json` is derived and generated
+- Keep notes linked using typed markdown links: `[text](note-id){"type":"…"}` (legacy `[[wiki links]]` are rejected by `make validate-graph`)
+- Organize by PARA actionability; move notes between buckets as that changes
+- Fix broken links — find them with `make graph` or `make validate-graph`
+
+## Hubs
+- [Projects Hub](project/index){"type":"related","link-info":"Lists the active projects"}
+- [Areas Hub](area/index){"type":"related","link-info":"Lists the ongoing areas of responsibility"}
+- [Resources Hub](resource/index){"type":"related","link-info":"Lists the cataloged reference notes"}
+- [Archives](archive/index){"type":"related","link-info":"Lists items moved out of the live buckets"}
+- [Agent Query Guide](meta/agent-query-guide){"type":"see-also","link-info":"Graph schema and jq queries for agents"}