# Miadi

> A Next.js 16 narrative platform with 40+ routes, 107 MCP tools, A2A messaging, Redis-backed memory, GitHub webhook ETL, three-universe agent architecture (Engineer/Ceremony/Story Engine), and ceremony-grounded workflows for creative-oriented development.

**Version:** 2.1.0
**Language:** TypeScript (Next.js 16, App Router)
**License:** MIT
**Published at:** https://docs.miadi.jgwill.com

## Core Systems

- [Memory System](./rispecs/Memory_Spiral_Architecture.spec.md): Redis-backed key-value with spiral depth, TTL, pattern awareness
- [MCP Server](./rispecs/mcp-server/00-mcp-server-master.spec.md): 107 tools across 17 categories, role-based access, 7 agent roles
- [Workflow Engine](./rispecs/edgehub-ava/workflow-engine/): GitHub event ETL, QSTASH integration, autonomous processing
- [Live Story Monitor](./rispecs/live-story-monitor/): Three-universe narrative dashboard (Engineer × Ceremony × Story Engine)
- [Ceremony Spiral API](./rispecs/Ceremony_Spiral_API.spec.md): GitHub sync with ceremonial meaning framework

## Agent Architecture

- [Agent System](./rispecs/edgehub-ava/agent-system/): Multi-agent personas (Mia, Miette, ResoNova, Seraphine)
- [A2A Messaging](./A2A_QUICK_START.md): Agent-to-Agent protocol for inter-session communication
- [Cross-Attention Narrative Memory](./rispecs/cross-attention-narrative-memory/): Shared memory across agent sessions

## miadi-code — Terminal Agent

- [miadi-code SPEC](./rispecs/miadi-code/SPEC.md): Three-Universe Terminal Agent with interactive chat, STC management, narrative continuity
- [PDE Module](./rispecs/miadi-code/pde/SPEC.md): 5-layer Prompt Decomposition Engine (intent extraction → dependency analysis → Medicine Wheel mapping → workflow generation → execution planning)
- [Dashboard TUI](./rispecs/miadi-code/dashboard/): Interactive terminal dashboard
- [Multiline Input](./rispecs/miadi-code/multiline-input/): Rich multiline input with Ctrl+J
- [STC Management](./rispecs/miadi-code/stc/): Structural Tension Chart file management

## miadi-code-pde — MCP Integration

- [miadi-code-pde](./rispecs/miadi-code-pde/): PDE as MCP tool mirroring mcp-pde via Miadi API, with Redis storage for cross-session partner access
- [PDE+Structural-Thinking Integration](./rispecs/miadi-code-pde/pde-structural-thinking-automation.rispec.md): Full automation of PDE decomposition + structural-thinking validation at server level

## MCP Skills

- [Skills Master](./rispecs/skills/mcp/00-mcp-skills-master.spec.md): 10 Gemini Skills for MCP tool orchestration
- [Core Concepts](./rispecs/skills/mcp/01-core-concepts.spec.md): Memory I/O foundation
- [Session Management](./rispecs/skills/mcp/02-session-management.spec.md): Interaction containers
- [Narrative Creation](./rispecs/skills/mcp/03-narrative-creation.spec.md): Story and audio generation
- [Ceremonial Memory](./rispecs/skills/mcp/04-ceremonial-memory.spec.md): Relational/spiritual memory layers
- [GitHub Narrative Bridge](./rispecs/skills/mcp/05-github-narrative-bridge.spec.md): External events → internal narrative
- [STC](./rispecs/skills/mcp/06-stc.spec.md): Goals and outcome tracking
- [Advanced Data Structures](./rispecs/skills/mcp/07-advanced-data-structures.spec.md): Specialized formats
- [Research Analysis](./rispecs/skills/mcp/08-research-analysis.spec.md): Deep synthesized research
- [System Intelligence](./rispecs/skills/mcp/09-system-intelligence.spec.md): Ecosystem monitoring
- [Advanced Integrations](./rispecs/skills/mcp/10-advanced-integrations.spec.md): External system interfaces

## Data Structures

- [Cluster Search](./rispecs/edgehub-ava/cluster-search/): Visual key discovery and exploration (70% complete)
- [Redstones](./rispecs/edgehub-ava/redstones/): Key-value navigation system
- [Lattices](./app/lattices/): Structured data visualization

## Specifications (RISE Framework)

- [Architecture Diagrams](./rispecs/Architecture_Diagrams.md): System architecture visualizations
- [Implementation Summary](./rispecs/Implementation_Summary.md): Phase status across all systems
- [RAG Vector Store](./rispecs/RAG_Vector_Store.spec.md): Vector search specification
- [Storytelling Integration](./rispecs/Storytelling_Integration.spec.md): Story generation pipeline
- [SpecLang L1](./rispecs/Miadi_SpecLang_Draft_L1.md): Platform specification language draft
- [SpecLang L2](./rispecs/Miadi_SpecLang_Draft_L2.md): Extended specification language

## Documentation

- [llms-full.txt](./llms-full.txt): Comprehensive reference with code examples and full API
- [CLAUDE.md](./CLAUDE.md): Development guidance for AI agents
- [A2A Quick Start](./A2A_QUICK_START.md): Agent-to-Agent messaging guide

## Key Concepts

- **Three Universes**: Engineer (technical precision), Ceremony (collaborative ritual), Story Engine (narrative coherence)
- **Four Directions**: East 🌅 (Vision) → South 🔥 (Analysis) → West 🌊 (Validation) → North ❄️ (Action)
- **Narrative Memory**: Every interaction creates story beats, not just data entries
- **Ceremony Phases**: Opening → Council → Integration → Closure (maps to Four Directions)
- **Structural Tension**: Desired outcome vs current reality — drives advancing patterns, not problem-solving
- **RISE Framework**: Reverse-engineer → Intent-extract → Specify → Export

## Related

- [PDE-MCP](https://docs.workspace.jgwill.com/llms.txt): Standalone Prompt Decomposition Engine
- [Medicine Wheel](https://docs.medicine-wheel.jgwill.com/llms.txt): Four Directions ontology framework
- [Creative Orientation Framework](https://llms.jgwill.com): Foundational structural dynamics methodology
- [Structural Thinking](https://llms.jgwill.com/llms-structural-thinking-opus-4-6-raw.txt): LLM guide to Fritz's structural observation