write-tests

Write Tests Skill

Generate unit tests, integration tests, or end-to-end tests for existing code. Analyzes code structure to produce comprehensive test coverage including happy paths, edge cases, and error scenarios.

Quick Start

Use this skill when:

• User requests test generation (/write-tests)
• Agent detects low coverage for a code block
• User pastes code and asks for tests

Example:

User: "Write tests for the InvitationService.execute method"

AI generates:
- Unit test: happy path — valid invitation created
- Unit test: duplicate email raises ValueError
- Unit test: invalid role raises ValidationError
- Integration test: full create → email dispatch → DB persist flow

Workflow

1. Analyze Target Code

   • Read note content for the code to be tested
   • Search for existing test files via search_note_content
   • Identify: public API surface, dependencies, invariants, error paths

2. Determine Test Strategy

   • Unit tests: mock all external dependencies (repos, queues, email)
   • Integration tests: use real DB session, mock only external APIs
   • Coverage target: >80% per project standard

3. Generate Tests

   • Framework: pytest + pytest-asyncio for async (backend), vitest for frontend
   • Use AsyncMock for async repo/service dependencies
   • Follow AAA pattern: Arrange → Act → Assert
   • Cover: happy path, at least 2 edge cases, error/exception paths
   • No placeholders — all assert statements must have concrete expected values

4. Insert to Note

   • Use insert_block to add test code blocks after the existing code in the note
   • Prepend with ## Generated Tests: <ClassName> heading
   • Include file path comment at top of block

5. Return Suggestion Status

   • Return status: pending_suggestion — user reviews before copying to test file
   • Include coverage estimate in summary

Output Format

{
  "status": "pending_suggestion",
  "skill": "write-tests",
  "blocks_inserted": 2,
  "note_id": "note-uuid",
  "summary": "Generated 8 unit tests + 2 integration tests for InvitationService",
  "estimated_coverage": "92%",
  "test_file_path": "backend/tests/unit/services/test_invitation_service.py"
}