examples: Skill for Claude Code

flowchart TD
    START(["/orchestrate:tests"]) --> READ["Read plan"]:::orch
    READ --> DETECT["Detect test framework"]:::orch
    DETECT --> CONFIG["Create test config"]:::orch
    CONFIG --> CRITICAL["Identify critical paths"]:::orch
    CRITICAL --> WRITE["Write initial tests"]:::orch
    WRITE --> BRANCH["Create branch"]:::orch
    BRANCH --> SIZE{Under 700 lines?}
    SIZE -->|Yes| PR["Commit + open PR"]:::orch
    SIZE -->|No| SPLIT["Split into sub-PRs"]:::orch
    SPLIT --> PR
    PR --> DONE([Phase complete])

    classDef orch fill:#FF9800,stroke:#333,color:white

Follow this diagram as the workflow.

Orchestrate: Tests

Add test infrastructure and initial test coverage. This is Phase 3 and produces PR #2. Tests come before CI and security — good test coverage is a safety net for the code refactoring that security/quality fixes require.

When to Use

• After orchestrate:plan identifies tests as a needed phase
• After precommit phase (linting is the foundation)

Prerequisites

• Plan exists with tests phase
• Target repo in .repos/<target>/

Step 1: Detect Test Framework

Marker	Language	Framework	Assertion
pyproject.toml	Python	pytest	built-in assert
go.mod	Go	testing (stdlib)	testify
package.json	Node	jest or vitest	built-in expect
requirements.yml	Ansible	molecule	testinfra

Check existing tests:

find .repos/<target> -type f \( -name "test_*.py" -o -name "*_test.go" -o -name "*.test.*" \) 2>/dev/null

Step 2: Create Test Configuration

Python

• tests/conftest.py — shared fixtures
• tests/__init__.py — package marker
• pyproject.toml — add [tool.pytest.ini_options] with testpaths = ["tests"]

Go

• *_test.go files alongside source
• testdata/ for fixtures
• internal/testutil/ for shared helpers

Node

• jest.config.ts or vitest.config.ts at root
• __tests__/ directory or *.test.ts alongside source