brain-updater
Update .brain/ context files after completing tasks. Use when: updating project context, documenting changes, maintaining activeContext.md, updating systemPatterns.md, tracking session progress, documenting decisions.
When & Why to Use This Skill
The Brain Updater is a specialized Claude skill designed to maintain project continuity and prevent 'context drift' by systematically updating documentation within the .brain/ directory. It ensures that AI agents and developers maintain a persistent, up-to-date understanding of project states, architectural patterns, and decision histories, significantly improving workflow efficiency in long-term development cycles.
Use Cases
- Post-Task Context Sync: Automatically updating activeContext.md after completing a feature to document modified files and current project status.
- Architectural Pattern Logging: Capturing newly discovered reusable code patterns in systemPatterns.md to ensure consistency across the codebase.
- Session Progress Tracking: Maintaining a clear record of completed and pending tasks to facilitate seamless handoffs between different work sessions.
- Technical Decision Auditing: Documenting the rationale and impact of critical design decisions to serve as a permanent 'source of truth' for the project team.
| name | brain-updater |
|---|---|
| description | Update .brain/ context files after completing tasks. Use when: updating project context, documenting changes, maintaining activeContext.md, updating systemPatterns.md, tracking session progress, documenting decisions. |
Brain Updater
Update .brain/ files to maintain session context.
When to Update
| File | When |
|---|---|
activeContext.md |
After major tasks |
systemPatterns.md |
New patterns discovered |
projectRules.md |
Rarely (source of truth) |
plans/{feature}.md |
During planning |
activeContext.md Template
## Recent Changes
- [Brief description]
**Files Modified**:
- `path/to/file.py` - What changed
## Active Tasks
- [x] Completed task
- [ ] Pending task
## Decisions Made
| Decision | Rationale | Impact |
|----------|-----------|--------|
| Text | Why | What it affects |
systemPatterns.md Template
Only add when discovering new reusable patterns:
## N. Pattern Name
### When to Use
- Situation description
### Implementation
```python
# Example code
Examples in Codebase
path/to/file.py:123- Usage
## Example Update
```markdown
## Recent Changes
- Implemented HTTPRequestNode for browser automation
- Added async HTTP client with connection pooling
**Files Modified**:
- `src/casare_rpa/nodes/browser/http_node.py` - New node
- `tests/nodes/browser/test_http_node.py` - Tests
## Active Tasks
- [x] Implement HTTPRequestNode
- [x] Create test suite
- [ ] Document API