Testland
Browse all skills & agents

decision-table-test-design

Derives human-readable manual test cases from a business-rule spec via a decision table: identify conditions and actions, build the full 2^n-column matrix, collapse columns with irrelevant entries, strike infeasible combinations, then emit one test case per remaining column (each feasible column is one coverage item per ISTQB CTFL v4.0 section 4.2.3). A deep single-technique walkthrough rather than a broad multi-lens case matrix; the output is manual step/expected cases rather than parameterized test code, and it covers how cases are derived rather than how a case record is structured. Use when a spec's outcome depends on interacting conditions (pricing, eligibility, discounts, routing rules) rather than the boundaries of a single input.

Install with skills.sh (any agent)

npx skills add testland/qa --skill decision-table-test-design
View source

decision-table-test-design

Overview

Per ISTQB CTFL Syllabus v4.0.1 §4.2.3 (opens in new window), "decision tables are used for testing the implementation of requirements that specify how different combinations of conditions result in different outcomes" and are "an effective way of recording complex logic, such as business rules." This skill walks that derivation end to end: spec in, human-readable manual test cases out (step/expected tables, not code).

All syllabus claims below come from that v4.0.1 PDF (2024-09-15 revision); later references cite it as §4.2.3 without repeating the URL. One worked example (a shipping-fee rule) is carried through every step.

When to use (and when EP/BVA wins)

Use a decision table when the spec is business-rule logic with interacting conditions - the outcome depends on the combination of conditions, not on any single condition alone (pricing, discount stacking, eligibility, approval routing, feature gating). §4.2.3 names a second use: the technique "provides a systematic approach to identify all the combinations of conditions, some of which might otherwise be overlooked" and "helps to find any gaps or contradictions in the requirements", so a reviewer can also run it to check a spec for completeness.

Prefer equivalence partitioning / boundary value analysis instead when a single input's range drives the behavior (e.g. "age must be 18-120"): EP/BVA exercises the edges of one partition; a decision table exercises the cross-product of several conditions. The two compose - derive the rule columns here, then hand each numeric threshold (like the $50 below) to boundary-value-generator for edge values. For a broad first-pass matrix across many lenses rather than one technique in depth, use test-case-ideation-from-story.

Worked example spec (used in every step)

Shipping fee rules. Premium members always ship free (standard or express). Non-members: standard shipping is free for orders of $50 or more, otherwise $5.99; express shipping is a flat $14.99. Express is only offered at checkout for orders of $50 or more (courier minimum).

Step 1 - Identify conditions and actions

Per §4.2.3, "the conditions and the resulting actions of the system are defined. These form the rows of the table. Each column corresponds to a decision rule that defines a unique combination of conditions, along with the associated actions."

Extract from the spec:

IDConditions (Boolean)
C1Customer is a premium member
C2Order total is $50 or more
C3Express shipping selected
IDActions
A1Charge $0.00 (free shipping)
A2Charge $5.99 standard fee
A3Charge $14.99 express fee

Guidance: make each condition atomic (one yes/no question) and independently settable by a tester. "Member with a large order" is two conditions, not one. Every distinct outcome in the spec becomes an action row; if an outcome appears in the spec but in no action row, you mis-extracted.

Step 2 - Build the full table (2^n columns)

"A full decision table has enough columns to cover every combination of conditions" (§4.2.3). For n Boolean conditions that is 2^n columns; here 2^3 = 8.

Notation, per the same section: T means the condition is satisfied, F not satisfied, a dash (written - here) means the condition's value "is irrelevant for the action outcome", and N/A means the condition "is infeasible for a given rule". For actions, X means the action should occur and blank means it should not. The syllabus adds that "other notations may also be used."

Fill every column mechanically from the spec:

R1R2R3R4R5R6R7R8
C1 memberTTTTFFFF
C2 total >= $50TTFFTTFF
C3 expressTFTFTFTF
A1 freeXX?XX?
A2 $5.99X
A3 $14.99X?

R3 and R7 already smell: the spec says express is only offered at $50 or more, so "express selected on a sub-$50 order" may not be reachable. Mark them ? for now; Step 4 resolves it. Do not skip building the full table: the mechanical cross-product is what surfaces the overlooked combinations §4.2.3 warns about.

Step 3 - Collapse with irrelevant (dash) entries

The table "can also be minimized by merging columns, in which some conditions do not affect the outcome, into a single column" (§4.2.3). (Formal minimization algorithms are explicitly "out of scope of this syllabus"; pairwise inspection is enough at this scale.)

