breadfast-qa

The canonical AI QA Companion — the workflow, not the story outputs.

• CLAUDE.md + docs/ai/** — the canonical workflow + knowledge base (single source of truth).
• qa-workflow/ — workflow definitions, skills, and the qa-cli.js gate tooling.
• .claude/skills/ — the Claude Code entrypoints (/qa-shift-left, /qa-validate, /qa-full).
• automation/ — shared page objects, helpers, config, the BrowserStack tooling (automation/browserstack/) and the legacy Playwright suite (automation/legacy/).

Everything here is self-contained: no folder outside this repository is required. The one external dependency is the Java/Appium framework used for automation generation, whose path is configurable (QA_FRAMEWORK_PATH → automation/config/framework.js) and which reports a clear "not found" rather than assuming a drive letter.

Per-story artifacts are not committed. A story folder (<TICKET>/) is created at the repo root during a run and is gitignored — requirements analysis, Figma captures, test cases, execution reports, screenshots, evidence and defects all stay local to whoever ran the story. Reusable tooling belongs in automation/; story data does not belong in git.

Quick start

New here? Follow SETUP.md — empty machine to first workflow, Windows and macOS. The short version:

git clone https://github.com/Breadfast/breadfast-qa.git
git clone https://github.com/Breadfast/QA_Automation_Framework.git projects   # side by side
cd breadfast-qa
npm install && npm run playwright:install
cp automation/config/credentials.local.example.js automation/config/credentials.local.js
# fill in your own values; copy the team's framework config files into ../projects/resources/environments/
npm run doctor                    # tells you exactly what is still missing

Then open this folder in Claude Code, approve the project MCP servers and plugins it offers (.mcp.json, .claude/settings.json), authenticate Atlassian and Figma with /mcp, and run /qa-shift-left, /qa-validate, or /qa-full.

Run the legacy Playwright suite:

npx playwright test --config=automation/legacy/playwright.config.js

History

The qa-platform/ app was removed on 2026-08-10 — a legacy execution engine, deferred since 2026-07-15 and superseded by Claude Code, with zero runtime coupling to this workflow. The design documents still cited by live docs were kept at docs/ai/architecture/legacy-qa-platform/; the app's own history remains on github.com/Breadfast/qa-platform.