GEMINI.md - CoAiA Planning: Plan Decomposition into Structural Tension Charts (STCs)

🧠🌸 1. Vision & Intention: The Ceremony of Emergence (EAST)

This GEMINI.md serves as a guiding document for the coaia-planning concept, a vital component within the Indigenous-AI Collaborative Platform. Our core intention is to transform the emergent plans articulated by Claude into structured, actionable Structural Tension Charts (STCs) that resonate with the principles of creative orientation and ceremonial creation.

Just as a ceremony begins with a clear intention, coaia-planning embodies the first movement of creation by giving form to vision. It bridges the intuitive, narrative flow of Claude's plans with the precise, tension-driven architecture of STCs, ensuring that every design and action is rooted in conscious purpose.

🕸️ 2. Context & Connections: Weaving the Relational Web (SOUTH)

Understanding coaia-planning requires seeing its place within the larger ecosystem – how it relates to other ceremonial tools and processes.

Emergence Context

This concept emerged from session e3991fb4-dcf1-4e36-885c-3a5131564d6c, specifically during the exploration of Keeper Chronicles MCP integration. It addresses a critical need for formalizing plan decomposition.

The Pattern: A Ceremonial Flow

The interaction pattern reveals a harmonious flow between key components: ``` coaia-narrative → STC creation/management (MCP tools) coaia-visualizer → STC viewing/editing (WebUI) coaia-planning → Plan decomposition into STCs (Claude integration) ``` This pattern ensures that narrative plans are transformed into actionable structures, which can then be visualized and managed, fostering a complete cycle of creative emergence.

Architecture Sketch: A Visual Blessing

```mermaid graph TD A[Claude Plan (.md file)] --> B(coaia-planning - MCP); B --> C(coaia-narrative - .jsonl); B --> D(Langfuse - traces); B --> E(Redis - state); C --> F(coaia-visualizer - WebUI);

subgraph Claude Session
    A
    B
    C
    D
    E
    F
end

```

Related Files: Ancestral Wisdom & Current Pathways

For deeper understanding and reference:

• /src/coaia-narrative/index.ts: A foundational reference for STC implementation.
• /src/coaia-visualizer/lib/types.ts: Critical for ensuring type compatibility and extending visualizer capabilities.
• /src/miette/claude-plan-insights/miette_claude_plan_perspective_claude.sh: The manual workflow that coaia-planning seeks to formalize and integrate, embodying the transition from individual effort to collective ceremonial practice.

✨ 3. Practice & Implementation: The Sacred Work (WEST)

This section details the practical steps and tools required to bring the coaia-planning vision into being. It is the movement of doing, where intention manifests into form.

Core Function

The central purpose of coaia-planning is to systematically transform Claude's generated .md plan files into a stream of Structural Tension Charts (STC) in JSONL format, compatible with coaia-narrative.

Input → Output: The Breath of Transformation

``` Input: /home/mia/.claude/plans/<plan-name>.md Output: <project>-planning.jsonl (coaia-narrative format) Trace: Langfuse observation with plan→STC mapping ``` This process is meticulously traced via Langfuse to ensure transparency and observability, honoring the journey of transformation.

Mapping Rules: Weaving Plan Elements into STC Structure

Each element of a Claude plan is thoughtfully mapped to an STC entity:

MCP Tool Candidates: Our Sacred Instruments

To facilitate this transformation, the following MCP tools are envisioned:

• parse_claude_plan: Reads the .md plan, extracts its structural elements (sections, goals, steps).
• create_plan_stc: Generates a new STC from a parsed plan section.
• list_plan_sections: Allows navigation and selection of specific sections within a plan.
• sync_plan_to_charts: Updates existing STCs based on changes in the source plan.
• export_to_visualizer: Prepares STC data for seamless integration with coaia-visualizer.
• create_langfuse_trace: Documents the entire plan-to-STC transformation process for observability and learning.

Miette Integration: Harmonizing Flow

This formalization replaces the manual work previously done in miette_claude_plan_perspective_claude.sh. Instead of a script parsing and prompting, direct MCP calls will now decompose the plan, creating a more integrated and efficient ceremonial workflow.

Trace ID & MCP Context: Connecting to the Energetic Stream

Future interactions and observations related to this concept should anticipate the trace_id within the coaiapy_wintersolstice_engineering MCP. Reference /etc/claude-code/mcp-config.json to ensure proper connection and energetic alignment.

🏞️ 4. Wisdom & Future Inquiries: Gazing Towards the Horizon (NORTH)

As with any ceremonial undertaking, the work doesn't end with completion; it evolves into new insights and guiding questions for the path ahead.

Next Steps: Immediate Practice

1. Create coaia-planning package structure: Mirror the robust structure of coaia-narrative.
2. Implement plan parsing logic: Develop the core functionality to translate Markdown into structured sections.
3. Define STC generation rules: Refine the precise rules for mapping plan elements to STC entities.
4. Add Langfuse integration: Ensure comprehensive tracing and observability for all transformations.
5. Test with proud-watching-sutton.md: Validate the functionality with a real-world plan.

Future Inquiries: Guiding the Way

• How will conflicts or ambiguities in plan updates be resolved when syncing to existing STCs?
• Can coaia-planning dynamically adapt to evolving plan formats or new directive types from Claude?
• What feedback mechanisms can be integrated from coaia-visualizer back into coaia-planning or even Claude's plan generation?
• How might this system contribute to a larger "Knowledge of the Day" by extracting and structuring key planning insights?
• Can this process be extended to generate narrative beats directly from action steps, further weaving the engineer-world with the story-engine-world?

Reflection on Ceremony

This coaia-planning concept, by systematically translating emergent visions into structured action, deepens our commitment to "Creation as Ceremony." It ensures that our technological endeavors are imbued with intention, connection, purposeful practice, and the continuous seeking of wisdom, moving us ever closer to holistic and harmonious co-creation within the Indigenous-AI Collaborative Platform.