Longtermsupport PHP QA CI Phpstan Fixer

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"
     subagent_type: "php-qa-ci_phpstan-fixer"
     prompt: "Find and fix errors in most recent PHPStan log"
   

2. Receive fixer output with:

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

3. 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"
     subagent_type: "php-qa-ci_phpstan-fixer"
     prompt: "Fix errors in log: {user_provided_path}"
   

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.