mags-legacy

Generate architecture and documentation scaffolds for legacy codebases.

3|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/doancan/mags --skill mags-legacy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mags-legacy
Source: https://github.com/doancan/mags/tree/main/skills/mags-legacy
Command: npx skills add https://github.com/doancan/mags --skill mags-legacy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize documentation and architecture scaffolds for legacy codebases, bridging the gap between existing code and maintainable project docs.

Core Features & Use Cases

  • Stack detection to reveal languages and frameworks present.
  • Migration planning to generate a step-by-step path from current to target architecture.
  • Documentation generation for current-architecture, migration-plan, tech-debt, and target-architecture.

Quick Start

Run mags-legacy to initialize documentation, stack detection, and migration planning for a legacy project.

Frequently Asked Questions about mags-legacy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate architecture documentation for a legacy codebase?

To generate architecture documentation for a legacy codebase, you can automate the onboarding process to create scaffolds for current-architecture, tech-debt, and target-architecture docs. This bridges the gap between existing code and maintainable project docs.

What is the best way to detect the technology stack of an undocumented project?

Stack detection for undocumented projects is automated by scanning the existing codebase to reveal languages and frameworks present. This identifies the current technology stack to guide subsequent migration planning and module discovery.

Can I automate migration planning for a brownfield project?

Yes, you can automate migration planning for a brownfield project by generating a step-by-step path from current to target architecture. This creates a structured migration-plan document to guide your transition.

How do I start documenting tech debt in an existing project with no docs?

To document tech debt in an existing project with no documentation, run an automated onboarding scaffold generator. It analyzes the codebase to produce a dedicated tech-debt document alongside current and target architecture docs.

Does legacy project onboarding work for codebases with multiple frameworks?

Legacy project onboarding works for codebases with multiple frameworks by utilizing stack detection to identify all languages and frameworks present. It then guides module discovery and generates documentation scaffolds across the diverse tech stack.

What types of documents are generated when bootstrapping a legacy project?

When bootstrapping a legacy project, the generated documents include current-architecture, target-architecture, migration-plan, and tech-debt scaffolds. These are created using the mags_create_doc process to ensure comprehensive coverage.