PHPStan Fixer Skill

This skill analyzes EXISTING PHPStan error logs and implements fixes. It does NOT run PHPStan.

Agent Delegation Strategy

This skill delegates to the php-qa-ci_phpstan-fixer agent (sonnet model).

Workflow

When User Says: "Fix the PHPStan errors"

1. Launch fixer agent:

`` Use Task tool: description: "Fix PHPStan errors" subagenttype: "php-qa-ciphpstan-fixer" prompt: "Find and fix errors in most recent PHPStan log" ``

1. Receive fixer output with:

- Errors found and grouped by pattern - Fixes applied - Files modified

1. If no log found:

- Suggest using phpstan-runner skill to generate log first

When User Provides Specific Log Path

1. Launch fixer agent with explicit log path:

`` Use Task tool: description: "Fix PHPStan errors from log" subagenttype: "php-qa-ciphpstan-fixer" prompt: "Fix errors in log: {userprovidedpath}" ``

Escalation Triggers

Launch opus model or ask human when:

• Fixer agent reports architecture questions (type hierarchies, design patterns)
• Same error pattern persists after 2 fix attempts
• User asks for explanation rather than fixes

Fixer Agent Reference

The phpstan-fixer agent (sonnet model) handles:

• Auto-discovery of most recent PHPStan log
• Error parsing and pattern grouping
• Fix implementation for common PHPStan patterns
• Reporting which files were changed

See .claude/agents/php-qa-ci_phpstan-fixer.md for agent implementation details.

When to Use This Skill vs phpstan-runner

• Use phpstan-fixer when:

- PHPStan was already run manually - You have a specific log file to analyze - You only want to analyze/fix, not run analysis

• Use phpstan-runner when:

- You want to run PHPStan AND fix errors - You want the full run→fix→run cycle - PHPStan hasn't been run yet