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.