devbooks-proposal-judge

Adjudicate proposals and update the proposal.md Decision Log.

84|6|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/Darkbluelr/dev-playbooks-cn --skill devbooks-proposal-judge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devbooks-proposal-judge
Source: https://github.com/Darkbluelr/dev-playbooks-cn/tree/main/skills/devbooks-proposal-judge
Command: npx skills add https://github.com/Darkbluelr/dev-playbooks-cn --skill devbooks-proposal-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the adjudication of proposals at the proposal stage, producing a clear decision (Approved, Revise, or Rejected) and updating the proposal.md Decision Log to enable auditable governance.

Core Features & Use Cases

  • Analyze Author and Challenger inputs to evaluate the validity of a proposal.
  • Enforce role isolation by verifying separation of responsibilities before logging a decision.
  • Write a structured Decision Log intoproposal.md with the chosen outcome, rationale, required changes, and validation checks.
  • Provide actionable next steps and traceable evidence for governance reviews.

Quick Start

Review the current proposal.md and Challenger notes, then run the judge to produce a decision and update the proposal.md Decision Log.

Frequently Asked Questions about devbooks-proposal-judge

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

FAQPage Schema
How do I automate proposal adjudication and generate an auditable decision log?

To automate proposal adjudication, this Skill analyzes Author versus Challenger discourse and outputs an explicit Approved, Revise, or Rejected decision. It then updates the proposal.md file with a structured Decision Log containing the rationale, required changes, and validation criteria.

How does a proposal judge enforce governance and separation of responsibilities?

A proposal judge enforces governance by running pre-checks to verify role isolation between the Author and Challenger. It ensures separation of responsibilities by requiring defined evidence and traceable records before producing a structured modification plan and logging the decision outcome.

What is the best way to document a proposal decision with traceable evidence for compliance reviews?

The best way to document a proposal decision for compliance is to automatically generate a Decision Log entry in proposal.md. This entry captures the chosen outcome, rationale, and validation checks, providing traceable evidence and actionable next steps to support governance reviews.

Can I use a decision log to track required changes when a proposal needs revision?

Yes, when a proposal needs revision, the judge outputs a structured modification plan directly into the decision log. This plan details the required changes and validation criteria, ensuring the author has actionable next steps and traceable evidence for governance tracking.

Why does proposal adjudication require role isolation before a decision is logged?

Proposal adjudication requires role isolation to enforce governance and maintain separation of responsibilities between the Author and Challenger. Verifying this separation before logging the decision prevents conflicts of interest and ensures the final outcome is based on defined evidence.

What do I need to run an automated proposal judge on my markdown documentation?

You need a proposal.md file containing the current proposal and Challenger notes. By reviewing these inputs, the judge executes pre-checks, evaluates the discourse, and produces an explicit decision with a structured modification plan and validation criteria for your documentation.