skills.rest
shuu5
shuu5COMMUNITY
Explore all skills by this author →
GitHub

twl:workflow-arch-review

Automate architecture-document PR reviews through a four-step chain.

Updated Apr 5, 2026
Search Tags:#automation#workflow#documentation#collaboration#architecture-review#pr-review
One-click install
npx skills add https://github.com/shuu5/twill --skill twl-workflow-arch-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: twl:workflow-arch-review
Source: https://github.com/shuu5/twill/tree/main/plugins/twl/skills/workflow-arch-review
Command: npx skills add https://github.com/shuu5/twill --skill twl-workflow-arch-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture docs PR reviews can be time-consuming and error-prone. This workflow provides a lightweight, chain-driven process that streamlines architecture-focused PR reviews by removing code-only steps and guiding the review through a defined sequence.

Core Features & Use Cases

  • Four-step chain: arch-phase-review → arch-fix-phase → merge-gate → auto-merge to ensure architecture changes are reviewed, corrected, gated, and merged consistently.
  • Role-aware execution: works when prompted by a user or invoked by a co-architect, ensuring collaboration.
  • Deterministic guidance: deterministic steps, with LLM-driven checkpoints and optional dependencies via scripts.

Quick Start

Start the architecture review workflow by requesting an arch-review for a PR, and the system will execute the four steps in order.

Frequently Asked Questions about twl:workflow-arch-review

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

FAQPage Schema
How do I automate architecture document PR reviews?▼

Automate architecture document PR reviews by initiating a four-step chain workflow that guides changes through phase review, fix, merge gate, and auto-merge to streamline the process.

What is the best way to streamline architecture-focused PR review workflows?▼

Streamline architecture-focused PR review workflows by using a lightweight, chain-driven process that removes code-only steps and applies deterministic guidance with LLM-driven checkpoints.

Can I use this architecture review workflow when collaborating with a co-architect?▼

Yes, the architecture review workflow supports role-aware execution and works effectively when invoked by a user or a co-architect participating in the collaboration process.

Does the architecture PR review workflow support modular extensibility?▼

Yes, the architecture PR review workflow supports modular extensibility through scripts and references, allowing you to define step checkpoints and add optional dependencies.

When should I use a chain-driven workflow for architecture PR reviews?▼

Use a chain-driven workflow for architecture PR reviews when you need deterministic step execution and consistent gating for architecture changes, replacing time-consuming manual reviews.

Why does the architecture review workflow skip code-only steps?▼

The architecture review workflow skips code-only steps to focus specifically on architecture changes, ensuring that the review process remains lightweight and targeted at documentation.

Related Skills

Explore More Software Engineering Skills→
LucaDeLeoLucaDeLeo
1

bmad-agent-bmm-architect

Activates and initializes the BMAD architect agent from the project root.

Community
Advanced
omerakbenomerakben
1

git-workflow-deployment

Automate Git branching, CI/CD gates, and Vercel production deployments.

Community
Intermediate
harperreedharperreed
330

skill-creator

Create Codex skill units with required SKILL.md structure and YAML frontmatter.

Community
Basic
mfittkomfittko
14

copilot-pr-followup

Automate GitHub PR follow-up tasks from Copilot review through gate checks.

Community
Advanced