knowledge

Knowledge Base

Manage a structured knowledge base at context/knowledge/ for capturing durable facts, entities, and patterns across sessions.

Arguments

• $ARGUMENTS - Subcommand: init, add <topic>, update <topic>, or omit for status

Context

• Knowledge index: !cat context/knowledge/index.md 2>/dev/null | head -50
• Knowledge files: !find context/knowledge -maxdepth 1 -name "*.md" 2>/dev/null | head -20
• Project root: !git rev-parse --show-toplevel 2>/dev/null | head -1
• CLAUDE.md exists: !find . -maxdepth 1 \( -name CLAUDE.md -o -name AGENTS.md \) 2>/dev/null | head -2

Instructions

Subcommand: init

Create the knowledge base directory and seed it with an index file.

1. Create context/knowledge/ directory
2. Write context/knowledge/index.md with this template:

# Knowledge Index

Structured knowledge for future knowledge graph ingestion. Each file covers a topic/domain.

| File | Topic | Key Entities | Last Updated |
|------|-------|-------------|-------------|

## Coverage Map

Which context files are captured in knowledge:

| Context File | Knowledge File(s) | Coverage |
|-------------|-------------------|----------|

1. If the project has a .gitignore, verify context/knowledge/ is not ignored
2. Report the path created and suggest initial topics based on what is visible in the repo (CLAUDE.md, AGENTS.md, README, directory structure)

Subcommand: add

Create a new topic file and register it in the index.

1. Read the existing index to avoid duplicates
2. Ask what entities and facts to capture if not obvious from conversation context
3. Create context/knowledge/<topic>.md with a heading and structured content
4. Update context/knowledge/index.md — add a row to the index table with the file name, topic description, key entities, and today's date
5. Report what was added

Subcommand: update

Update an existing topic file with new knowledge.

1. Read context/knowledge/index.md to find the topic file
2. Read the topic file
3. Propose additions or corrections as diffs
4. Apply after user approval
5. Update the Last Updated date in context/knowledge/index.md