{
  "markdown": "# dq-awesomeqa\n\nA QA lifecycle plugin that guides QA engineers through the full Software Testing Life Cycle — UI, API, Accessibility, and Performance — with the expertise of a senior QA consultant.\n\nWorks with **Claude Code**, **GitHub Copilot (VS Code)**, **Cursor**, **Gemini CLI**, **Codex CLI/App**, and **OpenCode**.\n\n---\n\n## Installation\n\n> Each coding agent needs its own separate installation. If you use more than one, install dq-awesomeqa for each.\n\n### Claude Code\n\n**Option A — Local clone (works today):**\n\n```bash\ngit clone https://github.com/uppadhyayraj/dq-awesomeqa\n```\n\nThen register the local path in your Claude Code settings (`~/.claude/settings.json`):\n\n```json\n{\n  \"enabledPlugins\": {\n    \"dq-awesomeqa@dq-awesomeqa\": true\n  },\n  \"extraKnownMarketplaces\": {\n    \"dq-awesomeqa\": {\n      \"source\": {\n        \"source\": \"directory\",\n        \"path\": \"/path/to/dq-awesomeqa\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Code and run `/qa-init` to verify.\n\n**Option B — Marketplace (once listed):**\n\n```bash\n/plugin install dq-awesomeqa@claude-plugins-official\n```\n\n---\n\n### GitHub Copilot (VS Code)\n\n> Requires VS Code with the GitHub Copilot extension. Agent plugins must be enabled (preview feature).\n\n**Step 1 — Enable agent plugins** in your VS Code user `settings.json`:\n\n```json\n{\n  \"chat.plugins.enabled\": true\n}\n```\n\n> This must be a **user-level** setting — workspace settings are silently ignored.\n\n**Step 2 — Register the local clone:**\n\n```bash\ngit clone https://github.com/uppadhyayraj/dq-awesomeqa\n```\n\nAdd to your VS Code user `settings.json`:\n\n```json\n{\n  \"chat.plugins.enabled\": true,\n  \"chat.pluginLocations\": {\n    \"/path/to/dq-awesomeqa\": true\n  }\n}\n```\n\n**Step 3 — Verify:** Restart VS Code and type `/qa-init` in the Copilot chat panel.\n\nFor full details and troubleshooting, see [docs/copilot-install.md](docs/copilot-install.md).\n\n---\n\n### Cursor\n\n**Step 1 — Clone the repo:**\n\n```bash\ngit clone https://github.com/uppadhyayraj/dq-awesomeqa\n```\n\n**Step 2 — Install via Cursor agent chat:**\n\n```\n/add-plugin /path/to/dq-awesomeqa\n```\n\nOr search for `dq-awesomeqa` in the Cursor plugin marketplace once listed.\n\n**Step 3 — Verify:** Open a Cursor agent session and type `/qa-init`.\n\n---\n\n### Gemini CLI\n\nInstall directly from GitHub:\n\n```bash\ngemini extensions install https://github.com/uppadhyayraj/dq-awesomeqa\n```\n\nTo update later:\n\n```bash\ngemini extensions update dq-awesomeqa\n```\n\n**Verify:** Start a Gemini CLI session and type `/qa-init`.\n\n---\n\n### Codex CLI\n\nOpen the plugin search interface and search for `dq-awesomeqa`:\n\n```\n/plugins\n```\n\nSearch for `dq-awesomeqa` and select **Install Plugin**.\n\n**Verify:** Run `/qa-init` in a Codex session.\n\n---\n\n### Codex App\n\nNavigate to **Plugins** in the sidebar, find `dq-awesomeqa` in the Testing section, and click **+** to install.\n\n---\n\n### OpenCode\n\nAdd to your `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"dq-awesomeqa@git+https://github.com/uppadhyayraj/dq-awesomeqa.git\"]\n}\n```\n\nRestart OpenCode — it installs automatically and registers all `/qa-*` skills.\n\nFor full details, see [.opencode/INSTALL.md](.opencode/INSTALL.md).\n\n---\n\n## Prerequisites (all platforms)\n\n| Requirement | Used by |\n|-------------|---------|\n| Node.js | Hooks (safety, audit, sanitize) |\n| `a11y-cli` | UI + Accessibility tests (`/qa-setup` installs this) |\n| `dq-nbomber` | Performance tests (`/qa-setup` installs this) |\n| `democratize-quality` MCP server | API tests (run `/qa-setup` to register) |\n\nRun `/qa-setup` after installing the plugin — it installs the CLI tools and registers the MCP server.\n\n---\n\n## Getting started\n\nRun `/qa-init` to begin. It walks you through every phase of the STLC in order, enforces phase gates, lets you choose which domains to cover, and won't let you skip steps that would leave gaps.\n\nIf you prefer to work domain by domain, see the individual skills below.\n\n## The STLC Journey\n\n```\n/qa-init\n  │\n  ├─ Phase 1 — Setup\n  │     /qa-setup    → install tools (once per machine)\n  │     /qa-onboard  → configure project (once per project)\n  │\n  ├─ Phase 2 — Planning\n  │     /qa-requirement → gather requirements (first cycle) → requirements/ folder\n  │     /qa-impact      → record what changed (subsequent cycles)\n  │     /qa-plan        → derive test strategy from requirements/ → qa-plan.md\n  │\n  ├─ Phase 3 — Design  (only domains in scope)\n  │     /qa-api      → API test plan\n  │     /qa-ui       → UI interaction script\n  │     /qa-a11y     → Accessibility audit (runs after /qa-ui)\n  │     /qa-perf     → Load test config\n  │     /qa-coverage → Design gap check (are all planned areas designed?)\n  │\n  ├─ Phase 4 — Execution\n  │     /qa-exec     → run all in-scope domain tests\n  │\n  └─ Phase 5 — Closure\n        /qa-triage   → categorize failures, ship/no-ship verdict (if failures)\n        /qa-coverage → release readiness gate (is it safe to ship?)\n        /qa-report   → consolidated QA summary\n```\n\n**Two feedback loops are built into the journey:**\n- Failures after execution → `/qa-triage` → fix → re-execute\n- Requirements change between cycles → `/qa-impact` → updated plan → re-design\n\n## Skills reference\n\n### Entry point\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-init` | Start here — guided STLC journey with phase gates and domain scope selection |\n\n### Setup (run once)\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-setup` | Once per machine — installs CLIs and registers MCP server |\n| `/qa-onboard` | Once per project — collects URLs, schema, a11y level, perf thresholds |\n\n### Planning\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-requirement` | First cycle — gathers requirements via Jira, paste, or guided questions; writes `requirements/` folder |\n| `/qa-plan` | Per cycle — derives test strategy from `requirements/`; writes `qa-plan.md` |\n| `/qa-impact` | Subsequent cycles — records changed requirements, updates `requirements/` + `qa-plan.md`, flags domain re-runs |\n\n### Design (one per domain)\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-api` | Build the API test plan from schema — executed by `/qa-exec` via MCP |\n| `/qa-ui` | Explore the live app and build the UI interaction YAML |\n| `/qa-a11y` | Add WCAG accessibility scan steps to `ui-test.yaml`, or build a standalone audit |\n| `/qa-perf` | Generate load test config from schema via dq-nbomber |\n\n### Execution\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-exec` | Execute all in-scope domain tests in recommended order (API → UI+A11y → Perf) |\n\n### Closure\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-triage` | After failures — categorize by severity, cross-reference schema, issue ship verdict |\n| `/qa-coverage` | After design (gap check) or before release (readiness gate) |\n| `/qa-report` | Consolidate all domain results into `qa-summary.md` |\n\n### Advanced\n\n| Skill | When to use |\n|-------|------------|\n| `/qa-codegen` | Generate runnable test code (framework files or C# NBomber program) — not part of the main STLC path |\n\n## Domain scope\n\nYou don't have to run all domains in every cycle. `/qa-init` (and `/qa-plan`) ask which domains to include at the start of each cycle. A single-domain run (e.g. API only, or Performance only) is a first-class path.\n\n## Contributing\n\nWe welcome contributions! To contribute:\n\n1. **Create an issue** — Describe the problem or feature you want to add\n2. **Fork the repository** — Clone your fork locally\n3. **Create a feature branch** — Make your changes\n4. **Submit a Pull Request** — Reference the issue in your PR\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## License\n\nThis project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0).\n\nSee [LICENSE](LICENSE) for details.\n\n---\n\n## Phase 2 (coming)\n\n`qa-security`, `qa-ci`, `qa-regression`, `qa-flaky`, `qa-metrics`, `qa-matrix`\n",
  "bytes": 7844,
  "sha": "c694b51b4af31b1d9e26a20133382612739c49130dec4854848aa271790634e5",
  "repo_slug": "uppadhyayraj/dq-awesomeqa",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_uppadhyayraj_dq_awesomeqa_614940be/readme"
}