Pmaster-dev · Pmaster-dev · Jul 2, 2026 · Jul 1, 2026 · Jul 2, 2026 · Jul 2, 2026
diff --git a/README.md b/README.md
@@ -1,4 +1,54 @@
-# OpenAPI Definition Starter
+# 360 Magicians — Docs
+
+OpenAPI definition and aggregated documentation for the [360 Magicians](https://github.com/360magicians)
+Deaf-First AI ecosystem.
+
+## Project Docs
+
+See the [`docs/`](./docs/README.md) directory for full project documentation:
+
+### Ecosystem Guides
+- [About 360Magicians](./docs/about.md)
+- [Infrastructure / Ecosystem Architecture](./docs/infrastructure.md)
+- [Git Workflow & GitHub Integration](./docs/git-workflow.md)
+- [Helm Deployment (dev → prod)](./docs/helm.md)
+- [Environments & Bootstrap](./docs/environments.md)
+- [AI Providers, Vendors & Resources](./docs/providers.md)
+- [AI Model Manifest](./docs/ai-model-manifest.md)
+- [AI Inference Architecture](./docs/ai-inference.md)
+- [Package Managers & Runtimes](./docs/package-managers.md)
+- [Triggers, Webhooks & Prompts](./docs/triggers-webhooks.md)
+- [Pipeline Handoffs](./docs/pipeline-handoffs.md)
+- [Copilot, Bots & Auth Access](./docs/copilot-bots.md)
+
+### Project Docs
+- [DeafAuth](./docs/projects/deafauth.md)
+- [PinkSync](./docs/projects/pinksync.md)
+- [FibonRose](./docs/projects/fibonrose.md)
+- [Municipal DAO](./docs/projects/municipal-dao.md)
+- [Railway Next.js Template](./docs/projects/railway-template.md)
+- [MBTQ.dev](./docs/projects/mbtq-dev.md)
+- [MBTQUniverse](./docs/projects/mbtquniverse.md)
+
+## OpenAPI Definition
+
+The `openapi/` directory contains the OpenAPI 3.1 definition for the 360 Magicians API.
+
+### Install
+
+1. Install [Node JS](https://nodejs.org/).
+2. Clone this repo and run `npm install` in the repo root.
+
+### Usage
+
+```bash
+# Start reference docs preview
+npm start
+
+# Validate the definition
+npm test
+```
+
 
 ## How to use this starter
 

diff --git a/docs/README.md b/docs/README.md
@@ -0,0 +1,117 @@
+# 360 Magicians — Documentation
+
+This directory contains aggregated documentation for the [360Magicians](https://github.com/360magicians)
+Deaf-First AI ecosystem and all associated repositories across the MBTQ universe.
+
+---
+
+## Contents
+
+### Ecosystem Guides
+
+| File | Description |
+|------|-------------|
+| [about.md](./about.md) | Organization overview, mission, and project list |
+| [infrastructure.md](./infrastructure.md) | MBTQ ecosystem architecture (GCP / Kubernetes) |
+| [git-workflow.md](./git-workflow.md) | Branch strategy, agent git flow, GitHub Graph API, CI/CD events |
+| [helm.md](./helm.md) | Helm charts, deployment targets, env overrides (dev → prod) |
+| [environments.md](./environments.md) | Dev → staging → prod separation, bootstrap steps, env vars |
+| [providers.md](./providers.md) | AI providers, platform vendors, open-source vs proprietary vs custom |
+| [ai-model-manifest.md](./ai-model-manifest.md) | Canonical AI model registry — HF IDs, capabilities matrix, SDK bindings, deployment paths |
+| [ai-inference.md](./ai-inference.md) | Inference servers (vLLM/Ollama/TGI), routing, fallback chains, latency tiers |
+| [package-managers.md](./package-managers.md) | pnpm / npm / Deno / Fresh / HTML — which project uses what |
+| [triggers-webhooks.md](./triggers-webhooks.md) | Full webhook catalog, GitHub App setup, HMAC verification, prompt triggers |
+| [pipeline-handoffs.md](./pipeline-handoffs.md) | Every agent handoff with trigger, input/output contracts, and commands |
+| [copilot-bots.md](./copilot-bots.md) | Copilot prompts, authorized bots, OAuth/PAT/JWT/GCP auth access patterns |
+
+### Project Docs
+
+| File | Description |
+|------|-------------|
+| [projects/deafauth.md](./projects/deafauth.md) | DeafAuth — identity & access layer + Magician Jobs API |
+| [projects/pinksync.md](./projects/pinksync.md) | PinkSync — accessibility AI middleware + API broker |
+| [projects/fibonrose.md](./projects/fibonrose.md) | FibonRose — Next.js UI application (pnpm, shadcn/ui) |
+| [projects/municipal-dao.md](./projects/municipal-dao.md) | Municipal DAO — real-time WebSocket governance platform |
+| [projects/railway-template.md](./projects/railway-template.md) | Railway Next.js template — production-ready starter (npm) |
+| [projects/mbtq-dev.md](./projects/mbtq-dev.md) | MBTQ.dev — AI-powered full-stack development platform |
+| [projects/mbtquniverse.md](./projects/mbtquniverse.md) | MBTQUniverse — DAO governance, tokenization, staking |
+
+---
+
+## Repositories Covered
+
+### 360Magicians Org
+
+| Repo | Status | Language |
+|------|--------|----------|
+| [360magicians/about](https://github.com/360magicians/about) | Active | — |
+| [360magicians/infrastructure](https://github.com/360magicians/infrastructure) | Active | — |
+| [360magicians/deafauth](https://github.com/360magicians/deafauth) | Active | JavaScript |
+| [360magicians/pinksync](https://github.com/360magicians/pinksync) | Active | TypeScript |
+| [360magicians/fibonrose](https://github.com/360magicians/fibonrose) | Active | TypeScript |
+| [360magicians/municipal-dao](https://github.com/360magicians/municipal-dao) | Active | TypeScript |
+| [360magicians/railway_nextjs_with_shadcn](https://github.com/360magicians/railway_nextjs_with_shadcn) | Active | TypeScript |
+
+### pinkycollie
+
+| Repo | Status | Language |
+|------|--------|----------|
+| [pinkycollie/mbtq-dev](https://github.com/pinkycollie/mbtq-dev) | Active | TypeScript |
+| [pinkycollie/mbtquniverse](https://github.com/pinkycollie/mbtquniverse) | Active | JavaScript |
+| [pinkycollie/deaf-first-platform](https://github.com/pinkycollie/deaf-first-platform) | Active | HCL |
+| [pinkycollie/Nextjs-DeafAUTH](https://github.com/pinkycollie/Nextjs-DeafAUTH) | Active | TypeScript |
+| [pinkycollie/NegraRosa](https://github.com/pinkycollie/NegraRosa) | Active | TypeScript |
+| [pinkycollie/VR4Deaf](https://github.com/pinkycollie/VR4Deaf) | Active | TypeScript |
+| [pinkycollie/ai-magicians-gcp](https://github.com/pinkycollie/ai-magicians-gcp) | Active | TypeScript |
+| [pinkycollie/FibonRoseTrust](https://github.com/pinkycollie/FibonRoseTrust) | Active | TypeScript |
+| [pinkycollie/PinkSync-Visualizer](https://github.com/pinkycollie/PinkSync-Visualizer) | Active | TypeScript |
+| [pinkycollie/Deaf-Creators-Platform](https://github.com/pinkycollie/Deaf-Creators-Platform) | Active | TypeScript |
+
+### MBTQ-dev Org
+
+| Repo | Status | Language |
+|------|--------|----------|
+| [MBTQ-dev/DeafAUTH](https://github.com/MBTQ-dev/DeafAUTH) | Active | TypeScript |
+| [MBTQ-dev/Magician_Platform](https://github.com/MBTQ-dev/Magician_Platform) | Active | TypeScript |
+| [MBTQ-dev/DEAF-FIRST-PLATFORM2](https://github.com/MBTQ-dev/DEAF-FIRST-PLATFORM2) | Active | HCL |
+| [MBTQ-dev/deploy-admin](https://github.com/MBTQ-dev/deploy-admin) | Active | TypeScript |
+| [MBTQ-dev/Auto-API](https://github.com/MBTQ-dev/Auto-API) | Active | Python |
+| [MBTQ-dev/pinksync-starter](https://github.com/MBTQ-dev/pinksync-starter) | Active | Python |
+
+### DeafAUTH Org
+
+| Repo | Status | Language |
+|------|--------|----------|
+| [DeafAUTH/readme.md](https://github.com/DeafAUTH/readme.md) | Active | — |
+
+### PinkSync Org
+
+| Repo | Status | Language |
+|------|--------|----------|
+| [PinkSync/PinkSync](https://github.com/PinkSync/PinkSync) | Active | TypeScript |
+| [PinkSync/Core-principles](https://github.com/PinkSync/Core-principles) | Active | Python |
+| [PinkSync/pinksync-starter](https://github.com/PinkSync/pinksync-starter) | Active | — |
+| [PinkSync/awesome-deaf-first](https://github.com/PinkSync/awesome-deaf-first) | Active | — |
+| [PinkSync/manifesto](https://github.com/PinkSync/manifesto) | Active | — |
+
+---
+
+## API Quick Reference
+
+Base URL: `https://api.360magicians.com`
+
+```bash
+# Authenticate via DeafAUTH
+export DEAFAUTH_TOKEN=<YOUR_ACCESS_TOKEN>
+
+# List jobs
+curl -H "Authorization: ******" https://api.360magicians.com/jobs/list
+
+# Submit idea
+curl -X POST https://api.360magicians.com/idea \
+  -H "Authorization: ******" \
+  -d '{"prompt": "Deaf-first SaaS idea"}'
+```
+
+Full API reference: [DeafAuth Docs](./projects/deafauth.md)
+
diff --git a/docs/about.md b/docs/about.md
@@ -0,0 +1,66 @@
+# 👁‍🗨 360 Magicians
+**Deaf Aware. Rooted Deaf First. Globally Future-Proof AIs.**
+
+[![Deaf-First](https://img.shields.io/badge/Deaf%20First-Accessible%20by%20Design-blue?style=flat-square)]()
+[![AI Agents](https://img.shields.io/badge/AI%20Agents-360Magicians-green?style=flat-square)]()
+[![License](https://img.shields.io/badge/License-MIT-lightgrey?style=flat-square)]()
+[![Open Source](https://img.shields.io/badge/Open%20Source-Yes-orange?style=flat-square)]()
+
+---
+
+We are an **anonymous collective** of Deaf-aware and Deaf-First infrastructure architects,
+software engineers, AI builders, and agentic system designers.
+Our mission: **engineer the future of accessible innovation** —
+where Deaf communities aren't "included later," but **built in from day zero**.
+
+---
+
+## 🚀 What We Build
+
+- **Deaf-First Platforms** → VR4Deaf, PinkSync, DeafAuth, FibonRose
+- **AI & Agents** → 360Magicians frameworks that think and act for business
+- **Infrastructure** → Compliant, scalable, and globally interoperable
+
+---
+
+## 📌 Repositories
+
+| Project | Description |
+|---------|-------------|
+| **`magician-core`** | Central AI agent orchestrating IDEA → BUILD → GROW → MANAGED lifecycle |
+| **`pinksync`** | Accessibility layer + real-time sync engine |
+| **`deafauth`** | Web2/Web3 authentication & verification for Deaf-first platforms |
+| **`mbtq.dev`** | Core developer platform & ecosystem hub |
+| **`vr4deaf`** | Partner & milestone tracking platform for Deaf entrepreneurs |
+| **`fibonrose`** | Next.js UI application (TypeScript / shadcn/ui) |
+| **`municipal-dao`** | On-chain governance DAO with real-time WebSocket voting |
+| **`railway_nextjs_with_shadcn`** | Production-ready Next.js Railway deployment template |
+
+---
+
+## 🌐 Connect
+
+- Website: [360magicians.com](https://360magicians.com)
+- Ecosystem Docs: *(Coming Soon)*
+- Partners: v0, AI Google Studio, Supabase, OpenAI, Claude AI, Cursor AI, Neon, Fal, Grok, Groq
+
+---
+
+## Lifecycle
+
+360Magicians orchestrates projects through **IDEA → BUILD → GROW → MANAGED**. Each stage is managed
+by specialized AI agents:
+
+| Stage   | Magician Roles                                   | Description                                         |
+|---------|--------------------------------------------------|-----------------------------------------------------|
+| IDEA    | ValidatorMagician, ResearchMagician              | Generate ideas, validate compliance, research market |
+| BUILD   | DeveloperMagician, DesignMagician                | Create repo, generate wireframes, develop MVP       |
+| GROW    | GrowthMagician, PartnershipMagician              | Marketing, analytics, onboarding                    |
+| MANAGED | ComplianceMagician, FinanceMagician, OpsMagician | Ongoing monitoring, reporting, operations           |
+
+All tasks are **Deaf-first**: ASL-ready interfaces, captions, and accessibility features.
+
+---
+
+> _We don't just build code.
+> We build the conditions for Deaf entrepreneurs to lead the next era._