Multi-role-local-collaboration-system-kit

<div align="right"> <b>🇬🇧 English</b> | <a href="./README.zh-CN.md">🇨🇳 中文</a> </div>

<p align="center"> </p>

<p align="center"> <strong>Local-first multi-role collaboration kit for macOS.</strong><br/> Fixed roles, swappable providers, GUI-first setup, local recovery state, and a release flow that is stricter than most local AI stacks. </p>

<p align="center"> <a href="#quick-start">Quick Start</a> · <a href="#why-this-kit">Why</a> · <a href="#core-model">Core Model</a> · <a href="#whats-included">Included</a> · <a href="#faq">FAQ</a> · <a href="#docs">Docs</a> · <a href="./README.zh-CN.md">中文说明</a> </p>

<p align="center"> </p>

> One local system. Four fixed roles. Providers can change. Working rules do not.

Most local AI workflows are only stable while one provider stays healthy, one terminal stays open, and one operator remembers how the whole thing was wired.

This repository takes a stricter path:

• fixed four-role collaboration model
• swappable providers without changing role law
• local Coordination MCP plus SQLite-backed project state
• config audit, config history, and reversible rollback for non-secret config
• release gates that check bootstrap consistency and privacy, not just happy-path runtime smoke

This is intentionally opinionated. If you want a blank canvas for arbitrary