{"id":31328074,"url":"https://github.com/russbeye/claude-memory-bank","last_synced_at":"2026-05-15T13:31:17.288Z","repository":{"id":315083065,"uuid":"1052296317","full_name":"russbeye/claude-memory-bank","owner":"russbeye","description":"Give Claude Code a brain upgrade. Automatically tracks your work and keeps everything organized, turning Claude into your smart token-tuned coding partner.","archived":false,"fork":false,"pushed_at":"2025-09-24T12:38:24.000Z","size":106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-25T23:55:22.511Z","etag":null,"topics":["agents","ai","claude","claude-code"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/russbeye.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-07T19:55:31.000Z","updated_at":"2025-09-24T12:38:27.000Z","dependencies_parsed_at":"2025-09-25T23:51:20.166Z","dependency_job_id":null,"html_url":"https://github.com/russbeye/claude-memory-bank","commit_stats":null,"previous_names":["russbeye/claude-memory-bank"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/russbeye/claude-memory-bank","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/russbeye%2Fclaude-memory-bank","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/russbeye%2Fclaude-memory-bank/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/russbeye%2Fclaude-memory-bank/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/russbeye%2Fclaude-memory-bank/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/russbeye","download_url":"https://codeload.github.com/russbeye/claude-memory-bank/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/russbeye%2Fclaude-memory-bank/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33068332,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","claude","claude-code"],"created_at":"2025-09-25T23:51:09.595Z","updated_at":"2026-05-15T13:31:17.169Z","avatar_url":"https://github.com/russbeye.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Memory Bank Extension\n\nA structured context management system for Claude Code that provides intelligent memory banking, specialized agents, and development workflows to enhance your coding sessions with persistent, queryable project knowledge.\n\n## What This Provides\n\n**Intelligent Context Management**: Instead of losing project context between Claude sessions, this system maintains structured memory banks of decisions, patterns, architecture, and troubleshooting knowledge that persist and evolve with your codebase.\n\n**Specialized Agents**: Purpose-built AI agents for specific tasks like code searching, memory synchronization, UX design, and context analysis that work more efficiently than generic prompts.\n\n**Development Workflows**: Proven patterns for feature development, hotfixes, context cleanup, and project hygiene that scale with your team.\n\n## Quick Start\n\n1. **Clone this repository**:\n   ```bash\n   git clone git@github.com:russbeye/claude-memory-bank.git\n   cd claude-memory-bank\n   ```\n\n2. **Copy the system files to your Claude directory**:\n   ```bash\n   cp -r {agents,commands,workflows} ~/.claude/\n   cp CLAUDE.md ~/.claude/\n   # settings.json contains suggested permissions\n   ```\n\n3. **Sync your first memory bank**:\n   ```bash\n   /update-memory-bank\n   # Will be put into `project/.claude/memory-bank`\n   ```\n\n4. **Start with context discovery**:\n   ```bash\n   /context-query \"src/**\" --limit=10\n   ```\n\nThat's it. Claude now has persistent, queryable knowledge about your project.\n\n## Core Components\n\n### Memory Bank System\n- **`decisions/`** - ADRs and technical decisions\n- **`patterns/`** - Code patterns and conventions  \n- **`architecture/`** - System structure and components\n- **`troubleshooting/`** - Known issues and solutions\n\n### Specialized Agents\n- **`code-searcher`** - Deep codebase analysis and pattern detection\n- **`memory-bank-synchronizer`** - Keeps docs aligned with code reality\n- **`context-query-agent`** - Just-in-time context retrieval\n- **`ux-design-expert`** - UI/UX guidance and design systems\n\n### Context Commands\n- **`/context-query \"\u003cpattern\u003e\"`** - Get focused context for a feature/path\n- **`/update-memory-bank`** - Sync memory bank with current code\n- **`/context-diff --since=main`** - See what changed since last update\n- **`/cleanup-context`** - Archive current state for milestones\n\n## Common Usage Patterns\n\n### Daily Development\n```bash\n# Get context for the area you're working on\n/context-query \"src/auth/**\" --limit=15\n\n# After making changes, update the memory bank\n/update-memory-bank\n```\n\n### Feature Development\n```bash\n# Start: Get relevant context\n/context-query \"Feature: Checkout\" --include=decisions,patterns\n\n# During: Update memory as you learn\n/update-memory-bank --paths=\"src/checkout/**\"\n\n# End: Archive the completed work\n/cleanup-context\n```\n\n### Code Review Prep\n```bash\n# Generate context for reviewers\n/context-query \"src/payments/**\" --format=bundle --limit=20\n```\n\n## Repository Structure\n\n**Tracked in Git**:\n- `agents/` - AI agent definitions\n- `commands/context/` - Context management commands  \n- `workflows/memory-bank/` - Development workflow guides\n- `CLAUDE.md` - Global project instructions\n- `settings.json` - Claude Code configuration\n\n**Local Only** (gitignored):\n- `.claude/memory_bank/` - Your project's memory bank\n\n## Key Workflows\n\n### New Feature Development\n1. `/context-query \"Feature: YourFeature\"` - Get existing context\n2. Code your feature\n3. `/update-memory-bank` - Document new patterns/decisions\n4. `/cleanup-context` - Archive when complete\n\n### Bug Investigation  \n1. `/context-query \"troubleshooting\" --limit=10` - Check known issues\n2. Use `code-searcher` agent for deep analysis\n3. `/update-memory-bank` - Document the fix\n\n### Project Hygiene\n1. `/context-diff --since=origin/main` - See what's changed\n2. `/stale-check` - Find outdated documentation\n3. `/update-memory-bank` - Sync everything\n\n## Configuration\n\nThe `settings.json` includes:\n- **Permissions**: Write/edit permissions with memory bank protections\n\n## Benefits\n\n- **Persistent Knowledge**: Context survives between sessions\n- **Focused Retrieval**: Get just the context you need, when you need it\n- **Living Documentation**: Docs that stay current with code changes\n- **Team Alignment**: Shared patterns and decisions accessible to all\n- **Efficient Workflows**: Proven processes for common development tasks\n\n## Pro Tips\n\n- Use specific path patterns in queries: `src/components/**` not just `components`\n- Update memory bank frequently during active development  \n- Archive completed features to maintain clean active context\n- Leverage specialized agents for complex tasks rather than generic prompts\n\nThis system transforms Claude from a stateless assistant into a persistent development partner that grows smarter about your project over time.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frussbeye%2Fclaude-memory-bank","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frussbeye%2Fclaude-memory-bank","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frussbeye%2Fclaude-memory-bank/lists"}