steering-matcher

Steering File Matcher Skill

Purpose

This skill helps orchestrator determine which steering files to inject into agent context based on the files being modified.

• Match file paths against glob patterns in steering file front matter
• Return applicable steering files sorted by priority
• Enable token-efficient context injection (30%+ savings)

When to Use

Invoke this skill when you need to:

• Determine which steering guidance applies to a task
• Inject context-aware guidance into agent prompts
• Optimize token usage by scoping guidance to relevant files
• Match files against applyTo patterns in steering files

Quick Usage

Using Get-ApplicableSteering.ps1 Script

The script in .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 handles pattern matching.

# Match files against steering patterns
$files = @(
    "src/claude/analyst.md",
    ".agents/security/TM-001-auth-flow.md"
)

$steering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
    -Files $files `
    -SteeringPath ".agents/steering"

# Output: Array of hashtables with Name, Path, ApplyTo, Priority
foreach ($s in $steering) {
    Write-Host "Matched: $($s.Name) (Priority: $($s.Priority))"
}

Workflow Integration

This skill integrates with the orchestrator workflow:

1. Task Analysis: Orchestrator identifies files affected by task
2. Pattern Matching: Use this skill to find applicable steering
3. Context Injection: Include matched steering in agent prompt
4. Token Optimization: Only inject relevant guidance

Standard Orchestrator Workflow

# 1. Identify files from task
$filesAffected = @(
    "src/claude/security.md",
    ".agents/security/SR-001-oauth-review.md"
)

# 2. Get applicable steering
$applicableSteering = pwsh .claude/skills/steering-matcher/Get-ApplicableSteering.ps1 `
    -Files $filesAffected

# 3. Inject into agent context
# "Relevant steering: agent-prompts.md (Priority 9), security-practices.md (Priority 10)"

Implementation

See Get-ApplicableSteering.ps1 for the PowerShell implementation.

Testing

Run Pester tests to verify pattern matching:

Invoke-Pester .claude/skills/steering-matcher/tests/Get-ApplicableSteering.Tests.ps1

Related

• Steering System README
• Enhancement Project Plan
• Orchestrator Agent