archflow-agent-code-reviewer

Reviews code for quality, security, and design-system compliance with a PASS or FAIL verdict.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-agent-code-reviewer-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-agent-code-reviewer
Source: https://github.com/AZidan/archflow/tree/main/adapters/generic/.agents/skills/archflow-agent-code-reviewer
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-agent-code-reviewer-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code produced by engineering agents can drift from architecture, introduce security flaws, or violate the project's design system, and findings shared only in chat disappear when context is compacted. This Skill performs a structured review of code changes and records every finding durably in files. ## Core Features & Use Cases - Multi-Dimensional Review: Assesses code quality, anti-patterns, performance, security vulnerabilities, and adherence to SOLID principles, categorized by severity from Critical to Low. - Design System Gate: Reads .archflow/design-system.yaml and treats its anti-patterns section as a blocking checklist, failing the review on any violation with file, line, and the correct token or component to use. - Persistent Issue Tracking: Writes every finding into the story's issues[] in the active release YAML and produces docs/code-review-report.md opening with a VERDICT: PASS or VERDICT: FAIL line. - Use Case: After a ui-engineer agent implements a feature in Phase 4, invoke this role to review the diff against the design system and architecture, then route blocking findings back to the implementing agent. ## Quick Start Review the code changes from the current story against the design system and write the verdict report to docs/code-review-report.md.

Frequently Asked Questions about archflow-agent-code-reviewer

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

FAQPage Schema
How do I review AI-generated code for quality and security issues?

Invoke this role on the diff produced by an engineering agent. It assesses readability, anti-patterns, performance bottlenecks, and security vulnerabilities, then categorizes findings by severity from Critical to Low in a structured report.

How does the design system compliance gate work in code review?

The reviewer reads .archflow/design-system.yaml and the referenced design system file, then runs every bullet in its Anti-patterns section against the code. Any violation forces a FAIL verdict with the file, line, and correct token or component named.

What happens when a code review fails in Archflow?

Findings are written as issues with blocking or minor severity into the story's issues list in the active release YAML, and the report opens with VERDICT: FAIL. The reviewer never fixes code; findings route back to the ui-engineer or api-engineer.

Can the code reviewer fix the issues it finds?

No. The role explicitly reviews without fixing, so the original author retains context and can disagree. It also cannot close or defer issues; status changes belong to whoever lands the fix or the user.

What if the project has no design system file configured?

If .archflow/design-system.yaml is missing and the project has a UI, the reviewer reports it as a blocking finding, since every screen becomes an independent guess without a defined design system.