Add missing agents for encode-policy workflow

[hua7450]

Summary

This PR adds four essential agents that are referenced in the /complete:encode-policy workflow but were missing from the policyengine-claude plugin. These agents were copied from the policyengine-us repository's .claude/agents folder.

Agents Added

1. issue-manager.md

Purpose: Finds or creates GitHub issues for program implementations

Key Responsibilities:

• Searches for existing issues related to program implementations
• Creates new issues with proper templates when none exist
• Automatically creates draft PRs for new implementations
• Returns issue numbers and URLs for other agents to reference
• Adds relevant labels (state, program type, implementation-tracking)

Why Critical: Ensures each implementation has a single source of truth issue for documentation and coordination across all agents.

2. naming-coordinator.md

Purpose: Establishes variable naming conventions based on existing patterns

Key Responsibilities:

• Analyzes existing naming patterns in the codebase
• Decides on consistent variable names for new programs
• Documents naming conventions in GitHub issues for all agents to reference
• Analyzes folder structure patterns in the codebase
• Ensures consistency across test and implementation agents

Why Critical: Prevents naming mismatches between parallel development branches and ensures consistency with existing codebase patterns. Referenced by both test-creator and rules-engineer agents.

3. pr-pusher.md

Purpose: Ensures PRs are properly formatted with changelog, linting, and tests before pushing

Key Responsibilities:

• Verifies changelog entry exists and is valid
• Runs formatters (black, isort) to ensure code style compliance
• Checks for and fixes linting issues
• Runs tests locally to catch failures early
• Pushes branches and monitors initial CI results

Why Critical: Catches issues locally before CI runs publicly, reducing iteration time and ensuring code quality standards.

4. legislation-statute-analyzer.md

Purpose: Analyzes legislative text and statutes

Key Responsibilities:

• Identifies key statutes and section numbers
• Analyzes references and cross-references
• Explains statutory relationships and dependencies
• Provides context and legal significance
• Creates structured analysis with proper legal citations

Why Critical: Helps understand complex legislative text when implementing government benefit programs, ensuring accurate interpretation of legal requirements.

Integration with encode-policy Workflow

These agents are invoked at specific phases:

• Phase 1: @complete:issue-manager - Sets up issue and draft PR
• Phase 2: @complete:naming-coordinator - Establishes naming conventions and folder structure
• Phase 6: @complete:pr-pusher - Pre-push validation and formatting
• Ad-hoc: @complete:legislation-statute-analyzer - When legislative analysis is needed

Changes Made

• Added agents/issue-manager.md (241 lines)
• Added agents/legislation-statute-analyzer.md (52 lines)
• Added agents/naming-coordinator.md (211 lines)
• Added agents/pr-pusher.md (243 lines)

All agents follow the existing agent format with frontmatter (name, description, tools, model) and detailed workflow instructions.

Test Plan

• Agents copied from policyengine-us/.claude/agents/
• Frontmatter metadata preserved correctly
• Agent descriptions match their usage in encode-policy.md
• All agent references in encode-policy.md use @complete: prefix
• Files follow same format as existing agents in this repository

Related PR

This PR complements #5 which updates the encode-policy workflow to use @complete: prefixed agent references.

🤖 Generated with Claude Code