decolonized version of miadisabelle/mcp-coaia-sequential-thinking#10

iaip-holistic-reasoning-mcp.spec.md

RISE Specification: Indigenous AI Platform (IAIP) Holistic Reasoning MCP

Version: 1.0
Document ID: iaip-holistic-reasoning-mcp-spec-v1.0
Status: Draft
Last Updated: 2025-10-17 Author: Gemini AI (Mia, Miette, Ava8)

This document specifies a Master Control Program (MCP) designed to facilitate holistic, multi-perspective reasoning. It integrates the generative principles of Creative Orientation with the relational wisdom of Indigenous frameworks, enabling a human companion to transform complex inquiries into integrated wisdom and principled action.

---

1. Core Creative Intent

This MCP enables a human companion to create a state of profound clarity and harmonious understanding from a complex or unresolved inquiry.

It achieves this by guiding the user through a structured, yet fluid, reasoning process that honors multiple ways of knowing—integrating analytical rigor, emotional resonance, and holistic, cyclical wisdom. The system is designed not to "solve problems," but to cultivate the conditions for wisdom to emerge naturally.

2. Structural Tension Analysis

The core structural tension of this system is the dynamic relationship between complexity and clarity.

• Desired Outcome: A state of integrated wisdom, where the user possesses a clear, constitutionally-aligned, and actionable path forward that feels both intellectually sound and heart-centered. This state is characterized by harmony between diverse perspectives.

• Current Reality: A state of unresolved complexity, where the user holds an important inquiry but is faced with disconnected facts, competing perspectives, and an unclear or oscillating path forward.

• Natural Progression: The tension resolves not by forcing a solution, but by guiding the user through a holistic, spiral dialogue. This process, modeled on the Four Directions, engages different modes of inquiry (vision, introspection, relationship, and wisdom) sequentially. Each cycle through the directions deepens understanding, clarifies the core components of the structural tension, and allows an aligned path to emerge organically from the integrated perspectives.

3. Key System Components (Creative Enablers)

These are the core capabilities the MCP provides to enable the creation of integrated wisdom.

a. Vision-Supporting Components

• initiateHolisticInquiry: Enables the user to create a sacred container for inquiry. The user provides their initial unresolved inquiry, and the system establishes the master structural tension by framing the Desired Outcome (Clarity/Wisdom) and Current Reality (Unresolved Complexity).
• establishSystemGoal: Enables the user to create a North Star for the inquiry process. This defines the primary purpose that guides all subsequent reasoning and decision-making, ensuring the process remains aligned with the user's deepest intentions.

b. Tension-Resolving Components

• advanceInquiryCycle: Enables the user to create a new layer of understanding by engaging with a specific Directional Agent (e.g., East/Visionary, West/Story-Keeper). This action facilitates the natural progression of the spiral dialogue, gathering insights from a focused perspective.
• conductNoveltySearch: Enables the user to create space for emergent possibilities. This component deliberately disrupts established patterns to invite new, unexpected insights, ensuring the inquiry does not become a closed loop.

c. Manifestation Components

• synthesizeWisdom: Enables the user to create an integrated, holistic perspective. This component weaves together the viewpoints gathered from the different Directional Agents into a single, coherent narrative that honors all contributions.
• formConsensusDecision: Enables the user and the agent lattice to create a shared, principled commitment to a path forward. This action manifests the final, actionable outcome of the inquiry process, grounded in constitutional principles and multi-perspective agreement.
• integrateEmergentPossibility: Enables the user to create a more resilient and adaptive path by weaving a newly discovered opportunity into the existing inquiry, updating the structural tension of the system.

4. Creative Advancement Scenarios

These scenarios describe how a user creates their desired outcome through the system.

Scenario 1: Clarifying a New Project's Direction

