Conductor Review
conductor-review
Acts as a Principal Software Engineer to review completed or in-progress work against project standards, tech stack choices, and the implementation plan. Use when the user wants a quality check on their code or before finalizing a track.
SKILL.md
Full skill instructions
Conductor Review
Overview
This skill provides a meticulous, first-principles code review. It compares implementation diffs against the "Law" (Style Guides), the "Identity" (Product Guidelines), and the "Mission" (Spec and Plan). It identifies critical bugs, safety risks, and architectural deviations.
When to Use
- When a user says "Review my changes," "Is this track ready?", or "Run a code review."
- Before archiving or deleting a completed track.
Workflow
- Scope Selection: Identify the track or changes to review.
- Context Loading: Retrieve guidelines, style guides, and the track's plan.
- Meticulous Analysis: Perform a deep dive into the diff, checking for intent, style, safety, and security.
- Automated Testing: Run the project's test suite and report results.
- Reporting: Generate a structured Review Report with severity-ranked findings.
- Resolution: Offer to automatically apply fixes and update the implementation plan.
Implementation Details
Refer to the following protocols for detailed procedural instructions:
- Resolution Protocol: references/resolution-protocol.md - How to find Conductor artifacts.
- Review Protocol: references/review-protocol.md - The logic for deep analysis, report generation, and automated fixing.
Mandatory Constraints
- Style is Law: Violations of
conductor/code_styleguides/*.mdare HIGH severity. - Automated Verification: ALWAYS attempt to run existing tests to verify correctness.
- Plan Integrity: If fixes are applied, the
plan.mdMUST be updated to record the review-related tasks and commits.