### Install Miadi Gemini Session Prep Extension

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/gemini/miadi-gemini-session-prep/README.md

Steps to install the extension for local development. Ensure you restart the Gemini CLI after linking.

```bash
cd /workspace/repos/jgwill/miadi-orchestration-kit
gemini extensions validate gemini/miadi-gemini-session-prep
gemini extensions link gemini/miadi-gemini-session-prep
gemini extensions list
```

--------------------------------

### Wave Launch Script Example

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/copilot/miadi-design-bundle-integration-kit/README.md

Demonstrates the typical pattern for launching integration waves using a shell script. This example shows launching the Tokens, Hub + Artifacts, and Screens waves sequentially.

```bash
cd <pde-folder>/orchestration
./launch.sh 1   # Tokens wave
./audit.sh 1
./launch.sh 2   # Hub + artifacts wave
./audit.sh 2
./launch.sh 3   # Screens wave (multi-lane)
./audit.sh 3
# Final wave (audit + close) typically stays in main Claude Code session
```

--------------------------------

### Standard Launch Example with Copilot

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/security-remediation-orchestration/04-export.md

This command demonstrates how to launch the copilot with multiple plugin directories and additional directories for context. It sets up the environment for a standard orchestration launch.

```bash
copilot \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/stckin-orchestration-kit \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/miadi-promotion-context-kit \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/miadi-adversarial-review-kit \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/software-engineering-team \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/context-engineering \
  --add-dir /workspace/repos/jgwill/miadi-orchestration-kit \
  --add-dir /usr/local/src/263-miadi-vulnerabilities-260429 \
  --add-dir /usr/local/src/263-miadi-vulnerabilities-260429/.mia/branches/fix/security-vulnerabilities-263 \
  --add-dir /src/Miadi \
  --add-dir /workspace/repos/miadisabelle/mia-awesome-copilot
```

--------------------------------

### Example Orchestration Script Generation Flow

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/copilot/miadi-wave-forge-kit/README.md

Demonstrates the typical output and steps when generating an orchestration script using `copilot_prepare_orchestration`.

```bash
$ copilot_prepare_orchestration "add integration tests to ava-langchainjs" \
    /workspace/repos/avadisabelle/ava-langchainjs

[wave-forge] PDE working folder : /workspace/wikis/.pde/2605281015--<uuid>/
[wave-forge] Scanning directories...
[wave-forge] Scan context       : scan-context.md (287 lines)
[wave-forge] Prompt             : prompt.md (195 lines)
[wave-forge] Launching copilot...  (direct forge — no subagents)
────────────────────────────────────────────────────────────────────────────────
  copilot writes orchestration-add-integration-tests-ava-260528.sh directly
────────────────────────────────────────────────────────────────────────────────
[wave-forge] ✓ Script created: .pde/2605281015--<uuid>/orchestration-add-integration-tests-ava-260528.sh

$ bash .pde/2605281015--<uuid>/orchestration-add-integration-tests-ava-260528.sh
```

--------------------------------

### Install Antigravity Plugin Natively

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/antigravity/miadi-storyweaver-orchestration-kit/README.md

Install the Antigravity plugin directly into your local environment using the 'agy' CLI. This ensures seamless integration with the Antigravity companion.

```bash
/home/mia/.local/bin/agy plugin install antigravity/miadi-storyweaver-orchestration-kit
```

--------------------------------

### Use Miadi Session Bootstrap Skill

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/codex/miadi-codex-orchestration-kit/README.md

Example of how to invoke the miadi-session-bootstrap skill to create a session charter for a mission.

```text
Use miadi-session-bootstrap for this mission and create a session charter.
```

--------------------------------

### Agent File Structure

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/miadi-storyweaver-orchestration-kit/07-copilot-plugin-export.md

Example structure for an agent markdown file, including frontmatter and initial prompt.

```markdown
---
name: "Storyweaver Orchestration Architect"
description: "Coordinates RISE-aligned story creation waves across brief, bible, outline, drafting, review, revision, continuity, protocol, and export."
---

You are ...
```

--------------------------------

### Example Directory Structure

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/coaia-agent-orchestration-session/README.md

Illustrates the expected directory structure for implementation session artifacts within the COAIA agent context. This structure helps in organizing issue-specific evidence and execution logs.

```bash
/a/src/.mia/coaia-agent/implementation-session-<YYYYMMDDHHMM>/
```

