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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

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.
namebrain-updater
descriptionUpdate .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