qualia-map

Map existing codebases to infer architecture, stack, conventions, and concerns.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qualia-map
Source: https://github.com/Qualiasolutions/qualia-framework/tree/main/skills/qualia-map
Command: npx skills add https://github.com/Qualiasolutions/qualia-framework --skill qualia-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mapping an unfamiliar or brownfield codebase is time-consuming and error-prone; this skill automates discovery to infer architecture, technology stack, conventions, and notable concerns so teams can onboard, plan, and prioritize work confidently.

Core Features & Use Cases

  • Parallel dimension scanning: Runs four parallel analyzers to produce architecture.md, stack.md, conventions.md, and concerns.md for fast, focused insights.
  • Synthesis for planning: Generates a single-page .planning/codebase/README.md that summarizes validated capabilities and links to detailed dimension files for programmatic consumption.
  • Non-destructive auditing: Reads the repository only, documents issues and validated capabilities without modifying source code, and optionally commits the mapping artifacts.
  • Use Cases: Taking over a client repo, adding new features to unfamiliar code, and running before project initialization to seed validated requirements.

Quick Start

Run the qualia-map skill in the project directory to produce a .planning/codebase README and four dimension files describing architecture, stack, conventions, and concerns.

Frequently Asked Questions about qualia-map

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

FAQPage Schema
How do I map an unfamiliar codebase to understand its architecture and conventions?

To map an unfamiliar codebase, you can run an automated analyzer to infer architecture, technology stack, coding conventions, and notable concerns. This generates four structured markdown files and a synthesized README for onboarding.

What is the best way to analyze a brownfield repository before adding new features?

Analyzing a brownfield repository before feature planning is best done by scanning the existing codebase to document architecture and stack details. This produces mapping artifacts that help you prioritize work and seed validated requirements confidently.

Can I audit a client's source code without modifying their repository?

Yes, you can audit a client's source code without modifying it by using a non-destructive mapping tool. It reads the repository only, documents validated capabilities and issues, and optionally commits the generated mapping artifacts.

How do you document a tech stack and coding conventions for downstream automation?

Documenting a tech stack and coding conventions for downstream automation involves generating machine-readable mapping artifacts. Four parallel analyzers create structured files for architecture, stack, conventions, and concerns.

Does codebase mapping work for onboarding to existing projects?

Yes, codebase mapping works effectively for onboarding to existing projects by producing a single-page summary README. This synthesized file links to detailed dimension files, enabling new team members to quickly understand validated capabilities.

What files are generated when mapping a codebase's architecture and concerns?

Mapping a codebase's architecture and concerns generates four structured files: architecture.md, stack.md, conventions.md, and concerns.md. These are synthesized into a single .planning/codebase/README.md for programmatic consumption.