Mags Legacy

---
name: mags-legacy
description: Initialize MAGS for an existing (brownfield/legacy) project
version: 1.0.0
user-invocable: true
allowed-tools:
  - mcp__mags_mags__mags_list_docs
  - mcp__mags_mags__mags_create_doc
  - mcp__mags_mags__mags_detect_stack
  - mcp__mags_mags__mags_discover_modules
  - mcp__mags_mags__mags_remember
  - mcp__mags_mags__mags_generate_claude_md
  - Bash
  - Read
  - Glob
  - Write
---

# MAGS Legacy Init

Initialize MAGS for an existing (brownfield/legacy) project that already has code but lacks documentation.

## Steps

### 1. Scan existing codebase

Use `mags_detect_stack` to detect the project's tech stack automatically.
Use `mags_discover_modules` to find existing modules in the code.

Report findings:
```
Detected Stack:
  Languages:    <detected>
  Frameworks:   <detected>
  Databases:    <detected>
  API Style:    <detected>

Discovered Modules:
  - <module> (confidence: <score>%)
  - ...
```

### 2. Gather legacy context from user

Ask the user these questions (all at once):
1. What is the migration goal? (modernize, rewrite, extend, maintain)
2. What are the main pain points in the current codebase?
3. Are there parts of the system that must be preserved as-is?
4. What is the target architecture? (keep current, monolith, microservices, serverless)

### 3. Create legacy documentation

Using `mags_create_doc`, create these documents from the legacy templates:
- `current-architecture` — Document the current architecture based on scan results
- `migration-plan` — Create a migration plan based on user goals
- `tech-debt` — Start a tech debt registry
- `target-architecture` — Document the target architecture

Also create standard docs:
- `tech-stack` — Based on detected stack
- `project-structure` — Based on discovered modules

### 4. Show summary

```
MAGS Legacy Init Complete

  Stack:         <detected stack summary>
  Modules:       <N> modules discovered

  Documents Created:
    - current-architecture.md
    - migration-plan.md
    - tech-debt.md
    - target-architecture.md
    - tech-stack.md
    - project-structure.md

Run /mags-status to see your project dashboard.
```

---

**Related commands:**
| Command | Description |
|---------|-------------|
| `/mags-init` | Initialize MAGS for a new project |
| `/mags-status` | View project progress dashboard |
| `/mags-setup` | Get Claude Code configuration recommendations |