Consensus-AI

Author: Mikhail Deynekin – https://Deynekin.com – Mikhail@Deynekin.com
Version: 1.0.0 (2026-04-27)
License: MIT

Overview

Consensus-AI is a PHP 8.4 web application implementing an OpenCorum-style AI council for deliberative intelligence. It uses multiple LLMs simultaneously through BotHub.chat API, combines their outputs via a structured consensus engine, and surfaces full transparency through an interactive "Details" diagram for every answer.

Inspired by OpenCorum and the CAIS API.

Key Features

• Multi-model, multi-role council sessions via BotHub.chat (OpenAI-compatible)
• SKILLS system: declarative JSON workflows defining agent roles, prompts, and consensus rules
• Auto-selection or auto-creation of the most relevant SKILL per query
• Vector memory: chunk storage + retrieval for short-term and long-term context
• Full audit trail: every model response, every step, every consensus score persisted in MySQL
• Interactive "Details" button: clickable DAG showing the entire council flow
• PHP 8.4 strict types, readonly properties, enums throughout
• MySQL 8.x via PDO with prepared statements and explicit transactions

Repository Structure

Consensus-AI/
├── README.md
├── docs/
│   ├── Part1-Architecture.md         # Overall concept, functional requirements, tech stack
│   ├── Part2-Skills.md               # SKILL JSON schema + 4 concrete SKILLS
│   ├── Part3-Database-Interfaces.md  # MySQL DDL + PHP interfaces
│   ├── Part4-CouncilEngine-API.md    # CouncilEngine layers + API endpoints
│   ├── Part5-Controllers-Flow.md     # HTTP controllers + downgrade mitigation
│   └── Part6-CouncilEngine.md        # Full CouncilEngine PHP 8.4 module
├── src/
│   ├── Application/
│   │   ├── Council/
│   │   │   └── CouncilEngine.php
│   │   ├── Skill/
│   │   └── Memory/
│   ├── Domain/
│   │   ├── Council/
│   │   ├── Skill/
│   │   └── Memory/
│   ├── Infrastructure/
│   │   └── LLM/
│   └── Http/
│       └── Controller/
└── db/
    └── schema.sql

Architecture (4-Layer Council)

User Query
    │
    ▼
[L0] Skill Router ──► Auto-create SKILL if needed
    │
    ▼
[L1] Query Distribution ──► Parallel calls to multiple roles + models
    │
    ▼
[L2] Response Normalization ──► JSON schema enforcement per role
    │
    ▼
[L3] Consensus Analysis ──► Agreement scores, conflict detection
    │
    ▼
[L4] Decision Synthesis ──► Final answer + audit trail
    │
    ▼
Final Answer + [Details] button

Built-in SKILLS

Slug	Purpose	Roles
webapp_architect	PHP+MySQL+vector store architecture	Solution Architect, Scalability Expert, Security Engineer
db_performance_optimizer	MySQL query/schema optimization	Query Profiler, Storage Designer, Migration Planner
php_code_refiner	PHP 8.4 code refactoring	Senior PHP Reviewer, Error-Handling Specialist, Future-Proofing Reviewer
ux_frontend_collaborator	Modern 2026 UI/UX design	UX Designer, UI Engineer, Interaction Designer

Quick Start

1. Clone the repository
2. Configure .env with your BotHub API key and MySQL credentials
3. Run db/schema.sql against your MySQL 8.x instance
4. Configure a vector store (Qdrant recommended, or MySQL-inline fallback)
5. Start the PHP built-in server or deploy to your web server

Documentation

All design decisions, schemas, and module breakdowns are documented in docs/.

Links

• BotHub.chat API
• OpenCorum
• CAIS API Reference