Config Schema Reference

dq-qa.config.json is the single source of truth for all skill configuration. It lives at the project root and is committed to the repository.

---

Full schema

{
  "project": {
    "name": "string - required"
  },
  "domains": {
    "ui": {
      "enabled": "boolean - default true",
      "baseUrl": "string - required if enabled",
      "recordVideo": "boolean - default true",
      "reportDir": "string - default ./qa-reports/ui"
    },
    "api": {
      "enabled": "boolean - default true",
      "baseUrl": "string - required if enabled",
      "schemaUrl": "string - use this or schemaPath",
      "schemaPath": "string - local schema file, use this or schemaUrl",
      "reportDir": "string - default ./qa-reports/api"
    },
    "accessibility": {
      "enabled": "boolean - default true",
      "jurisdiction": "enum: US | NZ | AU | CA | EU | UK | JP | IN | BR | MX | INTERNATIONAL",
      "level": "enum: A | AA | AAA - default AA",
      "reportDir": "string - default ./qa-reports/a11y"
    },
    "performance": {
      "enabled": "boolean - default true",
      "schemaUrl": "string - required if enabled",
      "thresholds": {
        "p99LatencyMs": "number - required if enabled",
        "okRequestPercent": "number - required if enabled"
      },
      "reportDir": "string - default ./qa-reports/perf"
    }
  },
  "requirements": {
    "docsPath": "string - default ./requirements"
  }
}

---

Minimal config (all domains disabled except API)

{
  "project": { "name": "my-app" },
  "domains": {
    "ui": { "enabled": false },
    "api": {
      "enabled": true,
      "baseUrl": "https://api.example.com",
      "schemaUrl": "https://api.example.com/swagger.json"
    },
    "accessibility": { "enabled": false },
    "performance": { "enabled": false }
  }
}

---

Validation

Every skill validates the config on startup and reports any missing required fields. If dq-qa.config.json does not exist, the skill automatically runs /qa-onboard to create it.

---

How the config is used per skill

Skill	Config fields read
/qa-onboard	Writes all fields
/qa-api	api.baseUrl, api.schemaUrl or api.schemaPath, api.reportDir
/qa-ui	ui.baseUrl, ui.recordVideo, ui.reportDir
/qa-a11y	accessibility.jurisdiction, accessibility.level, accessibility.reportDir
/qa-perf	performance.schemaUrl, performance.thresholds.p99LatencyMs, performance.thresholds.okRequestPercent, performance.reportDir, requirements.docsPath
/qa-exec	All enabled domain configs
/qa-report	All reportDir values, project.name