collab-board

Enforce alternating PRIMARY and SECONDARY AI model turns with skeptical peer review.

5|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/Veisy/collab-board --skill collab-board
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: collab-board
Source: https://github.com/Veisy/collab-board/tree/main/skill
Command: npx skills add https://github.com/Veisy/collab-board --skill collab-board

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Single AI models have blind spots and can confidently state wrong answers. This Skill creates a strict turn-based collaboration between a PRIMARY and a SECONDARY AI model, enforcing skeptical peer review and gated phases so mistakes are caught early before they compound into larger failures.

Core Features & Use Cases

  • Strict Alternating Turns: A PRIMARY and SECONDARY model take turns through PLAN and IMPLEMENTATION phases, with each turn reading only the files it needs to keep context small regardless of session length.
  • Gated Phases: The PLAN phase cannot advance to IMPLEMENTATION until both models agree and all open points are resolved, preventing wrong decisions from becoming the foundation for later work.
  • Skeptical Review: Each model must back claims with evidence and challenge the other, reducing confidently-wrong answers and shared blind spots through adversarial collaboration.
  • Use Case: Have Claude and Codex collaborate on a feature, bug fix, refactor, investigation, or design — from planning through implementation — with full audit trails and bounded per-turn context.

Quick Start

Use the collab-board skill to start a new collaboration session between two AI models for your task, then drive the strict turn-based planning and implementation loop until both phases agree and the work is complete.

Frequently Asked Questions about collab-board

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

FAQPage Schema
How do I enforce strict turn-based collaboration between two AI models for code review?

Strict turn-based collaboration between two AI models is enforced by alternating PRIMARY and SECONDARY turns through gated PLAN and IMPLEMENTATION phases, where each model must back claims with evidence and challenge the other to catch confidently-wrong answers. The session is managed through a split interlinked Markdown tree under .collab-board/.

What is adversarial AI peer review and how does it prevent blind spots in feature development?

Adversarial AI peer review is a skeptical collaboration process where a PRIMARY and SECONDARY model take strict alternating turns, challenging each other's claims with evidence. It prevents blind spots by gating the PLAN phase so both models must agree and resolve all open points before any implementation begins.

Can I use different AI models like Claude and Codex for turn-based planning and implementation?

Yes, adapter-based delegation supports using different AI models like Claude and Codex for turn-based planning and implementation. The PRIMARY model drives the task while the SECONDARY model's turns are delegated through adapters, keeping per-turn context bounded regardless of session length.

How do I start a collaboration session for a bug fix or refactor using two AI models?

To start a collaboration session, use the collab-board skill to scaffold a new session with a Node.js CLI, which creates a split interlinked Markdown session tree under .collab-board/. You then drive the strict turn-based planning and implementation loop until both phases agree and the work is complete.

What's the best way to keep AI context small during long co-design and co-implementation sessions?

The best way to keep AI context small during long sessions is enforcing strict alternating turns where each model reads only the files it needs within a split Markdown session tree. This bounded per-turn context approach ensures the context size remains manageable regardless of total session length.

Why does single AI model implementation produce confidently-wrong answers during refactoring?

Single AI model implementation produces confidently-wrong answers because it lacks skeptical peer review to challenge assumptions and catch blind spots. Introducing a strict turn-based collaboration with a SECONDARY model enforces adversarial review, requiring evidence-backed claims before advancing through gated phases.