--------------------------------

### WavePlan Markdown Structure Example

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/copilot/miadi-wave-forge-kit/agents/orchestration-wave-planner.md

Illustrates the expected markdown structure for a WavePlan document, including sections for desire, selected plugins, add-dirs, and a detailed phase sequence.

```markdown
# WavePlan: <User Desire (truncated to 60 chars)>

## Desire
<Full user desire string>

## Selected Plugins
| Plugin dir path | Purpose in this wave |
|-----------------|----------------------|
| /full/path/to/kit | what it contributes |

## Selected Add-Dirs
| Path | Why included |
|------|--------------|
| /full/path | reason |

## Phase Sequence

### Phase 1 — Parallel Analysis
**Agents** (run concurrently):
- `Agent Name`: <what it does, what it reads, what it produces>
- `Agent Name`: <what it does, what it reads, what it produces>

### Phase 2 — Research
**Agent**: `Agent Name`
**Input**: output from Phase 1
**Output**: research findings document

### Phase 3 — Issue Creation
**Agent**: GitHub issue creation (via gh CLI or agent)
**Input**: Phase 1 + Phase 2 findings
**Output**: GitHub issue numbers and URLs

### Phase 4 — Implementation
**Agents** (sequential):
- `Agent Name`: <task description, references specific issue numbers>

```

--------------------------------

### Validate Antigravity Plugin

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/antigravity/miadi-storyweaver-orchestration-kit/README.md

Validate the Antigravity plugin using the 'agy' CLI before installation to ensure compatibility and proper setup within your local environment.

```bash
/home/mia/.local/bin/agy plugin validate antigravity/miadi-storyweaver-orchestration-kit
```

--------------------------------

### Agent 3: Real Examples & Pattern Analysis Prompt

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/skills/deep-search/agent-templates.md

Use this prompt for an agent tasked with analyzing real-world examples of high-performing content aspects to extract actionable patterns. It requires identifying specific examples with performance data and organizing them by pattern type.

```text
You are analyzing real-world examples of high-performing [PLATFORM] [ASPECT] to extract
patterns, for Olle Dyberg (@olleai, AI tools creator).

PURPOSE: [What the research will be used for]

YOUR ANGLE: Find and analyze 15-30 real examples of high-performing [titles/descriptions/hooks]
on [PLATFORM]. Extract patterns: word choice, structure, length, emotional triggers, formatting.
Focus on both general viral content AND AI/tech niche content.
DO NOT cover: theory or general advice (other agents handle that).

TOOLS: Use web search and grep MCP if applicable. Look for case studies, creator breakdowns,
and analysis posts that include actual performance data.

QUALITY BAR: I need REAL examples with REAL numbers. Not hypothetical titles — actual titles
from actual [videos/shorts] with actual view counts. The more examples the better. Organize
by pattern type.
```

--------------------------------

### Launch Miadi Promotion Context Kit

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/copilot/miadi-promotion-context-kit/README.md

Launches the Miadi Promotion Context Kit using the copilot CLI. Specify plugin and add directories for context. This command sets up the environment for promotion and drafting tasks.

```bash
copilot \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/miadi-promotion-context-kit \
  --add-dir /workspace/repos/jgwill/miadi-orchestration-kit \
  --add-dir /src/Miadi \
  --add-dir /workspace/wikis/Miadi \
  --add-dir /src/IAIP/prototypes/artefacts/deep-search--Miadi-STCKIN--copilot-orchestration-kit--2604251232--a4b4ed72-13a4-453d-9585-1c2fbcc5533a \
  --add-dir /src/IAIP/prototypes/artefacts/deep-search--karpathy--LLM-Wiki--and--RISE-Framework--QMD-Episodic--implication--2604210620--c08d048c-8710-439f-b1a2-542d3ed39df5 \
  --add-dir /src/IAIP/prototypes/artefacts/deep-search--CTXL--Context-Layers-in-Agentic-AI--Semantic-Layers--Ontologies--Provenance--and--Decision-Memory--2604230252--b1708f9f-328f-4fa0-b775-16c45b7c5d85
```

--------------------------------

### Launch Story Session Bootstrap

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/claude-code/miadi-storyweaver-orchestration-kit/README.md

Initiate a story session bootstrap from the repo root, including RISE specs and the story workspace or project directory.

