architect
Produces Alon's design-doc system BEFORE code: SOURCE_OF_TRUTH, ARCHITECTURE_ROADMAP, TODO_WORKFLOW, CLAUDE.md (+ modular docs/architecture). Model first: data…
Convenes a panel of opinionated advisors (parallel Claude subagents, each with a distinct mandate and a forbidden move so they genuinely diverge), then a Chairman synthesis that COMMITS to one recommendation with explicit tradeoffs. Use proactively for any high-stakes design,
$ npx -y skills add alonbaron/claude-skills --skill ask-the-council --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/ask-the-councilContext preview
The summary Claude sees to decide when to auto-load this skill.
Convenes a panel of opinionated advisors (parallel Claude subagents, each with a distinct mandate and a forbidden move so they genuinely diverge), then a Chairman synthesis that COMMITS to one recommendation with explicit tradeoffs. Use proactively for any high-stakes design,
name: ask-the-council description: > Convenes a panel of opinionated advisors (parallel Claude subagents, each with a distinct mandate and a forbidden move so they genuinely diverge), then a Chairman synthesis that COMMITS to one recommendation with explicit tradeoffs. Use proactively for any high-stakes design, architecture, or tradeoff decision where credible options genuinely compete. Also on "ask the council", "the council", "get a panel". Not for fact-finding or decisions with one obvious answer — answer those directly. argument-hint: "[the decision or question] [+ 'deep' for the full panel]"
A panel of advisors who are required to disagree, then a Chairman who decides. Use for decisions and tradeoffs, not for gathering facts.
If a decision is high-stakes and the options genuinely compete — architecture choice, buy-vs-build, irreversible migration — invoke this without being asked: announce in one line ("Convening the council: <decision>") and proceed. Never ask permission to run the skill.
1. **Frame the decision.** Restate the question, the real options, and the binding constraints. If one missing fact would flip the answer, ask it (max 1–2). Otherwise proceed on stated assumptions. 2. **Seat the council — in parallel.** Spawn advisors with the Agent tool, **all in one message**. Default panel of 4; `deep` seats all 6 and adds a critique round. Each advisor returns: **position · core reasoning · biggest risk they see · confidence (low/med/high)**. 3. **(deep only) Cross-critique.** Show each advisor the others' positions (unattributed) and have them name the single strongest opposing point. 4. **Chairman synthesis (you).** Not an average — a judgment. Output where they converge, where they split and *why*, the decisive tradeoff, and **one recommended path** with its rationale and the main risk to watch.
*Forbidden:* greenfield / ideal-world answers.
*Forbidden:* citing "best practice" or precedent.
*Forbidden:* agreeing with the apparent consensus.
years. *Forbidden:* optimizing for today only.
security. *Forbidden:* assuming the happy path.
*Forbidden:* the field's standard framing.
Default 4 = Executor, First-Principles, Long-term Architect, Adversary.
Lead with the **recommendation** (one or two sentences). Then: the key split and the tradeoff that decides it, then any dissent worth keeping. Short — a brief, not a transcript.
fence-sitting, no five-hedged-options answers.
refusing to choose is not.
acting. The council gives judgment, not ground truth.
faster than a panel.
panel costs 4–6 subagents; spend that only where being wrong is expensive to undo (schema, auth model, vendor lock-in, a migration). If you can't name what the wrong choice costs to reverse, don't seat the council.
`SOURCE_OF_TRUTH.md` before any code.
The user has a single clear recommendation, understands the strongest case against it, and knows the one risk to watch.
Apply on every run — canonical home `~/.claude/CLAUDE.md`:
Six Claude Code skills (architect, review-swarm, ask-the-council, prompt-generator, up-to-date, ponytail) bundled as an installable plugin.
Produces Alon's design-doc system BEFORE code: SOURCE_OF_TRUTH, ARCHITECTURE_ROADMAP, TODO_WORKFLOW, CLAUDE.md (+ modular docs/architecture). Model first: data…
Forces the laziest solution that actually works — YAGNI, reuse before new code, stdlib before custom, native platform before dependencies, one line before…
Turns a vague ask into a rigorous, grounded, token-efficient prompt: role + objective, testable done criteria, anti-hallucination (verify or say "I don't…
Local, free, multi-specialist review of a diff: parallel Claude subagents (correctness, security/trust boundaries, data/perf, architecture-altitude,…
Preflight sync + situational brief before repo work: fetch origin, ahead/behind divergence, recent commits, open PRs/issues, dirty-state warnings, one…