Skip to content

jaktestowac/ui-api-automation-minimal

v0.1.0MIT

A compact UI + API pack with four helpers: explore (OpenAPI and/or Playwright MCP), plan, set up a test framework if none exists, and implement tests, each returning the same handoff packet. Pick it for a small first batch of tests or a project without a test framework; for a full suite with review and verification stages, use ui-api-automation.

🎼 UI + API test automation (minimal)

A compact UI + API pack with four helpers: explore (OpenAPI and/or Playwright MCP), plan, set up a test framework if none exists, and implement tests, each returning the same handoff packet. Pick it for a small first batch of tests or a project without a test framework; for a full suite with review and verification stages, use ui-api-automation.

Install: ui-api-automation-minimal@jaktestowac. See the quick start for each tool.

Start the pack

ToolHow
GitHub CopilotPick QA Orchestrator (Minimal) in the agent dropdown and describe the job. It hands off to the other agents.
Claude CodeRun /ui-api-automation-minimal followed by the job. The command coordinates; the agents below do the work.
OpenAI CodexCopy codex/agents/ into .codex/agents/, then run $ui-api-automation-minimal followed by the job.

Claude Code and Codex agents cannot start other agents, so there the orchestrator is a command that runs in your conversation.

Agents

AgentName in Claude Code and CodexWhat it does
QA Orchestrator (Minimal) (orchestrator)/ui-api-automation-minimal commandCoordinates a short explore, plan, set-up and implement loop for UI and/or API tests, and writes a timestamped automation summary to .ai-outputs/. Use for a small first batch of tests or a project without a test framework; the ui-api-automation pack adds review and verification stages.
Test Coder Agent (Minimal)uiapi-min-coder / uiapi_min_coderImplements the UI or API test tasks it is assigned from a test plan, following the repository's conventions, and runs them before handing back. Use as the implementation step of the minimal UI + API pack.
Explorer Agent (Minimal)uiapi-min-explorer / uiapi_min_explorerExplores an OpenAPI spec or the running UI (through Playwright MCP) and writes a short summary of structure, P0 journeys and flakiness risks to .ai-outputs/. Use as the exploration step of the minimal UI + API pack.
Test Framework Starter Agent (Minimal)uiapi-min-framework-starter / uiapi_min_framework_starterSets up a minimal Playwright test project (config, folders, one smoke run) when the repository has no usable test framework, and reports the existing setup otherwise. Use in the minimal UI + API pack before implementation.
Test Planner (Minimal)uiapi-min-planner / uiapi_min_plannerTurns the exploration summaries into a short, prioritized test plan (P0 first) written to .ai-outputs/. Use as the planning step of the minimal UI + API pack.

MCP servers

  • playwright: npx @playwright/mcp@latest

Claude Code and Codex start these from the plugin. In GitHub Copilot, the agents that need them configure them themselves.

How the pack works, step by step: GUIDE.md.