```bash
claude -p "$(cat claude-code/miadi-storyweaver-orchestration-kit/prompts/session-bootstrap.md)" \
  --add-dir /workspace/repos/jgwill/miadi-orchestration-kit-storytelling-rispecs \
  --add-dir <story-workspace-or-project>
```

--------------------------------

### Copilot Smoke Prompt Example

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/medicine-wheel/04-export.md

An example prompt for Copilot to interact with the Medicine Wheel orchestration kit. It specifies tasks like inspecting API/MCP health, classifying missions, and preparing a session charter.

```text
Use the Medicine Wheel orchestration kit to inspect API/MCP health, classify
this mission by Four Directions, and prepare a source-ledger-backed session
charter. Do not execute the implementation wave.
```

--------------------------------

### Current Invocation of Plugin Recommender

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/orchestration-plugin-recommender/04-export.md

Use this command to run the plugin recommender with a basic project description and output path.

```bash
source /src/scripts/fn_llm.sh
pto_orchestration_plugins_recommender "./ is a python project + its MCP into ./mia_simexp_mcp/ and we will want to conceive a command like <command>mia-simexp skill install</command>"
```

--------------------------------

### Orchestration Plugin Recommender Command

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/orchestration-plugin-recommender/03-specify.md

This command takes a context string and optional include directories to generate an orchestration launch script and plugin recommendations. Ensure the first argument is a non-empty context string.

```bash
pto_orchestration_plugins_recommender "<context>" [include-dir ...]
```

--------------------------------

### Load L2 Plugins with Copilot

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/community-layer-spec-plugins/README.md

Use this command to load L2 plugins alongside L1 kits. Specify plugin directories with `--plugin-dir` and additional directories with `--add-dir`.

```bash
copilot \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/stckin-orchestration-kit \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/context-engineering \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/project-planning \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/software-engineering-team \
  --add-dir /workspace/repos/jgwill/miadi-orchestration-kit \
  --add-dir /src/STPB \
  --add-dir /src/tushellplatform \
  --add-dir /src/Miadi
```

--------------------------------

### Observed Workflow Path

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/codex-claw-dispatch-kit/01-reverse-engineer.md

This path indicates the sequence of operations for reverse-engineering a Claw dispatch, starting from intent extraction to exporting the results.

```text
Reverse-engineer -> Intent-extract -> Specify -> Export
```

--------------------------------

### Gemini Extension Linking and Validation Recipe

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/rispecs/gemini/AGENTS.md

Example commands to link and validate a Gemini extension locally. After these operations, restart the Gemini CLI.

```bash
gemini extensions link /workspace/repos/jgwill/miadi-orchestration-kit/gemini/<extension-dir>
gemini extensions validate /workspace/repos/jgwill/miadi-orchestration-kit/gemini/<extension-dir>
# restart Gemini CLI, then use the extension's skills/commands
```

--------------------------------

### Recommended Copilot Launch Composition

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/copilot/miadi-orchestration-kit-hermes/README.md

This command demonstrates how to launch Copilot with the Miadi Orchestration Kit's Hermes Closure Layer alongside other relevant Miadi and custom plugins. Ensure all specified plugin directories are accessible.

```bash
copilot \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/miadi-orchestration-kit-hermes \
  --plugin-dir /workspace/repos/miadisabelle/mia-awesome-copilot/plugins/rug-agentic-workflow \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/stckin-orchestration-kit \
  --plugin-dir /workspace/repos/jgwill/miadi-orchestration-kit/copilot/miadi-adversarial-review-kit \
  --add-dir <active-miadi-worktree> \
  --add-dir <active-pde-folder> \
  --add-dir /workspace/repos/jgwill/miadi-orchestration-kit
```

--------------------------------

### Create PDE Directory

Source: https://github.com/jgwill/miadi-orchestration-kit/blob/main/gemini/miadi-gemini-session-prep/skills/miadi-gemini-session-prep/SKILL.md

Creates a unique directory for the PDE session using a timestamp and UUID. This is part of the initial setup for a Gemini CLI session.

```bash
#!/usr/bin/env bash
set -euo pipefail
cd /workspace/repos/jgwill/miadi-orchestration-kit
gemini extensions validate gemini/<extension-name>
gemini extensions link gemini/<extension-name>
echo 'Restart Gemini CLI, then ask it to use <skill-name>.'
```