reviewer

Validate proposals and generate ADR and PR documentation before implementation.

1|2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill reviewer-parisgroup-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewer
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/skills/reviewer
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill reviewer-parisgroup-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate proposals before implementation and generate ADR/PR documentation to ensure traceability and governance.

Core Features & Use Cases

  • Enforces validation before significant changes, generates ADR/PR artifacts, and provides templates to ensure traceability.
  • Facilitates structured reviews for proposals, architectural decisions, and code changes across workflows.
  • Use case: When planning a major refactor, run reviewer mode to capture decisions, risks, and ADRs.

Quick Start

Activate reviewer mode to start a structured proposal workflow with ADR/PR documentation.

Frequently Asked Questions about reviewer

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

FAQPage Schema
How do I validate architecture proposals before implementation?

You can validate architecture proposals by activating reviewer mode to enforce a structured workflow with templates, checklists, and clear rollback plans before coding begins. This ensures decisions, risks, and requirements are captured and documented.

How do I generate ADR documentation for a major refactoring plan?

To generate ADR documentation for refactoring, run a structured proposal workflow that automatically captures architectural decisions and risks. This produces traceable ADR and PR artifacts to govern the implementation.

What is the best way to enforce structured code reviews for high-risk changes?

The best way to enforce structured code reviews for high-risk changes is to apply a validation workflow with built-in checklists and templates. This guarantees architectural decisions and pull requests follow governance standards before merging.

Can I use a proposal workflow to capture architectural decisions and rollback plans?

Yes, you can use a structured proposal workflow to capture architectural decisions, assess risks, and define a rollback plan. This ensures traceability and governance before implementation begins.

When do I need to document ADRs for feature development?

You need to document ADRs for feature development when planning high-risk changes that require governance and traceability. Generating ADR artifacts before implementation ensures architectural decisions and rollback plans are formally validated.

Does this proposal validation workflow handle both ADR and PR generation?

Yes, the proposal validation workflow handles both ADR and PR generation. By enforcing structured validation before significant changes, it automatically generates both artifacts to ensure full traceability across the development lifecycle.