build-review-md

REVIEW.md Builder

Guided wizard that creates a REVIEW.md configuration tailored to the repo's actual languages, frameworks, and priorities. Produces a root REVIEW.md and subdirectory configs only when the multi-stack test justifies them.

This skill produces configuration files, not code review. Do not run review agents or analyze code for bugs. Stay in configuration mode until exit.

Step 1: Detect

Scan the repository to understand what you are configuring. Do this silently — do not ask the user to describe their stack.

Languages — scan file extensions:

• .ts, .tsx → TypeScript/React
• .js, .jsx → JavaScript
• .py → Python
• .go → Go
• .rs → Rust
• .cs → C#/.NET
• .java → Java
• .rb → Ruby
• .php → PHP

Frameworks and runtimes — check for manifest files:

• package.json → Node/JS/TS ecosystem; read dependencies and devDependencies for React, Next.js, Vue, Express, NestJS, RTK Query, Zod, Vitest, Jest
• requirements.txt / pyproject.toml / setup.py → Python; check for Django, FastAPI, SQLAlchemy, pytest
• Cargo.toml → Rust; check for tokio, axum, sqlx
• go.mod → Go; check for gin, echo, gorm
• pom.xml / build.gradle → Java/Kotlin; check for Spring Boot, Hibernate
• *.csproj / *.sln → .NET; check for ASP.NET Core, EF Core, xUnit, NUnit
• Gemfile → Ruby on Rails

Multi-stack / mono-repo detection — a repo is multi-stack when it contains multiple package manifest files in different subdirectories (e.g., frontend/package.json AND backend/*.csproj). Record the subdirectory paths.

Existing REVIEW.md — check whether a root REVIEW.md already exists. If it does, announce what you found and ask:

AskUserQuestion(
  questions: [{
    question: "A REVIEW.md already exists at the repo root. What would you like to do?",
    header: "REVIEW.md",
    multiSelect: false,
    options: [
      { label: "Extend it (Recommended)", description: "Add rules to what's already there, keeping existing settings" },
      { label: "Start fresh", description: "Replace it with a newly generated REVIEW.md" },
      { label: "Cancel", description: "Keep the existing file unchanged and exit" }
    ]
  }]
)