cto-plan-reviewer

Review execution plans for architectural issues and tech debt before implementation.

2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/AhmedElhadarey/Gilfoyle --skill cto-plan-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cto-plan-reviewer
Source: https://github.com/AhmedElhadarey/Gilfoyle/tree/main/skills/cto-plan-reviewer
Command: npx skills add https://github.com/AhmedElhadarey/Gilfoyle --skill cto-plan-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This agent provides CTO-level technical review of execution plans to identify architectural risks, ensure design decisions align with standards, and prevent tech debt from accumulating during planning.

Core Features & Use Cases

  • Architecture Review: Evaluate design decisions, system boundaries, and ADR alignment.
  • Tech Debt Assessment: Identify potential debt and mitigation plans before coding.
  • Technology Evaluation: Assess new tools and integration complexity, cost implications.
  • Engineering Excellence: Validate testing strategy, observability requirements, and security considerations.
  • Team & Process alignment: Ensure knowledge distribution, onboarding impact, and documentation needs.

Quick Start

Invoke the CTO plan reviewer on a track by running claude /cto-advisor to load plan.md, spec.md, and related artifacts for an architecture-focused evaluation.

Frequently Asked Questions about cto-plan-reviewer

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

FAQPage Schema
How do I review an architecture plan for technical debt before implementation?

You can identify architectural issues and potential debt early by performing a CTO-level technical review of execution plans before implementation, evaluating design decisions, system boundaries, and ADR alignment.

What does a CTO-level technical plan review evaluate?

A CTO-level technical plan review evaluates design decisions, system boundaries, and ADR alignment, while also assessing new tools, integration complexity, testing strategy, observability requirements, and security considerations.

How do I run an architecture evaluation on a track using claude?

To run an architecture evaluation, invoke the reviewer manually via claude /cto-advisor, which automatically loads the track's plan.md, spec.md, and related artifacts for an architecture-focused evaluation.

When should I perform an architecture review of my execution plan?

You should perform an architecture review automatically during Step 2 Evaluate Plan for tracks involving architecture decisions, integrations, or infrastructure changes, ensuring tech debt mitigation before coding begins.

What inputs are needed to assess integration complexity and tech debt?

Assessing integration complexity and tech debt requires inputs including the track's plan.md, spec.md, conductor/tech-stack.md, conductor/product.md, and the current codebase to produce a structured technical review report.

Can I evaluate team and process alignment during an architecture plan review?

Yes, an architecture plan review validates engineering excellence while ensuring knowledge distribution, onboarding impact, and documentation needs are met to align team and process requirements.