Knowledge
Display the current state of the project's knowledge base and recent learnings.
What This Does
Shows:
- Learning mode status (on/off)
- Knowledge base statistics (entry counts per category)
- Recent learnings extracted
Instructions
- Read
knowledge/state.jsonfor learning mode status - Read each knowledge file and count entries:
knowledge/learnings/patterns.mdknowledge/learnings/quirks.mdknowledge/learnings/decisions.md
- Extract recent entries (last 5) from learnings files
- Format and display
Output Format
+---------------------------------------------------+
| Project Knowledge Base |
+---------------------------------------------------+
Learning Status
---------------------------------------------------
Mode: ON (since 2026-01-08 14:00)
Last Extraction: 5 minutes ago
Extractions This Session: 3
** Remember to run /learn before ending your session **
Knowledge Statistics
---------------------------------------------------
Learnings:
- Patterns: 8 entries
- Quirks: 3 entries
- Decisions: 5 entries
- Total: 16 insights
Recent Learnings
---------------------------------------------------
[Pattern] "Use async/await for API calls in this codebase"
Discovered: 2026-01-08 | Confidence: high
[Quirk] "Auth module uses non-standard token format"
Discovered: 2026-01-07 | Confidence: high
[Decision] "Chose Redis over in-memory cache for session storage"
Made: 2026-01-06 | Confidence: high
Commands
---------------------------------------------------
/learn - Extract insights now
/learn-on - Enable learning mode reminder
/learn-off - Disable learning mode reminder
When Knowledge Base is Empty
+---------------------------------------------------+
| Project Knowledge Base |
+---------------------------------------------------+
Learning Status
---------------------------------------------------
Mode: OFF
No extractions yet
Knowledge Statistics
---------------------------------------------------
Knowledge base is empty.
Get Started
---------------------------------------------------
Use /learn to extract insights from your current session.
Use /learn-on to enable learning mode.
The knowledge base will grow as you work, capturing:
- Patterns that work well in this project
- Quirks and gotchas to remember
- Decisions and their rationale
Steps
- Read
knowledge/state.json - Read frontmatter from each knowledge file to get entry counts
- Parse recent entries from learnings files (look for
## Pattern:,## Quirk:,## Decision:headers) - Format and display the summary
- If files are missing or empty, show the "empty" state
Notes
- Entry counts come from frontmatter
entry_countfield or by counting##headers - Recent learnings are shown most recent first (by discovered/made date)
- This is a read-only command - it doesn't modify any files
- When learning mode is ON, show a reminder to run /learn before ending the session
