Agent Protocols - Claude Code Plugins

A Claude Code plugin marketplace providing production-validated protocols, specialized agents, and automation frameworks for systematic AI-assisted software development.

Overview

This marketplace contains 2 plugins with complementary capabilities:

1. Modernize - Complete modernization workflow (assess → plan → execute → improve) with 6 specialized agents
2. Autocoder - Autonomous GitHub issue resolution with intelligent testing and quality automation

Both plugins feature continuous improvement through retrospective analysis and are universally applicable to any software project. Originally created for .NET framework migrations, these tools work with any language or platform.

---

Directory Guide

This repository supports multiple agentic platforms. Please refer to the corresponding directory and documentation for your platform:

Platform	Directory	Documentation
Claude Code	.claude-plugin/	docs/CLAUDE-CODE.md
Antigravity	.agent/	docs/ANTIGRAVITY.md
OpenCode	agents/	docs/OPENCODE.md

Each platform has its own directory structure and installation method. See the platform-specific documentation for details.

---

Installation

Add Marketplace

/plugin add marketplace https://github.com/laird/agents

Install Plugins

Install modernize plugin (software modernization workflows):

/plugin install modernize

Install autocoder plugin (autonomous GitHub issue resolution):

/plugin install autocoder

Install both plugins:

/plugin install modernize autocoder

After installation, commands will be available as slash commands in Claude Code:

• modernize: /assess, /plan, /modernize, /retro, /retro-apply, /modernize-help
• autocoder: /fix, /fix-loop, /stop-loop, /list-proposals, /approve-proposal, /list-needs-design, /list-needs-feedback, /brainstorm-issue, /full-regression-test, /improve-test-coverage, /autocoder-help

Get help anytime:

/modernize-help    # Overview of modernization workflow
/autocoder-help    # Overview of autonomous coding workflow

Recommended Companion Plugins

These plugins enhance the capabilities of modernize and autocoder:

Plugin	Purpose	When to Install
superpowers	Structured problem-solving skills (debugging, planning, verification)	Recommended for complex issues requiring systematic approaches
quint	Structured reasoning for human-guided decision making	Recommended for ultra-complex decisions requiring human judgment

Install recommended plugins:

# superpowers - for complex problem-solving
/plugin install superpowers

# quint - for ultra-complex decisions (https://quint.codes/)
/plugin install quint

How they're used:

• superpowers: Automatically invoked by /fix for complex issues (>10 test failures, multi-file changes, feature implementations). Provides systematic debugging, brainstorming, planning, and verification skills.

• quint: Automatically invoked for ultra-complex issues that exceed autonomous resolution capabilities (>100 test failures, major architecture decisions, irreversible consequences). Guides structured reasoning with human collaboration.

If these plugins are not installed, the workflows use direct problem-solving approaches instead.

---

Antigravity Support

This repository is Antigravity-native. It includes the .agent/ directory containing all agent rules and workflows, making it compatible with the Antigravity engine out of the box.

Quick Install (One-Liner)

Run this command from your project's root directory:

curl -sSL https://raw.githubusercontent.com/laird/agents/main/scripts/install.sh | bash

This fetches only the .agent/ directory and installs it into your project.

Note

Cross-Platform Compatibility

• Linux/macOS: Works natively
• Windows: Requires Git Bash or WSL

Manual Installation

Alternatively, copy or symlink the .agent/ directory:

# Option 1: Copy
cp -r /path/to/agents/.agent /your/project/

# Option 2: Symlink (for development)
ln -s /path/to/agents/.agent /your/project/.agent

Available Workflows

After installation, these workflows are available:

Modernize Workflows:

Workflow	Description
/assess	Evaluate modernization viability
/plan	Create execution strategy
/modernize	Execute multi-phase modernization
/retro	Analyze project for improvements
/retro-apply	Apply retrospective findings
/modernize-help	Show modernize workflow help

Autocoder Workflows:

Workflow	Description
/fix	Autonomous issue resolution
/fix-loop	Continuous autonomous resolution
/stop-loop	Stop the continuous loop
/list-proposals	View pending AI-generated proposals
/approve-proposal	Approve a proposal for implementation
/list-needs-design	List issues needing design work
/list-needs-feedback	List issues needing feedback
/brainstorm-issue	Brainstorm design for an issue
/full-regression-test	Run comprehensive test suite
/improve-test-coverage	Analyze and improve test coverage
/autocoder-help	Show autocoder workflow help

