opencode-sample-validator

AWS sample validation workflow plugin for OpenCode. Runs a comprehensive 9-phase validation pipeline on AWS sample projects — from deep exploration through deployment, security scanning, and final reporting.

Install

One command sets everything up:

bunx opencode-sample-validator setup --project

This does two things:

1. Adds opencode-sample-validator to your opencode.json plugin array (OpenCode auto-installs npm plugins at startup)
2. Copies command files to .opencode/commands/ for slash command access

Restart OpenCode after running setup.

Global install

To install globally (available in all projects):

bunx opencode-sample-validator setup

Commands

| Command | Description | |---------|-------------| | /validation-start [path] | Start the validation workflow on a sample project | | /validation-status | Check current phase and progress | | /validation-stop | Stop after the current phase finishes | | /validation-resume [path] | Resume a stopped workflow |

Validation Phases

The orchestrator runs automatically after /validation-start. Each phase creates a child session with fresh context:

1. Deep Exploration - Systematic 5-phase codebase analysis
2. Suitability Check - Gate validation (APPROVE/REJECT)
3. Deployment Plan - Generate plan from README and exploration
4. Plan Validation - Validate plan against rules, fix violations
5. Execution - Step-by-step deployment with retries
6. Validation Report - Compile deployment results
7. Security Scan - Vulnerability scanning
8. Code Quality - Best practices assessment
9. Final Report - Comprehensive report aggregation

How It Works

The plugin registers tools (start_validation, validation_status, etc.) and hooks that drive the workflow. When you call /validation-start:

1. Creates .validation/sessions/<id>/reports/ with a state.json
2. Spawns a child session for Phase 1
3. Uses session.idle events to detect phase completion
4. Automatically advances through all phases
5. Handles the execute phase's step loop with retries

Reports are generated in .validation/sessions/<id>/reports/:

• executive-summary.md - Quick overview
• final-report.md - Comprehensive details
• summary.json - Structured data

Plugin Architecture

| Mechanism | How it works | |-----------|-------------| | Tools | Registered in src/index.ts, loaded via opencode.json plugin array | | Skills | SKILL.md files auto-discovered from the npm package | | Commands | Copied to .opencode/commands/ by the setup script | | Hooks | File write detection and session.idle event handling |

Development

bun install
bun run build
bun test

License

MIT