qsd-map-codebase

Generate seven structured codebase documents under .planning/codebase/ using four parallel mapper agents.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/thecomputer07/qsd --skill qsd-map-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsd-map-codebase
Source: https://github.com/thecomputer07/qsd/tree/main/skills/qsd-map-codebase
Command: npx skills add https://github.com/thecomputer07/qsd --skill qsd-map-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebases can be large and opaque; this Skill automates creating a reproducible, structured map of an existing codebase by running parallel mapper agents that write documents directly to .planning/codebase/.

Core Features & Use Cases

  • Spawns four parallel qsd-codebase-mapper agents to generate seven structured documents (e.g., STACK.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, INTEGRATIONS.md, CONCERNS.md) under .planning/codebase/.
  • Supports brownfield onboarding, regular updates as code evolves, and onboarding to unfamiliar projects.
  • Outputs a commit-ready codebase map and provides a clear next-step path.

Quick Start

Run the map-codebase workflow to generate the seven codebase documents under .planning/codebase/.

Frequently Asked Questions about qsd-map-codebase

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

FAQPage Schema
How do I generate structured documentation for an unfamiliar codebase?

Mapping an unfamiliar codebase is done by running parallel mapper agents that analyze the repository and write seven structured documents, including STACK.md and ARCHITECTURE.md, directly to .planning/codebase/.

What is the best way to create a codebase map for brownfield onboarding?

Creating a codebase map for brownfield onboarding involves spawning four parallel mapper agents that generate seven structured documents covering architecture, conventions, and testing, resulting in a commit-ready map under .planning/codebase/.

Can I use parallel agents to document my existing project structure automatically?

Yes, you can use parallel agents to document an existing project structure automatically. The mapping pipeline enforces a four-agent parallel process that writes seven structured documents and verifies their presence before completing a commit-ready map.

What documents are generated when mapping a codebase?

Mapping a codebase generates seven structured documents: STACK.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, INTEGRATIONS.md, and CONCERNS.md, all written directly to the .planning/codebase/ directory.

How do I audit and update codebase documentation after significant changes?

Auditing and updating codebase documentation after significant changes is handled by rerunning the map-codebase workflow, which overwrites the seven existing structured documents in .planning/codebase/ with fresh analysis from the parallel mapper agents.