| name | journal-manager |
| description | 2-tier knowledge journal — index + entries system for capturing lessons, bugs, and insights during development. |
Journal Manager
A lightweight knowledge journal that captures development insights, bug fixes, and lessons learned. Uses a 2-tier system: an index file for quick lookup and individual entry files for details.
Usage
Add a Journal Entry
python .agent/skills/journal-manager/scripts/journal.py add --title "Fixed N+1 query in orders API" --tags "performance,database" --body "Used DataLoader to batch queries. Reduced response time from 2s to 200ms."
List Recent Entries
python .agent/skills/journal-manager/scripts/journal.py list
Search Entries
python .agent/skills/journal-manager/scripts/journal.py search "database"
Show Entry Detail
python .agent/skills/journal-manager/scripts/journal.py show <entry-id>
File Structure
.agent/brain/journal/
├── index.json # Quick lookup: id, title, tags, date
└── entries/
├── 2024-01-15_fixed-n1-query.md
├── 2024-01-16_auth-flow-redesign.md
└── ...
Auto-Save Triggers
The journal can be triggered automatically by agents when:
- A bug fix takes ≥3 attempts
- A change touches ≥5 files
- A rollback is detected
- A non-obvious solution is found
