forge-map

Map existing codebases by parsing config files and identifying frameworks and databases.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/whatwecando/tombola --skill forge-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-map
Source: https://github.com/whatwecando/tombola/tree/main/.claude/skills/forge-map
Command: npx skills add https://github.com/whatwecando/tombola --skill forge-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Map an existing codebase to understand its structure before planning.

Core Features & Use Cases

  • Scan the project root for configuration files (package.json, tsconfig.json, etc.)
  • Analyze the directory structure to reveal modules, layers, and potential boundaries
  • Identify framework, language, database setup, test framework, and conventions
  • Generate a codebase map compatible with forge planning and BLUEPRINT enrichment
  • Use case: a brownfield project with a large monorepo can be mapped to guide migration strategy

Quick Start

Analyze the repository to generate a structured map of the codebase for planning.

Frequently Asked Questions about forge-map

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

FAQPage Schema
How do I map a legacy codebase structure for brownfield project planning?

To map a legacy codebase for brownfield project planning, scan the project root to parse common configuration files, analyze the directory structure, and identify frameworks to output a comprehensive structure overview.

Can I analyze a monorepo with a heterogeneous tech stack to identify frameworks and databases?

Yes, you can analyze a monorepo with a heterogeneous tech stack. The process scans configuration files to identify frameworks, languages, database setups, and test frameworks, producing a structured codebase map.

What configuration files do I need to map an existing codebase?

You need standard configuration files like package.json and tsconfig.json in the project root. The mapping process parses these files to detect frameworks, databases, and conventions, generating a structured overview.

How does codebase mapping support migration strategy for large projects?

Codebase mapping supports migration strategy by analyzing the directory structure to reveal modules, layers, and boundaries. This comprehensive overview guides informed planning for large monorepo migrations.

What is the best way to generate a structured overview of a legacy codebase?

The best way to generate a structured overview of a legacy codebase is to automate scanning of configuration files and directory structures, identifying frameworks and databases to produce a forge-compatible codebase map.