doancan/mags

3 stars · Last commit 2026-02-06

Claude Code plugin that preserves project context, documents, decisions, and progress across sessions.

README preview

# MAGS — Memory And Guidance System

A Claude Code plugin that keeps your project context alive across sessions.

MAGS indexes your documentation and remembers decisions — so every new conversation picks up exactly where the last one left off.

## Why MAGS?

Claude Code sessions are stateless. Every time you start a new conversation, you lose context: what was decided, what was built, what's next. MAGS solves this by giving Claude a persistent memory layer tied to your project.

- **No more repeating yourself** — decisions, conventions, and context carry over
- **No more stale docs** — validation catches drift between code and documentation
- **Zero config** — works offline with local TF-IDF, no API keys needed

## Key Features

- **Stack Detection** — automatically detects languages, frameworks, databases, API style, and package manager
- **Module Discovery** — scans your project structure to find modules with confidence scores
- **Architecture Support** — 6 architecture types (monolith, microservices, library, CLI, mobile, serverless) with tailored templates and guidance
- **Legacy/Brownfield Support** — `/mags-legacy` command for existing codebases: generates architecture docs, migration plans, and tech debt tracking

View full repository on GitHub →