quality-engineering-business-analysis
Investigate requirements with atomic AC decomposition, actor/permission matrix, platform parity audit, truth table verification, and edge case discovery. Also enforces User Story authoring standards: story structure, scope fences, platform tags, toggle contracts, market isolation, and deferral patterns. Use when writing, reviewing, or improving User Stories, acceptance criteria, or doing impact analysis — especially for stories with multi-condition AC, feature toggles, market variants (VN/MY/SG), or undefined platform behavior. (triggers: **/user_story.md, acceptance criteria, AC, business rules, jira story, toggle, market, write user story, improve user story, review story, BA)
Best use case
quality-engineering-business-analysis is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Investigate requirements with atomic AC decomposition, actor/permission matrix, platform parity audit, truth table verification, and edge case discovery. Also enforces User Story authoring standards: story structure, scope fences, platform tags, toggle contracts, market isolation, and deferral patterns. Use when writing, reviewing, or improving User Stories, acceptance criteria, or doing impact analysis — especially for stories with multi-condition AC, feature toggles, market variants (VN/MY/SG), or undefined platform behavior. (triggers: **/user_story.md, acceptance criteria, AC, business rules, jira story, toggle, market, write user story, improve user story, review story, BA)
Teams using quality-engineering-business-analysis should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/quality-engineering-business-analysis/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How quality-engineering-business-analysis Compares
| Feature / Agent | quality-engineering-business-analysis | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Investigate requirements with atomic AC decomposition, actor/permission matrix, platform parity audit, truth table verification, and edge case discovery. Also enforces User Story authoring standards: story structure, scope fences, platform tags, toggle contracts, market isolation, and deferral patterns. Use when writing, reviewing, or improving User Stories, acceptance criteria, or doing impact analysis — especially for stories with multi-condition AC, feature toggles, market variants (VN/MY/SG), or undefined platform behavior. (triggers: **/user_story.md, acceptance criteria, AC, business rules, jira story, toggle, market, write user story, improve user story, review story, BA)
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
SKILL.md Source
# Business Analysis Standards (Deep Analysis + Story Authoring) ## **Priority: P0 (CRITICAL)** ## 1. Deep Investigation Protocol - **Atomic AC Decomposition**: Split **Acceptance Criteria (AC)** into **1-Condition** logic units (e.g., "User can X and Y" -> "User can X", "User can Y"). - **Variable Identification**: Extract all **Feature Toggles**, **Market Rules** (VN/MY/SG), and **User Roles**. - **Platform Parity**: Verify if logic applies to both **Web** and **Mobile**; Flag divergent behavior early. - **Truth Table Verification**: Map complex multi-condition logic to a **Logic Truth Table**. ## 2. Dynamic Actor & Permission Mapping - Identify all **Actors** (e.g., `Customer`, `Sales Rep`, `Admin`). - Use an **Actor/Permission Matrix** to map specific constraints per Actor. - [Permissions Patterns](references/analysis_patterns.md) ## 3. Edge Case & Boundary Analysis - **State Validation**: Verify behavior across all entity (e.g., `Active`, `Suspended`) and network states. - **Boundary Detection**: Analyze **currency**, **date**, and **count limits**. - **Negative Testing**: Identify flows for **Unauthorized Access**, **Invalid Input**, and **Null-safety**. ## 4. Anti-Patterns (Analysis) - **No Surface Reading**: investigate the _implications_, don't just restate. - **No Assumption**: Flag undefined states (e.g., Offline) as P0 blockers. - **No Loose Mapping**: Ensure AC aligns 100% with Technical Impact notes. ## 5. User Story Authoring Standards - **Story Structure**: Every story must use `As a [Actor], I want [Goal], so that [Value]`. - **AC Format**: Each AC must be one `Given / When / Then` block — one condition per block. - **Platform Tag**: Prefix each AC with `[WEB]`, `[MOBILE]`, or `[BOTH]` — never mix platforms in one AC block. - **Toggle Contract**: Each feature flag AC must name the flag and state: `Toggle: <FlagName> = ON/OFF`. - **Market Isolation**: Any market-specific AC must be prefixed `[Market: VN]`, `[Market: MY]`, etc. - **Scope Fence**: Include explicit `## In Scope`, `## Out of Scope`, and `## Deferred` sections. Deferred items must link to a Jira ticket — never write "to discuss". - **Translation AC**: Language/locale behavior is a separate AC, not an inline note. See [User Story Template](references/user_story_template.md) for the full authoring template. ## 6. Anti-Patterns (Story Authoring) - **No mixed-platform AC**: `[MOBILE ONLY]` buried inline hides parity gaps — use platform tags. - **No "to discuss"**: Replace with a linked Jira ticket in `## Deferred`. - **No implicit toggle states**: Always declare both ON and OFF behavior per AC. - **No bundled AC**: "User sees X and Y and Z" → split into three separate AC blocks. ## 7. Validation Checklist Run after authoring or reviewing any User Story before marking it ready for development: - [ ] Every AC has a `[WEB]`, `[MOBILE]`, or `[BOTH]` platform tag - [ ] Every toggle AC declares both `= ON` and `= OFF` states explicitly - [ ] No AC block contains more than one `And` condition (split if it does) - [ ] No "to discuss" text anywhere — replaced by a Jira link in `## Deferred` - [ ] Story has `## In Scope`, `## Out of Scope`, and `## Deferred` sections - [ ] Story uses `As a / I want / So that` header - [ ] Market-specific ACs are prefixed `[Market: VN]`, `[Market: MY]`, etc. - [ ] Translation / locale behavior is its own AC or deferred with a Jira link
Related Skills
quality-engineering-zephyr-test-generation
Generate Zephyr test cases from Jira stories: parse AC, identify platform and market, impact-analyze existing TCs (update vs create new), draft test cases with correct naming/metadata/preconditions, and link back via Create Test Case Issue Link. Use when converting a Jira story into Zephyr TCs, or when requirement changes require updating existing TCs rather than creating duplicates. (triggers: **/user_story.md, generate test cases, zephyr, impact analysis, create test case)
quality-engineering-zephyr-coverage-analysis
Audit test coverage health, gaps, and QE debt for Jira stories or epics. Produces coverage_analysis_report.md with AC-to-TC heatmap, risk scores, and prioritized action plan. Use when assessing coverage percentage, pre-release readiness, sprint readiness, or identifying missing test cases. Do NOT use for TC creation — use zephyr-test-generation instead. (triggers: coverage analysis, test coverage, coverage gaps, QE debt, QE audit, pre-release readiness, sprint readiness, coverage_analysis_report.md, zephyr coverage, test gap, AC coverage, test-ready)
quality-engineering-quality-assurance
Write manual test cases with 1-condition-per-TC granularity, Module_Action on Screen when Condition naming, platform prefix rules, and High/Normal/Low priority classification. Use when writing or reviewing manual test cases for Zephyr — to split compound TCs, fix naming violations, assign correct platform tags, or determine bug priority. (triggers: test case, manual test, zephyr, test scenario, naming convention, acceptance criteria)
quality-engineering-jira-integration
Jira ↔ Zephyr traceability: fetch story AC and components, detect existing TC links, link new Zephyr TCs back to Jira, and apply has-zephyr-tests labels. Use after creating Zephyr test cases that need linking, when fetching a Jira story's details for test generation, or when auditing and cleaning up stale TC links. (triggers: jira issue, zephyr link, has-zephyr-tests, traceability, link test case, EZRX-)
common-performance-engineering
Enforce universal standards for high-performance development. Use when profiling bottlenecks, reducing latency, fixing memory leaks, improving throughput, or optimizing algorithm complexity in any language. (triggers: **/*.ts, **/*.tsx, **/*.go, **/*.dart, **/*.java, **/*.kt, **/*.swift, **/*.py, performance, optimize, profile, scalability, latency, throughput, memory leak, bottleneck)
swift-tooling
Configure SPM packages, SwiftLint, and build settings for Swift projects. Use when managing Swift packages with SPM, configuring build settings, or enforcing Swift code quality. (triggers: Package.swift, .swiftlint.yml, package, target, dependency)
swift-testing
Write XCTest cases, async tests, and organized test suites in Swift. Use when writing XCTest cases, async tests, or organizing test suites in Swift. (triggers: **/*Tests.swift, XCTestCase, XCTestExpectation, XCTAssert)
swift-swiftui
Configure SwiftUI state, view lifecycle, and Property Wrappers correctly. Use when managing SwiftUI state, view lifecycle, or property wrappers like @State and @Binding. (triggers: **/*.swift, @State, @Binding, @ObservedObject, View, body)
swift-memory-management
Prevent retain cycles via ARC, weak/unowned references, and Capture Lists in Swift. Use when managing Swift ARC, avoiding retain cycles, or configuring capture lists in closures. (triggers: **/*.swift, weak, unowned, capture, deinit, retain)
swift-language
Apply Optionals, Protocols, Extensions, and Type Safety patterns in Swift. Use when working with Swift Optionals, Protocols, Extensions, or type-safe APIs. (triggers: **/*.swift, protocol, extension, optional, guard, enum)
swift-error-handling
Standards for throwing functions, Result type, and Never. Use when implementing Swift error throwing, designing error hierarchies, using Result types, or adding do-catch blocks. (triggers: **/*.swift, throws, try, catch, Result, Error)
swift-concurrency
Implement async/await, Actors, and structured concurrency in Swift. Use when implementing Swift async/await, Actors, or structured concurrency in iOS/macOS. (triggers: **/*.swift, async, await, actor, Task, MainActor)