DigiQAgent

A Cursor plugin focused on QA, testing, debugging, code review, verification workflows, API artifact generation, and Playwright UI testing.

Architecture

flowchart LR
    subgraph Plugin["DigiQAgent Plugin"]
        direction TB
        subgraph Dev["Development Workflow"]
            TDD["test-driven-development"]
            DBG["systematic-debugging"]
            VER["verification-before-completion"]
        end
        subgraph Review["Code Review"]
            REQ["requesting-code-review"]
            REC["receiving-code-review"]
            AGT["code-reviewer agent"]
        end
        subgraph API["API Artifact Generation"]
            SWG["swagger-generator"]
            PMC["postman-collection-generator"]
            PMT["postman-test-suite-generator"]
        end
        subgraph UI["UI Test Generation"]
            PW["playwright-test-generator"]
        end
    end

    IDE["Cursor IDE"] --> Plugin

    style IDE fill:#4a90d9,stroke:#2c5f8a,color:#fff
    style Dev fill:#e8f5e9,stroke:#81c784
    style Review fill:#e3f2fd,stroke:#64b5f6
    style API fill:#fff3e0,stroke:#ffb74d
    style UI fill:#f3e5f5,stroke:#ce93d8

What's Included

Skills (9)

Agent (1)

Review Prompt Templates (2)

API Artifact Generation

The three new API skills form a pipeline that takes your codebase or API design document and produces ready-to-use testing artifacts:

flowchart TD
    A["Codebase / Spec Document"] --> B["swagger-generator"]
    B -- "openapi.yaml" --> C["postman-collection-generator"]
    C -- "postman_collection.json<br>postman_environment.json" --> D["postman-test-suite-generator"]
    D -- "postman_test_collection.json" --> E["Developer imports into<br>Postman and runs manually"]

    style A fill:#4a90d9,stroke:#2c5f8a,color:#fff
    style B fill:#50b86c,stroke:#2d7a3e,color:#fff
    style C fill:#50b86c,stroke:#2d7a3e,color:#fff
    style D fill:#50b86c,stroke:#2d7a3e,color:#fff
    style E fill:#f5a623,stroke:#c77d0a,color:#fff

Workflow:

1. Generate the OpenAPI spec — analyzes routes, controllers, models, middleware, or reads a design document to produce a complete openapi.yaml
2. Generate the Postman collection — builds organized requests with folders, environment variables, realistic example data, and pre-request scripts
3. Generate the test suite — adds comprehensive positive and negative test scenarios covering missing fields, invalid types, boundary values, auth failures, not-found cases, duplicates, and more

Each skill can also run independently. The Postman collection generator can work directly from codebase analysis, and the test suite generator can work from an OpenAPI spec.

UI Test Generation

The Playwright skill handles frontend UI test generation for Angular and React applications:

flowchart TD
    A["Angular / React Codebase"] --> B["Detect Framework & Scan<br>Components, Routes, Forms,<br>Click Events, Modals, Tables"]
    B --> C["Page Objects<br>(POM)"]
    B --> D["Playwright Tests<br>(.spec.ts)"]
    C --> E["Developer runs:<br>npx playwright test"]
    D --> E

    style A fill:#4a90d9,stroke:#2c5f8a,color:#fff
    style B fill:#7b68ee,stroke:#5a4cba,color:#fff
    style C fill:#50b86c,stroke:#2d7a3e,color:#fff
    style D fill:#50b86c,stroke:#2d7a3e,color:#fff
    style E fill:#f5a623,stroke:#c77d0a,color:#fff

What it covers:

• Auto-detection — identifies Angular vs React, component libraries (Material, MUI, Ant Design), and routing configuration
• Component scanning — discovers click handlers, form bindings, modals, dropdowns, tables, navigation links, conditional rendering
• Positive tests — page load, valid form submission, navigation, modal interactions, table sorting and pagination
• Negative tests — empty required fields, invalid formats, boundary values, unauthorized access, empty/error states, double-submit prevention
• Responsive tests — mobile hamburger menu, sidebar collapse, stacked layouts
• Accessibility tests — keyboard navigation, ARIA labels, focus management, axe-core audits

Installation

Via npm (recommended)

npx digiqagent install

Via script

# One-liner (after hosting the repo)
curl -sSL https://raw.githubusercontent.com/<your-org>/digiqagent/main/install.sh | bash

# Or clone and run the script
git clone <repo-url> && cd digiqagent && ./install.sh

See INSTALLATION.md for the full guide — npm CLI commands, manual install, environment variables, update/uninstall commands, team distribution options, and troubleshooting.

Usage

Skills activate automatically based on context. You can also invoke them explicitly:

Use digiqagent:test-driven-development
Use digiqagent:systematic-debugging
Use digiqagent:verification-before-completion
Use digiqagent:requesting-code-review
Use digiqagent:receiving-code-review
Use digiqagent:swagger-generator
Use digiqagent:postman-collection-generator
Use digiqagent:postman-test-suite-generator
Use digiqagent:playwright-test-generator

Directory Structure

digiqagent/
  package.json
  bin/
    cli.js
  .cursor-plugin/
    plugin.json
  skills/
    test-driven-development/
      SKILL.md
      testing-anti-patterns.md
    systematic-debugging/
      SKILL.md
      root-cause-tracing.md
      defense-in-depth.md
      condition-based-waiting.md
      condition-based-waiting-example.ts
      find-polluter.sh
      CREATION-LOG.md
      test-academic.md
      test-pressure-1.md
      test-pressure-2.md
      test-pressure-3.md
    verification-before-completion/
      SKILL.md
    requesting-code-review/
      SKILL.md
      code-reviewer.md
    receiving-code-review/
      SKILL.md
    review-prompts/
      spec-reviewer-prompt.md
      code-quality-reviewer-prompt.md
    swagger-generator/
      SKILL.md
      openapi-patterns.md
    postman-collection-generator/
      SKILL.md
      collection-patterns.md
    postman-test-suite-generator/
      SKILL.md
      test-scenario-patterns.md
    playwright-test-generator/
      SKILL.md
      page-object-patterns.md
      interaction-test-patterns.md
  agents/
    code-reviewer.md
  README.md

License

MIT