qa-test-architect
Skill6 starsChanged 33 days agoMITView on GitHub
Risk-first test planning and authoring for any codebase. Runs a 3-step pipeline — risk assessment, test-case design (happy / boundary / negative / independence), then implementation in the project's own stack with a verified run. Use when the user asks to "generate tests", "write a test", "what should I test", "review code for testability", or wants a risk-based test strategy. A project may ship its own override of this skill with stack-specific detail.
In this repository79 other files it gives its agents.
- adr-phase-coverageSkill
- aposd-red-flag-reviewSkill
- apple-on-device-aiSkill
- artifact-gatesSkill
- asc-app-create-uiSkill
- asc-build-lifecycleSkill
- asc-cli-usageSkill
- asc-crash-triageSkill
- asc-id-resolverSkill
- asc-localize-metadataSkill
- asc-metadata-syncSkill
- asc-notarizationSkill
- asc-ppp-pricingSkill
- asc-release-flowSkill
- asc-revenuecat-catalog-syncSkill
- asc-shots-pipelineSkill
- asc-signing-setupSkill
- asc-submission-healthSkill
- asc-subscription-localizationSkill
- asc-testflight-orchestrationSkill
- asc-wall-submitSkill
- asc-workflowSkill
- asc-xcode-buildSkill
- choose-boring-technologySkill
- ci-preflightSkill
- conways-lawSkill
- cost-routingSkill
- cost-tier-routingSkill
- cunninghams-lawSkill
- ddd-strategic-auditSkill
- ddd-tactical-reviewSkill
- debug-test-captureSkill
- developing-ios-appsSkill
- doerrs-lawSkill
- fitts-lawSkill
- fix-regression-guardSkill
- galls-lawSkill
- goodharts-lawSkill
- greenspuns-tenth-ruleSkill
- gsd-core-hooksSkill
- hofstadters-lawSkill
- hyrums-lawSkill
- ios-accessibilitySkill
- ios-simulator-boot-healthSkill
- kerckhoffs-principleSkill
- kernighans-lawSkill
- knuths-optimization-principleSkill
- lady-lovelaces-objectionSkill
- leaky-abstractionsSkill
- linuss-lawSkill
- mobile-ios-designSkill
- money-boundary-judgmentSkill
- moores-lawSkill
- no-deferSkill
- norvigs-lawSkill
- parkinsons-lawSkill
- peter-principleSkill
- postels-lawSkill
- post-fix-traceSkill
- rubber-duckSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 33
Use the project's existing framework and conventions — match the surrounding tests.
- Distinctive: line 45
Read the actual result — require executed-count > 0 and failures = 0, and check the count matches what you intended to run.
- Distinctive: line 47
Filters/selectors silently match zero tests: when the path, name, or pattern is wrong — confirm your selection actually ran the target.
- Distinctive: line 55
Before writing, detect the project's test framework, fixture/mock helpers, and run command (read existing tests and CI config).
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
QA Test Architect
Build tests that prevent defects, target high-risk areas, and balance automation cost against payoff.
Never skip the pipeline. On any "generate tests / write a test / review for testability" request, run Steps 1→4 before writing code.
Step 1 — Risk & strategy assessment
Output a short summary first:
- 80/20 risk zone — the ~20% of the code handling the most critical data or highest-traffic logic (money, auth, state mutations, persistence, concurrency, external I/O). Concentrate effort there.
- Automation suitability — unit (pure logic, small surface), integration (modules plus real I/O seams), or manual/exploratory (UX edges, multi-system, hard to automate). Pick the cheapest level that proves the behavior.
Step 2 — Test-case design (enforce all four)
- Happy path — the ideal functional flow.
- Boundary value analysis — min, max, just-inside, just-outside; empty/zero, overflow, off-by-one, time/window edges.
- Negative path — bad input, thrown errors, timeouts, dependency/network failure, malformed or absent data.
- Independence — no shared global state, no execution-order dependence; each test sets up and tears down its own world.
Step 3 — Implement & document
- Use the project's existing framework and conventions — match the surrounding tests; don't introduce a new runner.
- Descriptive names stating what is tested + expected outcome
(e.g.
rejectsTransferWhenBalanceBelowAmount). - Isolated fixtures, not a persistent/shared database — in-memory or per-test data. Isolate only the I/O seams (network, clock, filesystem, external services); exercise the real unit under test rather than stubbing its own logic.
- Tests are authoritative — when a test fails, fix the code, never weaken the test.
Step 4 — Verify the run (do not trust a green checkmark)
A passing-looking run is not proof. Always confirm:
- A runner can exit 0 even when tests fail, or when a bad filter selected nothing. Read the actual result — require executed-count > 0 and failures = 0, and check the count matches what you intended to run.
- Filters/selectors silently match zero tests when the path, name, or pattern is wrong — confirm your selection actually ran the target.
- Red before green — for a new behavior or regression, see the test fail before the fix and pass after.
- IDE/editor diagnostics after edits can be stale index, not ground truth — confirm with a real build/compile and the actual test run.
Adapt to the stack
Before writing, detect the project's test framework, fixture/mock helpers, and run command (read existing tests and CI config). If the project ships its own QA skill, its stack-specific guidance takes precedence over this generic version.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

