perfectcode-zen-evaluation

Evaluate software implementations against plans in .opencode/plans/ and generate scored reports.

11|2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill perfectcode-zen-evaluation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: perfectcode-zen-evaluation
Source: https://github.com/the-perfect-developer/the-perfect-opencode/tree/main/.opencode/skills/perfectcode-zen-evaluation
Command: npx skills add https://github.com/the-perfect-developer/the-perfect-opencode --skill perfectcode-zen-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured evaluation workflow that audits a completed software implementation against its written plan in .opencode/plans/, and produces a scored report with concrete improvement suggestions.

Core Features & Use Cases

  • Orchestrated evaluation by multiple evaluators to assess plan fidelity, code quality, test coverage, and architectural integrity.
  • Plan-driven comparison that loads the plan, surveys the actual implementation, and surfaces gaps, deviations, and concrete improvement actions.
  • Use Case: After a Zen build cycle or a PR review, trigger an independent evaluation to validate plan alignment and surface actionable feedback for the team.

Quick Start

Trigger the zen evaluation workflow after a Zen build completes to generate a comprehensive evaluation report.

Frequently Asked Questions about perfectcode-zen-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate code implementation against a written plan?▼

Plan-driven code evaluation requires a written plan document stored in .opencode/plans/ and a completed software implementation to survey. The evaluation workflow uses these inputs to apply domain-specific criteria and produce a scored, multi-dimension report highlighting gaps and deviations.

What is the best way to audit code quality after a build cycle?▼

Evaluating a Zen build compares the completed implementation against its written plan in .opencode/plans/ to validate alignment. It orchestrates multiple evaluators to score code quality and test coverage, producing actionable feedback for PR reviews or post-build validation.

How does automated code review handle plan fidelity and test coverage?▼

Automated code review handles plan fidelity and test coverage by applying an evaluation workflow that loads the plan and surveys the actual implementation. It uses domain-specific criteria to score multi-dimension results and surface gaps, deviations, and concrete improvement actions.

Can I generate a scored evaluation report for a software engineering project?▼

Yes, you can generate a scored evaluation report for a software engineering project by triggering a structured evaluation workflow. It requires plan content and an implementation survey to assess architectural integrity and produce actionable, multi-dimension results with improvement suggestions.