# Mia Platform — Creative Development Workspace

> A unified creative development platform consuming mia-code-server (VSCode fork), Miadi (narrative platform), and Tushell (knowledge layer) into a single web experience — chat on left, editor at center, preview on right — enabling storytelling, book creation, image generation, scene development, and recursive platform innovation through circular development.

**Version:** 0.1.0
**Framework:** RISE v1.2 (Reverse-engineer → Intent-extract → Specify → Export)
**Published at:** https://docs.workspace.jgwill.com

## Platform Architecture

- [Web Shell Architecture](./rispecs/web-shell-architecture.spec.md): Master architecture — component hierarchy, deployment, rispec coverage map, lineage
- [Platform Layout](./rispecs/01-platform-layout.spec.md): Three-pane layout, responsive behavior, pane toggling
- [Companion Chat Protocol](./rispecs/02-companion-chat-protocol.spec.md): Chat message format, companion switching, Three-Universe processing
- [Code-Server Bridge](./rispecs/03-code-server-bridge.spec.md): iframe embedding, postMessage API, file sync, event bridge
- [Preview Sandbox](./rispecs/04-preview-sandbox.spec.md): Port proxy, iframe isolation, hot reload, story/scene preview modes
- [Account & Team Model](./rispecs/05-account-team-model.spec.md): Multi-account, team workspaces, permissions
- [Project Workspace Binding](./rispecs/06-project-workspace-binding.spec.md): Chat = .code-workspace association, spiral phase tracking
- [Creative Content Pipeline](./rispecs/07-creative-content-pipeline.spec.md): Book/story/scene/image generation workflow, TV series narrative arcs
- [Deployment Topology](./rispecs/08-deployment-topology.spec.md): Docker compose, reverse proxy, multi-host, sandbox orchestration
- [Observability & Traceflow](./rispecs/09-observability-traceflow.spec.md): Langfuse integration, COAIA tracing, session analytics
- [Agentic Capabilities](./rispecs/10-agentic-capabilities.spec.md): Agent hooks, autonomous workflows, PDE-driven execution
- [Search & Indexing Layer](./rispecs/11-search-indexing-layer.spec.md): Full-text search, semantic indexing, cross-project discovery
- [PDE Four Directions Canonical](./rispecs/pde-four-directions-canonical.spec.md): Canonical PDE workflow with Medicine Wheel mapping
- [Decolonized Methodology Support](./rispecs/decolonized-methodology-support.spec.md): Indigenous research paradigm integration

## Sub-Projects

