deliberation-tester

Apply Test-Driven Development patterns to AI deliberation features.

Updated Dec 14, 2025
One-click install
npx skills add https://github.com/Raudbjorn/cognitive-construct --skill deliberation-tester-raudbjorn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deliberation-tester
Source: https://github.com/Raudbjorn/cognitive-construct/tree/main/rhetoric/scripts/ai-counsel/.claude/skills/deliberation-tester
Command: npx skills add https://github.com/Raudbjorn/cognitive-construct --skill deliberation-tester-raudbjorn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developing complex AI deliberation systems requires rigorous testing to ensure reliability, prevent regressions, and maintain high code quality. This Skill teaches Test-Driven Development (TDD) patterns specifically tailored for AI Counsel's features.

Core Features & Use Cases

  • TDD Workflow: Guides through the "red-green-refactor" cycle for developing new features, ensuring tests are written before implementation.
  • Unit Test Patterns: Provides strategies for mocking adapters, subprocesses, and Pydantic models to create fast, isolated tests.
  • Integration Test Patterns: Demonstrates how to test real adapter invocations, use VCR cassettes for HTTP tests, and conduct performance benchmarks.
  • Code Quality Checks: Emphasizes running black, ruff, and mypy to maintain consistent code style and type safety.
  • Use Case: When adding a new HTTP adapter for a local LLM, first write a failing unit test that asserts the adapter correctly parses the model's response. Then, implement the adapter's parse_response() method to make the test pass, ensuring the integration is robust from the start.

Quick Start

Before implementing any new feature, write a test that will initially fail:

tests/unit/test_new_feature.py

import pytest from my_module import NewFeature

class TestNewFeature: def test_feature_does_something(self): feature = NewFeature() result = feature.do_something() assert result == "expected output"

Frequently Asked Questions about deliberation-tester

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

FAQPage Schema
How do I apply Test-Driven Development to AI deliberation features?

Test-Driven Development for deliberation applies the red-green-refactor cycle: write a failing test first, implement code to pass it, then refactor. This ensures deliberation logic—adapters, convergence detection, voting systems—is reliable and regression-free before deployment.

What's the best way to unit test deliberation adapters and mocking strategies?

Unit test deliberation adapters by mocking subprocesses, HTTP calls, and Pydantic models to isolate the adapter logic. Mock the adapter's parse_response() method and CLI invocations, then assert correct behavior without invoking real services or external processes.

How do I write integration tests for HTTP adapters in a deliberation system?

Integration tests for HTTP adapters use VCR cassettes to record and replay real HTTP interactions, eliminating external dependencies while testing actual adapter parsing. Run performance benchmarks alongside integration tests to validate adapter throughput.

Can I apply TDD patterns to multi-round deliberation and decision graphs?

Yes, TDD applies directly to multi-round deliberation, voting systems, and decision graphs. Write tests that assert convergence detection logic, transcript handling, and graph traversal before implementing these features, ensuring correctness across deliberation cycles.

What code quality checks should I run when adding deliberation features?

Run black for formatting, ruff for linting, and mypy for type checking when adding deliberation features. These checks maintain consistent style and catch type errors in adapter implementations, model definitions, and deliberation engine code before testing.

Do I need pytest to implement TDD patterns for deliberation systems?

pytest is the standard testing framework for deliberation TDD workflows, providing fixtures, mocking support via pytest-mock, and parametrized tests for testing multiple deliberation scenarios and adapter configurations efficiently.