test-consult

created	"2025-12-16T00:00:00.000Z"
modified	"2026-05-09T00:00:00.000Z"
reviewed	"2026-04-25T00:00:00.000Z"
allowed-tools	Task, Read, Glob, Grep
args	<topic> [--context <path>]
argument-hint	<topic> [--context <path>]
description	Consult the test-architecture agent for strategy decisions. Use when asking about coverage gaps, test pyramid, framework selection, flaky-test remediation, or how to test X.
name	test-consult

When to Use This Skill

Use this skill when...	Use test-tier-selection instead when...
Asking strategic "how should we test X?" questions	Mechanically picking unit vs integration vs E2E for a change
Designing the test approach for a new feature	Running the actual tests (use test-run, test-quick, test-full)
Diagnosing flaky-test root causes	Setting up a fresh project's test infrastructure (use test-setup)
Reviewing pyramid balance or coverage gaps	Triaging concrete failing-test output (use test-analyze)

Context

Explicit command to consult the test-architecture agent for strategic testing decisions.

Use when:

• Creating tests for NEW features
• Test strategy needs adjustment
• Coverage gaps identified
• Flaky tests detected
• Framework selection questions

Topics

Topic	What it covers
coverage	Analyze gaps, recommend high-value tests to write
strategy	Review overall test architecture and pyramid
framework	Recommend testing tools for tech stack
flaky	Diagnose and remediate flaky tests
pyramid	Analyze test tier distribution
new-feature	Design test approach for new functionality
(free text)	Custom question about testing

Parameters

• $1: Topic keyword or natural language question
• --context <path>: Focus analysis on specific directory

Behavior

1. Gather Project Context:

   • Find test directories and structure
   • Detect frameworks in use (pytest, vitest, playwright, etc.)
   • Read coverage reports if available
   • Check recent test failures

2. Delegate to test-architecture Agent:

   • Provide gathered context
   • Include specified topic
   • Request actionable recommendations

3. Present Recommendations:

   • Strategic advice
   • Specific action items
   • Offer to create issues/tasks

Examples

# Coverage analysis
/test:consult coverage

# New feature testing strategy
/test:consult new-feature --context src/auth/

# Framework decision
/test:consult "Should we add property-based testing?"

# Flaky test investigation
/test:consult flaky

# Custom question
/test:consult "How should we structure tests for our API endpoints?"

Agent Delegation

This command delegates to the test-architecture agent with:

• Project test structure analysis
• Coverage data (if available)
• Specified topic/question
• Context path (if provided)

The agent will provide:

• Strategic recommendations
• Specific actionable items
• Trade-off analysis
• Implementation guidance