mags-marketplace

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
• i18n / Locale — template fallback chain (locale → en → root) for multi-language doc templates
• Custom Template Packs — add your own template packs with pack.yaml manifests
• Stack-Aware CLAUDE.md — generates project rules that reflect your actual tech stack
• Extended Skills — testing strategy, security review, infrastructure, and API lifecycle guidance

Quick Start

# Add the marketplace source
claude plugin marketplace add https://github.com/doancan/mags

# Install the plugin
claude plugin install mags@mags-marketplace

Restart Claude Code, then inside any project:

/mags-init

That's it. MAGS will scan your docs/ directory (or help you create one from templates) and start tracking your project.

What You Get

Slash Commands

Command	What it does
/mags-init	Set up MAGS for your project — scan docs or scaffold from templates
/mags-status	Dashboard — doc health score, next steps
/mags-docs	List all project documents
/mags-docs-create <template>	Create a new document from template
/mags-docs-validate	Run document validation checks
/mags-docs-search <query>	Search across all documents
/mags-changelog	Generate a changelog from git history
/mags-setup	Analyze your project and recommend Claude Code configuration
/mags-legacy	Initialize MAGS for a legacy/brownfield project with stack detection and tech debt tracking
/mags-help	Quick reference of all commands, skills, agents, and hooks

Automatic Hooks

These run silently in the background — no action needed from you:

Event	What happens
SessionStart	Loads project summary and conventions

Skills (auto-activated)

Claude automatically uses these when relevant:

Skill	Activates when
doc-management	Creating or editing project documentation
memory-guidance	Storing decisions, conventions, or session context
claude-md-management	Working with CLAUDE.md project configuration
testing-strategy	Planning tests, test pyramid, coverage targets, mocking strategies
security-review	Security audits, OWASP Top 10, threat modeling, secure coding
infrastructure	DevOps, CI/CD pipelines, containerization, monitoring, deployment
api-lifecycle	API design, versioning, deprecation, rate limiting, OpenAPI/GraphQL

Agents

Agent	Purpose
doc-sync-validator	Checks if documentation matches the actual code
setup-recommender	Recommends plugins, skills, and hooks for your stack

How It Works

Session starts
  → Hook loads: project summary + conventions

You work normally
  → Claude uses MAGS tools as needed (memory, docs)
  → Decisions and context are stored via mags_remember

Next session starts
  → Project summary is restored automatically
  → Stored memories carry over across sessions

Memory

Store decisions, conventions, and notes as key-value pairs. MAGS searches them using TF-IDF scoring (offline) or OpenAI embeddings (optional).

"We're using JWT with refresh tokens for auth, remember this"
→ mags_remember is called automatically

Categories: decisions, conventions, notes, context, bugs

Documents

MAGS indexes your docs/ directory — parses YAML frontmatter, extracts section headings, and builds a fuzzy search index. Supports .md, .mdx, .rst, and .adoc.

MCP Tools (20 tools)