- [Miadi](https://docs.miadi.jgwill.com/llms.txt): Narrative platform — 107 MCP tools, A2A messaging, three-universe agents, miadi-code terminal agent with PDE
  - [Miadi Full Reference](https://docs.miadi.jgwill.com/llms-full.txt): Comprehensive reference with code examples
- [PDE-MCP](/a/src/mcp-pde/llms.txt): Prompt Decomposition Engine — 5 MCP tools, Four Directions mapping, git-diffable `.pde/` storage
- [Medicine Wheel](https://docs.medicine-wheel.jgwill.com/llms.txt): Four Directions ontology — 15 TypeScript packages including ontology-core, ceremony-protocol, fire-keeper, consent-lifecycle, and relational epistemology suite
  - [Medicine Wheel Full Reference](https://docs.medicine-wheel.jgwill.com/llms-full.txt): Comprehensive package API reference
- [Narintel](https://docs.narintel.jgwill.com/llms.txt): Narrative Intelligence Stack — NCP schema, LangGraph toolkit, 7 role-based apps, Three-Universe analysis
  - [Narintel Full Reference](https://docs.narintel.jgwill.com/llms-full.txt): Complete specification reference
- [Storytelling (WillWrite)](https://storytelling.jgwill.com/llms.txt): AI-powered narrative generation — Python + TypeScript, LangGraph orchestration, PHOENIX_WEAVE persistence, Indigenous ceremonial integration
  - [Storytelling Full Reference](https://storytelling.jgwill.com/llms-full.txt): Comprehensive reference with code examples
- [JGT Trading Ecosystem](https://jgtsrc.jgwill.com/llms.txt): Williams 5-Dimension trading intelligence — 20+ packages across data, analysis, execution, and agent layers
  - [JGT Full Reference](https://jgtsrc.jgwill.com/llms-full.txt): Complete trading ecosystem reference
- [SMCraft](https://docs.smcraft.jgwill.com/llms.txt): State Machine Craft — hierarchical FSM design, generation, and execution in Python + TypeScript + MCP + Web
  - [SMCraft Full Reference](https://docs.smcraft.jgwill.com/llms-full.txt): Complete SMDF schema, API, and runtime reference
- [Veritas (TandT)](https://docs.veritas.jgwill.com/llms.txt): Digital thinking platform — structured decision-making and performance management via Structural Thinking / MMOT
  - [Veritas Full Reference](https://docs.veritas.jgwill.com/llms-full.txt): Complete interfaces, APIs, and decision algorithms
- [mia-code-server](./repos/miadisabelle/mia-code-server/): VSCode fork with 71 rispecs — IDE without web shell

## Knowledge Base

- [Creative Orientation Framework](https://llms.jgwill.com): Master index of 40+ guidance documents
- [Structural Thinking](https://llms.jgwill.com/llms-structural-thinking.txt): Comprehensive Fritz methodology for LLMs — observation, tension, creative process
- [RISE Framework](https://llms.jgwill.com/llms-rise-framework.txt): Creative-oriented analysis and generation
- [PDE Framework](https://llms.jgwill.com/llms-pde.txt): Prompt Decomposition with Four Directions
- [Structural Tension Charts](https://llms.jgwill.com/llms-structural-tension-charts.txt): Desired outcome vs current reality
- [Narrative Beats](https://llms.jgwill.com/llms-narrative-beats.txt): Story documentation across three universes
- [Medicine Wheel Packages](https://llms.jgwill.com/llms-medicine-wheel-packages.txt): npm package reference
- [Kinship Hub System](https://llms.jgwill.com/llms-kinship-hub-system.md): Software as beings in kinship networks

## MCP Tools

- [MCP Structural Thinking](https://llms.jgwill.com/llms-mcp-structural-thinking.txt): 6 tools — reactive pattern detection, structural tension formulation, creative process phase ID, Three-Universe validation
- [MCP Patterning](https://llms.jgwill.com/llms-mcp-patterning.txt): 7 tools + 8 prompts — oscillation detection, structural tension analysis, cross-domain validation
- [MCP SCCP Character](https://llms.jgwill.com/llms-mcp-sccp-character.txt): 8 tools + 5 resources + 4 prompts — character arc development from 81+ SCCP patterns
- [PDE-MCP](/a/src/mcp-pde/llms.txt): 5 tools + 2 resources + 1 prompt — prompt decomposition with Four Directions

## PDE + Structural-Thinking Integration

The PDE framework and structural-thinking MCP work together through the `rise-pde-session` and `pde-review-companion` skill pair:

1. **Decomposition** (PDE): Complex prompts → structured DecompositionResult with Four Directions mapping
2. **Validation** (Structural-Thinking): `structural_thinking_observe` surfaces missed context, `detect_reactive_patterns` ensures creative framing, `three_universe_analysis` cross-validates
3. **Review** (Partner): Human + pde-review-companion refine during 12-minute sleep window
4. **Execution** (Agent): Revised plan drives incremental implementation

**Future**: Full automation at Miadi server level — see [PDE+Structural-Thinking Automation rispec](https://docs.miadi.jgwill.com/rispecs/miadi-code-pde/pde-structural-thinking-automation.rispec.md)

## Key Concepts

- **Three Universes**: Engineer (🔧 Mia), Ceremony (🎭 Ava), Story Engine (📚 Miette) — every component validated through all three lenses
- **Four Directions**: East 🌅 (Vision) → South 🔥 (Analysis) → West 🌊 (Validation) → North ❄️ (Action)
- **Structural Tension**: Disequilibrium between desired outcome and current reality — drives advancement, not problem-solving
- **Circular Development**: East (vision) → South (growth) → West (reflection) → North (integration)
- **RISE Framework**: Creative-oriented specification methodology — codebase agnostic
- **Ceremony Phases**: Opening → Council → Integration → Closure
- **Wilson's Three R's**: Respect, Reciprocity, Responsibility

## Documentation

- [llms-full.txt](https://llms.jgwill.com/llms-full.txt): Master index of all guidance documents (40+)
- [CLAUDE.md](./CLAUDE.md): AI agent development guidance
- [JGWILL.md](./JGWILL.md): Master workspace coordination — companions, circular development, specification layers
- [KINSHIP.md](./rispecs/KINSHIP.md): Workspace-level kinship relationships