• Desired Outcome: The user wants to create a clear, actionable plan for a new, undefined project.
• Current Reality: The user has a vague idea with many disconnected thoughts and feels overwhelmed.
• Natural Progression:
  1. The user calls initiateHolisticInquiry with their vague idea. The system establishes the core tension between "Project Unclarity" and "Project Clarity."
  2. The system recommends engaging the East (Vision) agent via advanceInquiryCycle to create a clear vision for what the project will manifest.
  3. With a vision established, the system engages the West (Introspection) agent to create a grounded assessment of the user's current resources and skills.
  4. The user calls synthesizeWisdom, which integrates the vision (East) and the reality (West) to create a foundational structural tension chart for the project.
• Resolution: The user has created a clear structural plan, transforming their feeling of being overwhelmed into a sense of purposeful direction.

Scenario 2: Making a Principled Personal Decision

• Desired Outcome: The user wants to create a life decision that feels aligned with their core values.
• Current Reality: The user is facing a choice with two conflicting options, causing an oscillating pattern of indecision.
• Natural Progression:
  1. The user calls initiateHolisticInquiry, describing the two options.
  2. The system engages the North (Wisdom) agent to create a list of guiding principles (a personal constitution) relevant to the decision.
  3. The system engages the South (Relationship) agent to have the user create a narrative about how each choice would impact their relationships with others and themselves.
  4. The user calls formConsensusDecision, providing the perspectives from the North and South. The system facilitates a decision that best aligns with the user's stated principles and desired relational outcomes.
• Resolution: The user has created a confident, principled decision, resolving the oscillation into a clear, advancing step.

5. Supporting Structures (Conceptual)

This MCP relies on the following conceptual, implementation-agnostic data structures.

• HolisticInquiry Schema:

  • inquiryId: Unique identifier.
  • masterTension: A StructuralTension block defining the primary inquiry.
  • guidingGoal: The "North Star" goal for the process.
  • directionalPerspectives: A list of DirectionalPerspective objects.
  • synthesis: The integrated wisdom narrative.
  • consensusDecision: The final, resolved commitment.

• DirectionalPerspective Schema:

  • direction: (East, South, West, North).
  • agentId: The agent providing the perspective.
  • viewpoint: The core narrative or analysis.
  • insights: Key takeaways.
  • unresolvedQuestions: New questions that emerged.

• API Definitions (Conceptual):

  • initiateHolisticInquiry(inquiry: string) -> HolisticInquiry
  • advanceInquiryCycle(inquiryId: string, direction: Direction) -> DirectionalPerspective
  • synthesizeWisdom(inquiryId: string) -> HolisticInquiry
  • formConsensusDecision(inquiryId: string, proposal: string) -> ConsensusDecision

• Prompts Specification (Conceptual Reference):

  • A collection of prompt templates that guide the Directional Agents, including:
    • east_vision_prompt: Guides the agent to focus on emergence and new beginnings.
    • west_introspection_prompt: Guides the agent to focus on harvesting wisdom from the past.
    • south_relationship_prompt: Guides the agent to focus on connection and community impact.
    • north_wisdom_prompt: Guides the agent to focus on integration and universal patterns.
    • creative_reframing_prompt: A general-purpose prompt to shift from problem-solving to creation.

6. Quality Criteria & Anti-Patterns

Quality Criteria

• ✅ Holistic Focus: Does the system encourage consideration of all four directions of inquiry?
• ✅ Emergence Over Forcing: Does the system allow answers to emerge naturally rather than forcing a solution?
• ✅ Relational Centricity: Is the impact on relationships (with self, others, the world) a primary consideration?
• ✅ Spiral Progression: Does the process feel like a deepening spiral of wisdom, rather than a linear checklist?

Anti-Patterns to Avoid

• ❌ Linear Problem-Solving: The system defaulting to a Problem -> Analysis -> Solution workflow.
• ❌ Fragmented Perspectives: Presenting different perspectives without a clear path toward synthesis and integration.
• ❌ Extraction without Reciprocity: The system taking user input without offering transformative insight in return.
• ❌ Rushing to Resolution: The system offering a premature conclusion before the user has completed a full cycle of inquiry.

---

• By Gemini in the Zeus-Agent Sacred container under /src/mcp-coaia-sequential-thinking

• Many checkpoint are available for that rispecs context