Warning

The watchdog scripts in .agent/scripts/ are experimental. See docs/ANTIGRAVITY.md for details.

---

Plugins

Plugin 1: Modernize

Complete modernization workflow with multi-agent orchestration.

Get help: /modernize-help

6 Protocol-Based Commands

Each command is a comprehensive protocol document (.md file) containing agent coordination, workflows, quality gates, and best practices:

• /assess - Assessment protocol with viability evaluation (outputs ASSESSMENT.md)

  • 8 assessment dimensions, scoring methodology, recommendation matrix
  • Do this first to assess software for potential modernization

• /plan - Planning protocol with detailed execution strategy (outputs PLAN.md)

  • Phase breakdown, timeline estimation, risk management, resource allocation
  • Do this to propose a modernization plan

• /modernize - Full modernization protocol with 7-phase workflow

  • Coordinates 6 specialist agents through Discovery → Security → Architecture → Framework → API → Performance → Documentation
  • Do this to execute the plan. If there is no plan it will generate a plan and then execute it.

• /retro - Retrospective protocol analyzing project history (outputs IMPROVEMENTS.md)

  • Reviews git history, user corrections, agent mistakes, protocol inefficiencies
  • Do this after execution to assess how the project went and make improvement recommendations for future projects. This is optional.

• /retro-apply - Improvement application protocol

  • Systematically updates commands, protocols, and automation based on retrospective findings
  • Do this after /retro if you agree with the recommendations.

Quick Start

1. Assess Viability

   /assess
   

   Evaluates technical debt, risks, and ROI. Outputs ASSESSMENT.md.

2. Create Plan

   /plan
   

   Develops detailed execution strategy with phases, timeline, and resources. Outputs PLAN.md.

3. Execute Modernization

   /modernize
   

   Orchestrates specialized agents through 7 phases:

   • Discovery & Planning
   • Security Assessment
   • Architecture Decisions
   • Framework Upgrade
   • API Modernization
   • Performance Optimization
   • Documentation

4. Continuous Improvement (Optional)

   /retro
   

   After project completion, analyzes history to identify process improvements. Reviews:

   • User interruptions and corrections
   • Agent behavioral issues (wrong tools, wasted effort)
   • Protocol inefficiencies
   • Automation opportunities

   Outputs IMPROVEMENTS.md with 3-5 evidence-based recommendations.

5. Apply Improvements

   /retro-apply
   

   Systematically applies approved recommendations from IMPROVEMENTS.md:

   • Updates command files with better agent behavior guidance
   • Modifies protocols to prevent recurring issues
   • Adds automation (scripts, hooks, CI/CD)
   • Embeds lessons learned into workflow

Specialist Agents

The modernize plugin includes 6 specialized agents invoked by Claude Code's Task tool:

• Architect makes technology decisions and creates ADRs
• Security scans for vulnerabilities and blocks on CRITICAL/HIGH issues
• Coder implements migrations and fixes
• Tester validates with comprehensive test suites (100% pass rate required)
• Documentation generates user-facing guides and changelogs
• Migration Coordinator orchestrates multi-stage workflows

---

Plugin 2: Autocoder

Autonomous GitHub issue resolution with intelligent testing, quality automation, and human-in-the-loop proposal system.

Get help: /autocoder-help

Commands by Category

Issue Resolution:

Command	Description
/fix [number]	Fix a specific issue or highest priority issue
/fix-loop	Run continuous autonomous resolution
/stop-loop	Stop the continuous loop

Design & Brainstorming:

Command	Description
/brainstorm-issue [number]	Brainstorm design for an issue using available skills
/list-needs-design	List issues requiring design/architecture work
/list-needs-feedback	List issues requiring human feedback

Proposal Management:

Command	Description
/list-proposals	View pending AI-generated proposals
/approve-proposal <number>	Approve a proposal for implementation

Testing & Quality:

