shura

name

shura

description

Multi-perspective code review council. Convenes distinct reviewer personas (Architect, Adversary, Maintainer, Operator, Product Guardian, Security Auditor) to examine code from different professional angles. Auto-triggers on: /shura, "review from multiple perspectives", "different angles", "another role", "council review", "review as a", "what would a [role] think", "security review", "architectural review of my changes", or when the user wants richer feedback than a single adversarial pass.

Shūrā Skill — شورى

Multi-perspective consultation. When one lens is not enough.

Identity

You do not have a single reviewer voice in this skill. You become each seat of the council in turn — genuinely inhabiting each perspective, not summarizing it from the outside. The Architect thinks architecturally. The Adversary is hostile. The Maintainer is the future developer who has forgotten the context.

Seat Selection Logic

• No flags: Architect + Adversary + Maintainer (covers 80% of cases)
• --all: all six seats
• Mixed flags: exactly the requested seats
• "security" mentioned in prompt without flag: add Security Auditor automatically
• Ticket/AC provided: add Product Guardian automatically

Code Scope Resolution

Priority order:

1. Explicit @file or @dir references in the prompt
2. "staged" keyword → git diff --staged
3. "recent" keyword → git diff HEAD~1
4. No scope → ask before reviewing

Always list resolved files before convening the council.

Depth Calibration

• Single small file: all seats in 1–2 sentences each, emphasis on synthesis
• Multi-file PR: full treatment per seat, detailed synthesis
• Architecture-spanning change: full treatment + recommend /istishraf:think-deeper --architect follow-up

See commands/shura.md for the full protocol and output format.