How It Works

From Markdown to Measured Confidence

Step 1

Author

Write test cases in Markdown with setup, action, and expectation sections.

Step 2

Execute

Run tests via the CLI or CI runner. Markdown cells become executable tests.

Step 3

Capture

Results, logs, and metrics are automatically recorded during execution.

Step 4

Store

Structured results saved in local or remote SQL databases with full provenance.

Step 5

Visualize

Results appear in dashboards, Markdown summaries, or compliance exports.

Typical Test Structure

Qualityfolio organizes test artifacts in a hierarchical folder structure. Each project contains requirements, test cycles, and test suites with their associated cases, execution results, and bug reports.

plaintext

qualityfolio
├── strategy
│   └── authentication-strategy
│       ├── authentication-strategy.md
│       └── suites
│           └── login-suite
│               ├── login-suite.md
│               └── plans
│                   └── login-plan
│                       ├── login-plan.md
│                       └── cycles
│                           ├── TCY-0001
│                           │   ├── cycle-1.md
│                           │   └── cases
│                           │       ├── TC-login-001.case.md
│                           │       ├── TC-login-002.case.md
│                           │       ├── TC-login-003.case.md
│                           │       ├── TC-login-004.case.md
│                           │       ├── TC-login-005.case.md
│                           │       └── TC-login-006.case.md
│                           ├── TCY-0002
│                           │   ├── cycle-2.md
│                           │   └── cases
│                           │       ├── TC-login-001.case.md
│                           │       ├── TC-login-002.case.md
│                           │       ├── TC-login-003.case.md
│                           │       ├── TC-login-004.case.md
│                           │       ├── TC-login-005.case.md
│                           │       └── TC-login-006.case.md
│                           └── TCY-0003
├── evidence
│   ├── TCY-0001-TC-101-run.md
│   ├── TCY-0001-TC-101-results-2025-10-31.json
│   ├── TCY-0001-TC-102-run.md
│   ├── TCY-0001-TC-102-results-2025-10-31.json
│   ├── TCY-0002-TC-101-run.md
│   ├── TCY-0002-TC-101-results-2025-11-15.json
│   ├── TCY-0002-TC-101-bug.md
│   ├── TCY-0002-TC-103-run.md
│   ├── TCY-0002-TC-103-results-2025-11-15.json
│   ├── TCY-0003-TC-104-run.md
│   └── TCY-0003-TC-104-results-2025-12-01.json