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.