Polyglot Test Agent

1---2name: polyglot-test-agent3description: 'Generates comprehensive, workable unit tests for any programming language using a multi-agent pipeline. Use when asked to generate tests, write unit tests, improve test coverage, add test coverage, create test files, or test a codebase. Supports C#, TypeScript, JavaScript, Python, Go, Rust, Java, and more. Orchestrates research, planning, and implementation phases to produce tests that compile, pass, and follow project conventions.'4---5 6# Polyglot Test Generation Skill7 8An AI-powered skill that generates comprehensive, workable unit tests for any programming language using a coordinated multi-agent pipeline.9 10## When to Use This Skill11 12Use this skill when you need to:13- Generate unit tests for an entire project or specific files14- Improve test coverage for existing codebases15- Create test files that follow project conventions16- Write tests that actually compile and pass17- Add tests for new features or untested code18 19## How It Works20 21This skill coordinates multiple specialized agents in a **Research → Plan → Implement** pipeline:22 23### Pipeline Overview24 25```26┌─────────────────────────────────────────────────────────────┐27│                     TEST GENERATOR                          │28│  Coordinates the full pipeline and manages state            │29└─────────────────────┬───────────────────────────────────────┘30                      │31        ┌─────────────┼─────────────┐32        ▼             ▼             ▼33┌───────────┐  ┌───────────┐  ┌───────────────┐34│ RESEARCHER│  │  PLANNER  │  │  IMPLEMENTER  │35│           │  │           │  │               │36│ Analyzes  │  │ Creates   │  │ Writes tests  │37│ codebase  │→ │ phased    │→ │ per phase     │38│           │  │ plan      │  │               │39└───────────┘  └───────────┘  └───────┬───────┘40                                      │41                    ┌─────────┬───────┼───────────┐42                    ▼         ▼       ▼           ▼43              ┌─────────┐ ┌───────┐ ┌───────┐ ┌───────┐44              │ BUILDER │ │TESTER │ │ FIXER │ │LINTER │45              │         │ │       │ │       │ │       │46              │ Compiles│ │ Runs  │ │ Fixes │ │Formats│47              │ code    │ │ tests │ │ errors│ │ code  │48              └─────────┘ └───────┘ └───────┘ └───────┘49```50 51## Step-by-Step Instructions52 53### Step 1: Determine the User Request54 55Make sure you understand what user is asking and for what scope.56When the user does not express strong requirements for test style, coverage goals, or conventions, source the guidelines from [unit-test-generation.prompt.md](unit-test-generation.prompt.md). This prompt provides best practices for discovering conventions, parameterization strategies, coverage goals (aim for 80%), and language-specific patterns.57 58### Step 2: Invoke the Test Generator59 60Start by calling the `polyglot-test-generator` agent with your test generation request:61 62```63Generate unit tests for [path or description of what to test], following the [unit-test-generation.prompt.md](unit-test-generation.prompt.md) guidelines64```65 66The Test Generator will manage the entire pipeline automatically.67 68### Step 3: Research Phase (Automatic)69 70The `polyglot-test-researcher` agent analyzes your codebase to understand:71- **Language & Framework**: Detects C#, TypeScript, Python, Go, Rust, Java, etc.72- **Testing Framework**: Identifies MSTest, xUnit, Jest, pytest, go test, etc.73- **Project Structure**: Maps source files, existing tests, and dependencies74- **Build Commands**: Discovers how to build and test the project75 76Output: `.testagent/research.md`77 78### Step 4: Planning Phase (Automatic)79 80The `polyglot-test-planner` agent creates a structured implementation plan:81- Groups files into logical phases (2-5 phases typical)82- Prioritizes by complexity and dependencies83- Specifies test cases for each file84- Defines success criteria per phase85 86Output: `.testagent/plan.md`87 88### Step 5: Implementation Phase (Automatic)89 90The `polyglot-test-implementer` agent executes each phase sequentially:91 921. **Read** source files to understand the API932. **Write** test files following project patterns943. **Build** using the `polyglot-test-builder` subagent to verify compilation954. **Test** using the `polyglot-test-tester` subagent to verify tests pass965. **Fix** using the `polyglot-test-fixer` subagent if errors occur976. **Lint** using the `polyglot-test-linter` subagent for code formatting98 99Each phase completes before the next begins, ensuring incremental progress.100 101### Coverage Types102- **Happy path**: Valid inputs produce expected outputs103- **Edge cases**: Empty values, boundaries, special characters104- **Error cases**: Invalid inputs, null handling, exceptions105 106## State Management107 108All pipeline state is stored in `.testagent/` folder:109 110| File | Purpose |111|------|---------|112| `.testagent/research.md` | Codebase analysis results |113| `.testagent/plan.md` | Phased implementation plan |114| `.testagent/status.md` | Progress tracking (optional) |115 116## Examples117 118### Example 1: Full Project Testing119```120Generate unit tests for my Calculator project at C:\src\Calculator121```122 123### Example 2: Specific File Testing124```125Generate unit tests for src/services/UserService.ts126```127 128### Example 3: Targeted Coverage129```130Add tests for the authentication module with focus on edge cases131```132 133## Agent Reference134 135| Agent | Purpose | Tools |136|-------|---------|-------|137| `polyglot-test-generator` | Coordinates pipeline | runCommands, codebase, editFiles, search, runSubagent |138| `polyglot-test-researcher` | Analyzes codebase | runCommands, codebase, editFiles, search, fetch, runSubagent |139| `polyglot-test-planner` | Creates test plan | codebase, editFiles, search, runSubagent |140| `polyglot-test-implementer` | Writes test files | runCommands, codebase, editFiles, search, runSubagent |141| `polyglot-test-builder` | Compiles code | runCommands, codebase, search |142| `polyglot-test-tester` | Runs tests | runCommands, codebase, search |143| `polyglot-test-fixer` | Fixes errors | runCommands, codebase, editFiles, search |144| `polyglot-test-linter` | Formats code | runCommands, codebase, search |145 146## Requirements147 148- Project must have a build/test system configured149- Testing framework should be installed (or installable)150- VS Code with GitHub Copilot extension151 152## Troubleshooting153 154### Tests don't compile155The `polyglot-test-fixer` agent will attempt to resolve compilation errors. Check `.testagent/plan.md` for the expected test structure.156 157### Tests fail158Review the test output and adjust test expectations. Some tests may require mocking dependencies.159 160### Wrong testing framework detected161Specify your preferred framework in the initial request: "Generate Jest tests for..."