qa-map

Map live workflows in web and Electron apps to .context/qa-map.json and .context/qa-map.md.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/0xHarbs/agent-setup --skill qa-map
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-map
Source: https://github.com/0xHarbs/agent-setup/tree/main/claude/skills/lifecycle/qa-map
Command: npx skills add https://github.com/0xHarbs/agent-setup --skill qa-map

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill analyzes a codebase to identify and map all live workflows (API routes, UI flows, background jobs, webhooks, IPC channels, cron jobs) into a structured QA map that informs testing and quality assurance.

Core Features & Use Cases

  • Systematically discovers and maps API routes, UI flows, background jobs, webhooks, and IPC channels into a centralized QA map.
  • Supports modern web apps and Electron apps (Next.js, Express, React, and Electron) for broad applicability.
  • Generates both a machine-readable map at .context/qa-map.json and a human-friendly diagram at .context/qa-map.md to aid reviews and planning.
  • Enables incremental updates with --incremental to re-run discovery only on changed files, preserving prior mappings and enabling fast feedback.

Quick Start

Run the qa-map workflow to generate a complete QA map for your codebase.

Frequently Asked Questions about qa-map

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

FAQPage Schema
How do I map codebase workflows for QA testing?

To map codebase workflows for QA testing, you scan the codebase to discover and trace live entry points across API, UI, queues, IPC, and webhooks. This generates a structured QA map detailing all active workflows for comprehensive testing.

What is a QA map in software engineering?

A QA map is a structured representation of all live workflows in a codebase, including API routes, UI flows, background jobs, webhooks, and IPC channels. It systematically identifies execution paths to inform testing and quality assurance.

Can I generate a QA map for an Electron app?

Yes, you can generate a QA map for an Electron app. The mapping process supports modern web apps and Electron apps, scanning stacks, entry points, and cross-references across UI, API, queues, IPC, and webhooks to identify live workflows.

How do I update a QA map after changing code?

To update a QA map after changing code, you run the mapping process with the incremental flag. This re-runs discovery only on changed files, preserving prior mappings and enabling fast feedback without rescanning the entire codebase.

What formats are generated when mapping codebase workflows?

Mapping codebase workflows generates a machine-readable JSON file at .context/qa-map.json and a human-friendly markdown diagram at .context/qa-map.md. These files document the discovered API routes, UI flows, and background jobs to aid reviews and planning.