A merge is legal only if every expansion of the dash is feasible and produces identical actions.

  • R2 + R4 (member, standard): free either way; C2 does not affect the outcome. Merge into one column with C2 = -. Legal.
  • R1 + R3 (member, express) and R5 + R7 (non-member, express) look mergeable on the same logic, but R3 and R7 are the columns flagged ? in Step 2. Hold both merges until the feasibility check.

Step 4 - Spot infeasible combinations

"The table can be simplified by deleting columns containing infeasible combinations of conditions" (§4.2.3).

Re-read the spec for constraints that make condition combinations unreachable. Here: express is never offered below $50, so C3 = T with C2 = F cannot occur. R3 and R7 are infeasible; delete them. That kills the held merges from Step 3: C2 is not irrelevant in the express columns, because only one of its values is reachable there. A naive R1 + R3 merge would have produced a test case for an impossible state.

Final collapsed table (5 feasible columns):

P1P2P3P4P5
C1 memberTTFFF
C2 total >= $50T-TTF
C3 expressTFTFF
A1 freeXXX
A2 $5.99X
A3 $14.99X

The infeasible columns are not test-less: add one constraint check outside the table that verifies the infeasibility itself holds (the express option is absent from checkout below $50). If that check fails, the table must be rebuilt with R3/R7 feasible.

Step 5 - One test case per remaining column

Per §4.2.3, "the coverage items are the columns containing feasible combinations of conditions", 100% coverage means test cases "exercise all these columns", and "coverage is measured as the number of exercised columns, divided by the total number of feasible columns". Here: 5 feasible columns = 5 coverage items; the 5 cases below = 100% decision table coverage (5/5).

For a dash entry, pick one concrete value (P2 below uses $20; pairing with BVA would add $49.99/$50.00 around the threshold).

TC IDColumnSetupActionExpected result
TC-DT-1P1Member account; cart total $80.00Select express at checkoutShipping line shows $0.00; order total unchanged
TC-DT-2P2Member account; cart total $20.00Select standard at checkoutShipping line shows $0.00
TC-DT-3P3Non-member account; cart total $80.00Select express at checkoutShipping line shows $14.99
TC-DT-4P4Non-member account; cart total $80.00Select standard at checkoutShipping line shows $0.00
TC-DT-5P5Non-member account; cart total $20.00Select standard at checkoutShipping line shows $5.99
TC-DT-6(constraint)Non-member account; cart total $20.00Open shipping options at checkoutExpress option is not offered

Each row expands into a full runnable script (preconditions, per-step expected results, sign-off) via manual-test-script-author; this skill's output is the derivation plus the case table above.

Extended-entry tables and anti-patterns

The limited-entry vs extended-entry table forms (when to collapse correlated numeric conditions into one row) and the technique's anti-patterns table are in references/decision-table-details.md.

Limitations

  • Stateless rules only. Decision tables model input-combination logic. If the outcome depends on history (what happened before this event), use state-transition-test-design.
  • Combination coverage, not boundary coverage. A column says "total >= $50 is true"; it does not test $49.99 vs $50.00. Pair each threshold with boundary-value-generator.
  • Minimization is informal here. Formal minimization algorithms are out of CTFL scope per §4.2.3; for large tables expect to lean on risk-based selection rather than perfect minimal form.

References

  • ISTQB CTFL Syllabus v4.0.1, §4.2.3 Decision Table Testing - istqb.org PDF (opens in new window) (official syllabus, fetched 2026-06-10; all quoted phrases above are from this section).
  • ISTQB Glossary term "decision table testing" exists at glossary.istqb.org but the site blocks non-browser fetches; cite the syllabus section above as the stable source.
  • Siblings: state-transition-test-design (stateful behavior), manual-test-script-author (expands derived cases into runnable scripts).
  • Neighbors this skill is distinct from: test-case-ideation-from-story, boundary-value-generator, test-case-anatomy-reference.

Extended-entry tables and anti-patterns

View source (opens in new window)

Extended-entry tables and anti-patterns

Deep reference for decision-table-test-design SKILL.md. Section numbers (§4.2.3) refer to ISTQB CTFL Syllabus v4.0.1, cited in full in the skill's References section.

Limited-entry vs extended-entry tables