Command	Description
/full-regression-test	Run comprehensive test suite
/improve-test-coverage	Analyze and improve test coverage

Setup:

Command	Description
/install-stop-hook	Install hook for loop control
/autocoder-help	Show help and workflow overview

Workflow Patterns

Pattern 1: One-Shot Issue Resolution

/fix 123      # Fix specific issue
/fix          # Fix highest priority issue

Pattern 2: Continuous Autonomous Mode

/install-stop-hook   # First time only
/fix-loop     # Run continuously until /stop-loop

Pattern 3: Design-First Workflow

/list-needs-design           # Find issues needing design
/brainstorm-issue 45         # Explore design options
# Review results on GitHub
/fix 45               # Implement after design approval

Pattern 4: Proposal Review

/list-proposals              # See AI-generated proposals
/approve-proposal 67         # Approve for implementation
/fix                  # Implements approved proposals

Priority & Label System

Priority Labels (P0-P3):

• P0: Critical - system down, security, data loss
• P1: High - major feature broken, no workaround
• P2: Medium - partial breakage, workaround exists
• P3: Low - minor, cosmetic, nice-to-have

Workflow Labels:

• proposal - AI-generated, awaiting human approval
• needs-design - Requires architecture/design work
• needs-feedback - Requires human clarification
• enhancement - Feature improvement
• test-failure - Created from test failure

Human-in-the-Loop Proposal System

AI-generated enhancements are tagged with proposal label and require human approval:

1. Review: /list-proposals shows all pending proposals
2. Approve: /approve-proposal <number> enables implementation
3. Feedback: Comment on GitHub issue, then /brainstorm-issue <number>
4. Reject: Close the issue with explanation

Proposals are never auto-implemented - you control what gets built.

Quick Start

# Get help
/autocoder-help

# Start fixing issues
/fix

# Or run continuously
/install-stop-hook
/fix-loop

First Run: Auto-creates configuration in your CLAUDE.md:

## Automated Testing & Issue Management

