Skip to content

docs: add ASCII product journey and tool map #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Desperado merged 1 commit into from
Sep 12, 2026
Merged

docs: add ASCII product journey and tool map #4

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 54 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,20 @@
```text
╱|、
(˚ˎ 。7
|、˜〵
じしˍ,)ノ

██████╗ ███╗ ███╗ █████╗ ██╗ ██╗
██╔═══██╗████╗ ████║██╔══██╗╚██╗██╔╝
██║ ██║██╔████╔██║███████║ ╚███╔╝
██║▄▄ ██║██║╚██╔╝██║██╔══██║ ██╔██╗
╚██████╔╝██║ ╚═╝ ██║██║ ██║██╔╝ ██╗
╚══▀▀═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝

q u a l i t y m a x
Independent verification for AI-written code
```

# QualityMax

**Independent verification for AI-written code.**
Expand All @@ -22,13 +39,24 @@ Hosted workflows require a QualityMax account and use the allowances of your pla

## From a user journey to reviewable evidence

```mermaid
flowchart LR
A[Discover journeys] --> B[Review generated tests]
B --> C[Execute tests]
C --> D[Inspect results and artifacts]
D --> E[Review findings or repairs]
E --> F[Rerun and retain evidence]
```text
┌─ FROM JOURNEY TO EVIDENCE ───────────────────────────────┐
│ │
│ 01 DISCOVER Map application journeys │
│ │ │
│ 02 GENERATE Create cases and scripts │
│ │ │
│ 03 REVIEW Check intent and assertions │
│ │ │
│ 04 EXECUTE Run the reviewed tests │
│ │ │
│ 05 INSPECT Read results and available artifacts │
│ │ │
│ 06 REFINE Review repairs if needed; rerun │
│ │ │
│ └────────> Retain the evidence │
│ │
└──────────────────────────────────────────────────────────┘
```

QualityMax organizes work as **Projects → Test Cases → Automation Scripts**. A test case records expected behavior; scripts implement that intent for a framework. Inspect the completed execution and its available artifacts before treating a queued job or a generated script as proof. [Core concepts](https://docs.qualitymax.io/core-concepts/)
Expand Down Expand Up @@ -65,6 +93,25 @@ Nexus on-demand specialist review is a separate workflow from automatic PR revie

## Local tools and integrations

```text
┌─ FIND YOUR WORKSPACE ────────────────────────────────────┐
│ │
│ QualityMax │
│ ├── In the browser │
│ │ └── Hosted projects, tests, runs, and reports │
│ ├── In your terminal │
│ │ ├── qmax-code Coding and QA agent │
│ │ └── qmax Platform CLI / local agent │
│ ├── In your coding agent │
│ │ ├── qmax-mcp Local browser QA tools │
│ │ └── Free QA Skills Reusable QA workflows │
│ └── In your workflow │
│ ├── GitHub PR checks and Actions │
│ └── n8n / Slack Integrations and context │
│ │
└──────────────────────────────────────────────────────────┘
```

| Project | Use it for | License / status |
|---|---|---|
| [qmax-mcp](https://github.com/Quality-Max/qmax-mcp) | Four standalone MCP tools: scan, inspect, generate a Playwright reproduction, run a test | MIT |
Expand Down
Loading