spec-deliberator

Reconcile stakeholder knowledge into jointly accepted, auditable specification revisions.

8|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/ddobrin/plan-skills --skill spec-deliberator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-deliberator
Source: https://github.com/ddobrin/plan-skills/tree/main/plugins/plan/skills/spec-deliberator
Command: npx skills add https://github.com/ddobrin/plan-skills --skill spec-deliberator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill improves incomplete or contested specifications when critical product, engineering, operations, or security knowledge is distributed across separate stakeholders, documents, or repositories.

Core Features & Use Cases

  • Disjoint Perspective Panels: Dispatches delegates with deliberately separate context bundles for product, engineering, operations, security, or other specialized perspectives.
  • Structured Convergence: Relays delegate dialogue verbatim through bounded sequential rounds and maintains a versioned proposal until the panel accepts one jointly revised specification.
  • Auditable Handoff: Applies only agreed edits, records disclosures, amendments, acceptance rationales, disputes, and round history, then hands the revised specification to adversarial validation.
  • Use Case: Use it when an export feature depends on user workflows, infrastructure limits, and access-control requirements that no single stakeholder or context window fully captures.

Quick Start

Ask the spec-deliberator skill to improve the attached specification using separate product, engineering, and operations context bundles, write the deliberation record, and prepare the revision for validation.

Frequently Asked Questions about spec-deliberator

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

FAQPage Schema
How do I reconcile siloed stakeholder requirements into a single specification?

A multi-agent deliberation process reconciles siloed stakeholder requirements by dispatching delegates with separate context bundles for product, engineering, and security, then relays their dialogue verbatim through bounded rounds until they jointly accept one revised specification.

What is the best way to align product and engineering teams on a contested feature spec?

The best way to align product and engineering teams on a contested feature spec is structured convergence, where delegates relay dialogue verbatim through bounded sequential rounds, maintaining versioned proposals until the panel accepts one auditable specification.

Can I improve an incomplete specification when critical knowledge is spread across different documents?

Yes, you can improve an incomplete specification when critical knowledge is spread across different documents by using disjoint perspective panels that apply specialized context bundles to capture constraints from product, operations, security, and legacy-system perspectives before adversarial validation.

How do I handle disputes and track amendments during stakeholder specification alignment?

To handle disputes and track amendments during stakeholder specification alignment, the deliberation process maintains versioned proposals, records disclosures and acceptance rationales, and persists a complete round-by-round deliberation record before handing off the revised spec to validation.

Does multi-agent adversarial validation work for bug fixes and refactoring specifications?

Yes, multi-agent adversarial validation works for bug fixes and refactoring specifications, applying multi-perspective stakeholder alignment to disputed or incomplete specs requiring engineering, operations, or data constraints before final validation.

Why does my specification fail validation after stakeholder review?

Your specification may fail validation after stakeholder review if critical product, engineering, operations, or security knowledge remains siloed across separate stakeholders or repositories rather than being jointly reconciled into a single auditable revision through structured deliberation.