Memory Bank

Manage development logs in

.ai_memory/

with chronological date ordering.

Date Ordering Rule

All entries use YYYY-MM-DD format. Newer entries appear FIRST (top of section).

This ensures recent context takes precedence when reading logs.

Operations

1. Create New Log

When starting a new feature/task:

# Get current branch
BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
DATE=$(date +%Y-%m-%d)

1. Check if log exists:

   ls .ai_memory/

2. Copy template:

   .ai_memory/TEMPLATE.md

   →

   .ai_memory/<branch-name>.md

3. Fill Context section with current date and branch
4. Complete Problem Statement

2. Update Existing Log

When adding progress to an existing log:

1. Read current log
2. Identify section to update (Research, Proposed Solution, Status)
3. Add content while preserving structure

3. Add Implementation Entry

Add dated entries to the Implementation Log section. Always prepend (newest first):

## Implementation Log

### 2025-12-29    ← NEW (add here)
- [x] Completed task A
- [ ] Started task B

### 2025-12-28    ← OLDER (stays below)
- [x] Initial setup

Process:

1. Get today's date:

   date +%Y-%m-%d

2. Check if today's entry exists
3. If exists: Add items to existing date section
4. If not: Create new date header at TOP of Implementation Log

4. Show Status

Report current Memory Bank state:

Memory Bank Status
==================
File: .ai_memory/<name>.md
Last Updated: YYYY-MM-DD

Sections:
- [x] Context (complete)
- [x] Problem Statement (complete)
- [ ] Research (incomplete)
- [ ] Proposed Solution (incomplete)

Implementation Progress:
- 3 entries logged
- Latest: YYYY-MM-DD

Quick Reference

Action	Command Pattern
Create	Copy TEMPLATE.md, fill Context
Update	Read → Modify section → Write
Add Entry	Prepend dated entry to Implementation Log
Status	List sections, check completion

File Structure

.ai_memory/
├── README.md      # Documentation
├── TEMPLATE.md    # Copy for new logs
└── <branch>.md    # Active development logs

Completion Report

After any operation, report:

Memory Bank: <operation>
========================
File: .ai_memory/<name>.md
Date: YYYY-MM-DD

Changes:
- <what was added/modified>

Next Steps:
- <suggested actions>