project-context

Generate and refresh business context maps and a master test plan for QA projects.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/ahuaracab/test-genesis --skill project-context-ahuaracab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-context
Source: https://github.com/ahuaracab/test-genesis/tree/main/.agents/skills/project-context
Command: npx skills add https://github.com/ahuaracab/test-genesis --skill project-context-ahuaracab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? QA engineers onboarding to an unfamiliar repository lack a canonical, business-level understanding of the system under test, making test planning guesswork. This Skill generates and maintains four regenerative context artifacts — a business data map, feature map, API map, and master test plan — so testing strategy is grounded in verified evidence rather than assumptions. ## Core Features & Use Cases - Four routed modes: Generate a business-data-map (entities, flows, state machines), business-feature-map (feature catalog, CRUD matrix), business-api-map (auth tiers, critical journeys), or master-test-plan (risk-ranked test roadmap), each from its own reference workflow. - Safe refresh-all chain: Run all four modes sequentially in dependency order, with per-artifact validation gates and explicit approval before overwriting existing files. - Evidence-grounded output: Every artifact includes a mandatory Discovery Gaps section listing unverified facts instead of invented business claims. - Use Case: Point the Skill at a newly inherited backend repository and run the data mode to produce a business-data-map.md documenting entities, flows, and integrations, then run test-plan mode to derive a risk-ranked testing roadmap from it. ## Quick Start Ask the agent to generate the business data map for the current repository using the project-context skill in data mode.

Frequently Asked Questions about project-context

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

FAQPage Schema
How do I generate a business data map for an existing repository?

Invoke the project-context skill in data mode targeting your repository path. It reads the database schema, API routes, backend and frontend code, and existing docs, then writes .context/business/business-data-map.md with entities, flows, state machines, and integrations.

How do I create a master test plan from business context?

Run the skill in test-plan mode after generating the business data map, which is a hard requirement. It scores flows by business impact, breakage likelihood, and blast radius, then writes .context/master-test-plan.md with a ranked risk map and pre-release checklist.

What is the difference between the data, features, and api modes?

Data mode maps entities, flows, and state machines; features mode builds a feature catalog with CRUD matrix and endpoint inventory; api mode narrates the business-level API story including auth tiers and critical journeys. Each mode writes a separate artifact and loads only its own reference.

Does the skill overwrite existing context files automatically?

No. When an artifact already exists, the skill enters UPDATE mode: it generates a candidate version, shows a diff summary, and waits for explicit approval before overwriting. Missing artifacts are created directly after analysis completes.

What happens if the business data map is missing when running test-plan mode?

Test-plan mode stops with a hard dependency error and instructs you to run data mode first, since risk reasoning requires the data map. A missing feature map is only a soft dependency — the run continues and logs the limitation under Discovery Gaps.

When should I use refresh-all instead of a single mode?

Use refresh-all only when you explicitly want all four artifacts regenerated. It runs data, features, api, then test-plan sequentially, closing each mode's validation and approval gate before loading the next, and stops on any hard failure or rejected overwrite.