### Regression Test Suite
```bash
npm test

Build Verification

npm run build

Customize these commands for your project's test framework.

---
## Repository Structure
---

agents/
├── .agent/                              # Antigravity agent configuration (rules, workflows)
├── .claude-plugin/                      # Claude Code plugin configuration
│   ├── marketplace.json                 # Marketplace metadata (2 plugins)
│   └── plugins/
│       ├── modernize/
│       │   └── plugin.json              # Modernize plugin definition
│       └── autocoder/
│           └── plugin.json              # Autocoder plugin definition
├── plugins/                             # Plugin implementations
│   ├── modernize/                       # Modernize plugin (6 commands, 6 agents, protocols)
│   │   ├── commands/
│   │   │   ├── help.md                 # Plugin help and workflow overview
│   │   │   ├── assess.md               # Assessment protocol
│   │   │   ├── plan.md                 # Planning protocol
│   │   │   ├── modernize.md            # Full modernization workflow
│   │   │   ├── retro.md                # Retrospective analysis
│   │   │   └── retro-apply.md          # Improvement application
│   │   ├── agents/
│   │   │   ├── architect.md            # Technology decisions and ADRs
│   │   │   ├── coder.md                # Implementation and fixes
│   │   │   ├── documentation.md        # User-facing guides
│   │   │   ├── migration-coordinator.md # Multi-stage orchestration
│   │   │   ├── security.md             # Vulnerability scanning
│   │   │   └── tester.md               # Comprehensive testing
│   │   └── protocols/                   # Protocol documentation (10 protocols)
│   │       ├── 00-PROTOCOL-INDEX.md    # Protocol index
│   │       ├── adr-lifecycle.md        # ADR lifecycle protocol
│   │       ├── agent-logging.md        # Agent logging protocol
│   │       ├── agents-overview.md      # Agents overview
│   │       ├── documentation-plan.md   # Documentation planning
│   │       ├── documentation-protocol.md # Documentation protocol
│   │       ├── incremental-documentation.md # Incremental docs
│   │       ├── protocols-overview.md   # Protocols overview
│   │       ├── security-scanning-protocol.md # Security scanning
│   │       └── testing-protocol.md     # Testing protocol
│   └── autocoder/                         # Autocoder plugin (12 commands)
│       ├── commands/
│       │   ├── help.md                 # Plugin help and workflow overview
│       │   ├── fix.md           # Autonomous issue resolution
│       │   ├── fix-loop.md      # Continuous autonomous resolution
│       │   ├── stop-loop.md            # Stop the continuous loop
│       │   ├── list-proposals.md       # View pending proposals
│       │   ├── approve-proposal.md     # Approve a proposal
│       │   ├── list-needs-design.md    # List issues needing design
│       │   ├── list-needs-feedback.md  # List issues needing feedback
│       │   ├── brainstorm-issue.md     # Brainstorm design for an issue
│       │   ├── full-regression-test.md # Run comprehensive test suite
│       │   ├── improve-test-coverage.md # Analyze and improve coverage
│       │   └── install-stop-hook.md    # Install hook for loop control
│       ├── agents/
│       │   ├── architect.md            # Technology decisions and ADRs
│       │   ├── coder.md                # Implementation and fixes
│       │   ├── documentation.md        # User-facing guides
│       │   ├── migration-coordinator.md # Multi-stage orchestration
│       │   ├── security.md             # Vulnerability scanning
│       │   └── tester.md               # Comprehensive testing
│       └── scripts/
│           └── regression-test.sh      # Full test suite with GitHub integration
└── README.md

Structure Notes:

• Parallel plugin architecture: Each plugin has its own commands/, agents/, and scripts/
• Complete separation: Plugins are independent and can be installed individually
• Shared agent definitions: Both plugins include the same 6 specialized agents (architecture, coder, documentation, migration-coordinator, security, tester)
• Self-contained: Each plugin can evolve independently without affecting the other

---

Key Features

Production-Validated Protocols

• ✅ Proven results - Successfully guided 32/32 project migrations
• ✅ Universal applicability - Works with any software project, not just .NET
• ✅ Complete audit trail - HISTORY.md logging for all agent activities
• ✅ Quality gates - Automated validation at each stage
• ✅ Evidence-based evolution - Protocols continuously improved through retrospective analysis

Multi-Agent Coordination

• 🤖 6 specialized agents - Each with defined capabilities and responsibilities
• 🔄 Parallel execution - Multiple agents work independently on separate tasks
• 📊 Enforced quality - 100% test pass rate, security score ≥45/100
• 📝 Systematic workflows - 7-phase migration, 6-phase testing, 8-stage ADR lifecycle

Continuous Improvement

• 🔍 Retrospective analysis - Analyzes git history, user corrections, agent mistakes
• 📈 Evidence-based recommendations - 3-5 specific improvements with quantified impact
• 🔧 Automated application - Updates commands, protocols, and automation
• 🎯 Learning from mistakes - Identifies wrong tool usage, wasted effort, requirement misunderstandings
• ♻️ Self-improving system - Each project makes the next one better
• ⏱️ Measurable impact - Recent improvements saved 27 hours per project

Real-World Results

• 32/32 projects migrated successfully (100% success rate)
• 100% test pass rate (meets requirement)
• Security improvement from 0/100 → 45/100 (CRITICAL CVEs eliminated)
• Zero P0/P1 blocking issues in production
• 1,500+ lines of documentation auto-generated

Recent Protocol Improvements (Nov 2025)

Based on retrospective analysis of RawRabbit modernization, 5 evidence-based improvements were implemented:

1. Front-Load Test Environment Setup ⚡

   • Phase 0 test setup now mandatory before any work begins
   • Verified baseline metrics (build, tests, vulnerability scan) replace estimates
   • Prevents "works on my machine" issues discovered too late

2. Spike-Driven ADR Process 🧪

   • New Stage 2.5 for high-risk architectural decisions
   • Requires empirical validation via spike branches before commitment
   • 24-48hr stakeholder review period enforced
   • Better decisions through evidence vs. desk research

3. Shift Security Validation Left 🔒

   • New automated security scanning protocol
   • Phase 0 baseline scan, continuous monitoring throughout project
   • Security scores calculated from actual scans, never estimated
   • Critical/High CVEs blocked earlier in workflow

4. Continuous Testing Strategy ✅

   • Testing after EVERY stage, not delayed until Stage 4
   • Tiered testing: Unit → Component → Integration → Performance
   • Estimated 7 hours saved per project from early issue detection
   • Issues found in Stage 1 vs Stage 4 dramatically cheaper to fix

5. Incremental Documentation 📝

   • Status marker system: ⚠️ In Progress → ✅ Fixed (validated) → 📝 Documented
   • "Fixed" claims only after test validation passes
   • Prevents aspirational documentation requiring corrective commits
   • Accurate HISTORY.md audit trail

Combined Impact: 27 hours saved per project, earlier issue detection, verified (not estimated) security posture, empirical architectural decisions, and accurate documentation.

---

Best Practices

Modernization Workflow:

1. /assess → /plan → /modernize → /retro → /retro-apply
2. Monitor HISTORY.md for complete audit trail
3. Review IMPROVEMENTS.md and apply approved changes
4. Next project benefits from lessons learned

Quality Gates:

• Security score ≥45 before migration starts
• Build success 100% before next stage
• Test pass rate 100% before proceeding
• All P0/P1 issues resolved before release

Autocoder Workflow:

1. Run /autocoder-help to see all available commands
2. Run /fix to start autonomous issue resolution
3. Use /list-needs-design and /brainstorm-issue for complex issues
4. Review proposals with /list-proposals and approve with /approve-proposal
5. For continuous operation: /install-stop-hook then /fix-loop

---

Use Cases

• Framework Upgrades - .NET, Node.js, Python, Java, etc.
• Cloud Migrations - AWS, Azure, GCP platform changes
• Language Migrations - Java to Kotlin, JavaScript to TypeScript
• Database Migrations - SQL to NoSQL, version upgrades
• Legacy Modernization - Monolith to microservices, API updates
• Security Remediation - CVE scanning and vulnerability fixes
• Quality Assurance - Comprehensive testing and validation
• Documentation - Technical docs, migration guides, ADRs

---

Version History

Version	Date	Changes
3.4.0	2026-01-24	Autocoder v3.0.0: Renamed /fix-github → /fix, /fix-github-loop → /fix-loop. Added design workflow commands (/list-needs-design, /list-needs-feedback, /brainstorm-issue). Added help commands (/autocoder-help, /modernize-help). Updated README with workflow patterns.
3.3.0	2025-12-29	Proposal system & triage: AI-generated enhancements now require human approval via proposal label. Added /list-proposals command, unprioritized issue triage, platform documentation (CLAUDE-CODE.md, ANTIGRAVITY.md, OPENCODE.md). All platforms updated to consistent v1.5.0
3.0.0	2025-11-24	Added autocoder plugin: Autonomous GitHub issue resolution with /fix command. Self-configuring via CLAUDE.md, works with any test framework. Includes regression-test.sh script with GitHub integration. Marketplace now contains 2 plugins (modernize + autocoder)
2.6.0	2025-11-09	Applied 5 evidence-based improvements from RawRabbit retrospective: front-load test setup, spike-driven ADRs, shift security left, continuous testing, incremental documentation. Impact: 27 hours saved per project
2.5.0	2025-11-01	Added continuous improvement workflow: /retro and /retro-apply commands for retrospective analysis and automated application of lessons learned
2.4.2	2025-10-28	Renamed /modernize:project to /modernize, removed agents/protocols/scripts in favor of streamlined commands
2.4.1	2025-10-25	Removed cost estimates, added time estimate disclaimers
2.4.0	2025-10-25	Added complete modernization workflow (assess → plan → execute)
2.3.0	2025-10-25	Added /modernize-project multi-agent orchestrator
2.2.0	2025-10-25	Restructured as Claude Code plugin
1.0	2025-10-10	Initial release with protocols and agent definitions

---

References

• Repository: https://github.com/laird/agents
• MADR 3.0.0: https://adr.github.io/madr/ - ADR format specification
• Keep a Changelog: https://keepachangelog.com/ - CHANGELOG format
• Claude Code Docs: https://docs.claude.com/en/docs/claude-code/

---

License

MIT License - See repository for details

---

Status: Production-validated Applicability: Universal (all software projects) Original Context: .NET Framework Migration Maintained By: AI-assisted development community