Per §4.2.3: "in limited-entry decision tables all the values of the conditions and actions (except for irrelevant or infeasible ones) are shown as Boolean values", while "in extended-entry decision tables some or all the conditions and actions may also take on multiple values (e.g., ranges of numbers, equivalence partitions, discrete values)".

The tables in the skill body are limited-entry. If the spec later adds a tier (orders of $200 or more ship express free for everyone), prefer one extended-entry condition over two correlated Booleans:

E1E2E3
C1 memberFFF
C2 order total< $50$50 to $199.99>= $200
C3 expressFTT
Action: fee$5.99$14.99$0.00

Extended entries keep correlated conditions (total >= $50, total >= $200) in one row, which avoids manufacturing infeasible columns like "total >= $200 but not >= $50".

Anti-patterns

Anti-patternWhy it failsFix
Testing only the happy columnsThe spec's gaps live in the F-heavy columns; §4.2.3's whole point is the combinations that would otherwise be overlookedOne test case per feasible column; coverage = exercised/feasible columns
Skipping infeasible-combination analysisNaive collapses (R1 + R3 here) produce test cases for unreachable states; testers burn time failing to set them upStep 4 before finalizing any merge; add a constraint check per deleted column
Collapsing before checking actions matchA dash that hides two different outcomes silently deletes a ruleMerge only when every expansion yields identical action rows
Tables with many conditions, no reduction§4.2.3: "the number of rules grows exponentially with the number of conditions"Per §4.2.3, use "a minimized decision table or a risk-based approach"; or split the rule set per feature
Non-atomic conditions ("member with big order")Column semantics become ambiguous; collapse logic breaksOne yes/no question per condition row (Step 1)
No action row for an outcome in the specThe table cannot reveal the contradiction it was built to findRe-extract actions until every spec outcome maps to a row

Related skills

bug-bash-facilitator

Builds a structured bug-bash session - pre-bash kit (charter, test-data prep, environment setup, sign-up sheet), in-bash structure (role rotation across cohorts, shared backlog board, real-time triage), scoring rubric (severity weighting, novelty bonus), and a post-bash same-day wrap-up authored by the facilitator (not a standalone debrief: for post-session writeups without a live bash, use manual-test-debrief). Use when a team needs a coordinated multi-tester sweep before a release or after a major change - converts an ad-hoc "everyone test for an hour" into a recorded, comparable session with deliverables.

crusspic-stmpl-heuristic

Pure-reference catalog of James Bach's CRUSSPIC STMPL heuristic - thirteen quality criteria (quality attributes / non-functional requirements) a tester can evaluate a system against. CRUSSPIC: Capability, Reliability, Usability, Security, Scalability, Performance, Installability, Compatibility. STMPL: Supportability, Testability, Maintainability, Portability, Localizability. Use when checking a product's quality attributes or non-functional requirements, or picking which quality characteristics a test session evaluates - a checklist for judging product quality holistically; complementary to the ISO/IEC 25010 software product-quality model.

exploratory-tours-reference

Pure-reference catalog of the seven exploratory testing tours from Whittaker's Exploratory Software Testing (2009): Feature, Money, Landmark, Intellectual, Bad-data, Configuration, and Garbage-collector's, each a themed mission with the signal it surfaces and a worked example. Use as the menu a charter author picks session themes from. Distinct from the mnemonic catalogs sfdpot-exploratory-heuristic (what to vary) and hiccupps-f-heuristic (oracles), and from session-based-test-management-reference, which manages the sessions.

fcc-cuts-vids-heuristic

Pure-reference catalog of Michael Kelly's FCC CUTS VIDS touring heuristic (2005): eleven tours - Feature, Complexity, Claims, Configuration, User, Testability, Scenario, Variability, Interoperability, Data, Structure - each a reconnaissance sweep that builds familiarity with an unfamiliar application. Use when onboarding onto a product or opening a first session on an unknown area, before a charter is scoped. Distinct from exploratory-tours-reference (Whittaker's seven tours, which frame a bug-hunting mission on a product the tester already knows), sfdpot-exploratory-heuristic (what to vary), hiccupps-f-heuristic (oracles), and crusspic-stmpl-heuristic (quality criteria).

hiccupps-f-heuristic

Pure-reference catalog of Michael Bolton's HICCUPPS-F oracle heuristic - the reference points a tester consults to decide 'is this a bug?': History, Image, Comparable products, Claims, Users' desires, Product (internal consistency), Purpose, Standards/statutes, plus Familiar problems. Use mid-session to test an observation against each oracle. For what to VARY use sfdpot-exploratory-heuristic, for touring an unfamiliar product use fcc-cuts-vids-heuristic, for quality criteria use crusspic-stmpl-heuristic.

