speckit-council-approve

Records the human council gate decision on decision-record.md to unlock task generation.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-council-approve-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-council-approve
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-council-approve
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-council-approve-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In a spec-driven development pipeline, plans must survive an adversarial council review before any code is written. This Skill provides the human approval gate that formally records a reviewer's decision on the council's decision record, ensuring no plan proceeds to task generation without explicit human sign-off. ## Core Features & Use Cases - Human Gate Recording: Presents the defense deck overview, round suggestions, and triage disposition table to a reviewer, then appends a structured ## Human Gate section (reviewer, decision, notes, overrides) to decision-record.md. - Blocking Item Enforcement: Flags any unresolved blocking suggestion before asking for a decision and requires it to be named in the Overrides field. - Auto-Mode Safety: Under gates.council.mode: auto, it never fabricates a gate section — it detects the auto-written section from triage or stops with an out-of-order error. - Use Case: After running /speckit-council and /speckit-council-triage on a feature plan, a reviewer runs /speckit-council-approve approved-with-notes "tighten the caching section" to record the decision and unlock /speckit-tasks. ## Quick Start Run /speckit-council-approve with a decision of approved, approved-with-notes, or rejected plus optional notes after triage has completed for the current council round.

Frequently Asked Questions about speckit-council-approve

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

FAQPage Schema
How do I approve a plan after council review in Spec Kit?

Run /speckit-council-approve with a decision token: approved, approved-with-notes, or rejected, optionally followed by free-text notes. The skill presents the defense deck overview, suggestions verdict, and triage disposition table, then appends a Human Gate section to decision-record.md.

What happens when the council gate is approved?

An approved or approved-with-notes decision unlocks /speckit-tasks, since task generation requires an approved gate section in decision-record.md. A rejected decision sends the plan back for one more revision round with a fresh council session.

Can the council approval gate run automatically without a human?

Only when profile.yaml sets gates.council.mode to auto within a full_auto profile. In that case /speckit-council-triage writes the gate section itself with reviewer: auto, and this command becomes a no-op or stops with an out-of-order error.

Why does speckit-council-approve fail with a missing artifact error?

It requires a triaged decision-record.md with at least one Round section, plus defense-deck/overview.md and round-N/suggestions.md. Run /speckit-council and then /speckit-council-triage first to produce these artifacts.

Does the council gate command write traces or call an LLM?

No. The gate runs no LLM session — a human reads the artifacts and decides — so it writes nothing to traces.jsonl. The Human Gate section in decision-record.md is itself the audit trail for this phase.