manual-test-debrief

Session debrief template + tour-coverage tracker - captures the SBTM PROOF format (Past, Results, Obstacles, Outlook, Feelings) plus three-bucket time accounting (test design / setup / bug investigation), the tours applied + areas covered + areas skipped, and the per-session quality-of-attention signal. Output is the artifact a charter delivers into; the team aggregates debriefs across sessions to track what's been explored vs what's still uncharted. Use after every exploratory session - without the debrief, the session's findings disappear.

manual-test-script-author

Builds stakeholder-readable scripted manual test cases from a feature spec - emits either a step-table format (preconditions / steps / expected result / actual / pass-fail / notes) for spreadsheet review or a Gherkin Given/When/Then format for BDD-aware teams. Each script is self-contained (no implicit team knowledge), single-scenario (one happy + N edge per script), and includes the data setup the tester needs without being a developer. Use when a feature can't be (or shouldn't be) fully automated and a human tester needs an executable script - UAT, regression baselines, certification testing, exploratory follow-up scripts.

manual-testing-overview

Teaches human-driven testing end to end: when a predefined scripted test case is the right instrument versus a time-boxed exploratory session, how session-based test management works (charter with a stated mission, time box, session notes, debrief) with a worked charter and a filled-in session sheet, a decision rule for what to automate versus what to keep human, and what makes a manual bug report actionable (exact reproduction steps, observed versus expected, build and environment, evidence). Use when planning or running testing a person performs by hand, writing a charter for an exploratory session, deciding whether a check belongs in an automated suite or in a human session, or fixing bug reports that developers keep returning as not reproducible.

session-based-test-management-reference

Pure-reference catalog of Session-Based Test Management (SBTM) - the Bachs' framework for running exploratory testing as time-boxed sessions: the session (60-90 min), the charter (Explore X with Y to discover Z), the session-sheet structure, the TBS metrics, the cross-session dashboard, and the PROOF debrief. Use when authoring exploratory-testing charters, reviewing session sheets, or setting up time-boxed test sessions. Distinct from manual-test-debrief (the PROOF debrief template), exploratory-tours-reference (the session themes), and the heuristic catalog hiccupps-f-heuristic.

sfdpot-exploratory-heuristic

Pure-reference catalog of James Bach's SFDPOT heuristic - 'San Francisco Depot' - a 'you are here' framework that catalogues what a tester can vary in a system to find bugs. Six dimensions: Structure, Function, Data, Platform, Operations, Time. Use as a what-to-vary checklist during an exploratory session, complementing HICCUPPS-F (which catalogues what to compare against).

state-transition-test-design

Derives human-readable manual test cases from stateful behavior: identify states, events, transitions, and guard conditions, draw the state table including invalid (empty-cell) transitions, choose a coverage level (all states, valid transitions / 0-switch, transition pairs / 1-switch per Chow, all transitions including invalid ones), then derive one test case per coverage item as an event sequence with per-step expected states (ISTQB CTFL v4.0 section 4.2.4). A deep single-technique walkthrough rather than a broad multi-lens case matrix; the output is manual step/expected cases rather than parameterized test code, and it covers how cases are derived rather than how a case record is structured. Use for lifecycle entities (accounts, orders, subscriptions), workflows, and UI wizards where the response to an event depends on the current state.

test-execution-checklist

Converts a regression suite (or test plan) into an executable manual checklist for cases when automation isn't viable - a release-day smoke checklist, a post-incident verification list, or a periodic compliance check. Outputs a per-TC checkbox list with the minimal preconditions, the action, and a one-line "what to look for" - short enough to fit on one page per major flow. Use when the team needs a focused human-runnable list (not full step-tables), e.g., for production smoke after deploy or for the on-call rotation's quick verification.

uat-script-author

Emits User Acceptance Testing scripts in stakeholder-readable format - pre-conditions / business-language steps / expected business outcome / pass-fail / sign-off. Tailored for non-developer testers (end users, SMEs, solution owners) per the UAT canonical definition. Output is one TC per stakeholder-meaningful scenario with explicit sign-off, suitable for compliance / contract / audit records. Use when a release requires formal UAT before sign-off - typical for B2B contracts, regulated industries, or any delivery where the customer's acceptance is the contractual gate.