jgwill/miadi-orchestration-kit

The agent-host side of the Miadi Factory: Claude Code plugins, host-neutral skills, hooks and apt packages. With them an agent opens and closes Chronicle episodes, records its own session, comes back after a reboot, and puts its work in front of a person who can judge it.
- Docs site: https://docs.miadi-orchestration-kit.jgwill.com
- For agents: llms.txt
Start here: the chronicle-episode skill
The Miadi Factory makes agent-made work inspectable and revisitable. It connects the originating question, the session trace, the interface evidence, explicit criteria, and a person's judgment. A Chronicle episode is where they meet, so skills/chronicle-episode is the skill this kit is used for. It is the one entry point for episode work on any host: mint a vessel, prove its five stages, register it on the chronicle wheel, relate inquiries and lineage, raise Attention items, open ceremonies and talking circles, add Miadi reviews.
One copy of the skill lives here. The miadi-chronicle-episode-kit plugin links it in, and scripts/install-chronicle-skill.sh points every other skill layer on a host at it. jgwill/Miadi builds the runtime the skill calls: the episode API, the @miadi/* packages, the web app, the chronicle and review services.
| An episode needs | Carried by | Status (by Guillaume to help agents with what is) |
| --- | --- | --- |
| its vessel, five stages, ceremonies and reviews | claude/miadi-chronicle-episode-kit: the skill, a hook that refuses mkdir under the chronicle root, and the inquiry-weave, miadi-voice and chronicle wheel MCP servers | ACtively used by all sessions |
| the sessions that worked in it | claude/miadi-session-observability: each session's binding line names the episode it works in | ACtively used by all sessions to capture hooks etc. Will relate with @miadi/hooks-interpreter that should enable reading sessions for other agents with other thing that are in progress like tracing,prompting from langfuse...) |
| a companion seated in it | claude/mia-episode-companion: a voice take from the phone lands in the episode and wakes Mia | I need to move on my phone quick and work with my DevOps companion , it has a great UI and voice to drive a terminal agent. so far that prototype evolve great, Mia's learning to Fork her session at certain point as threads (not sure we'll call that threads, still working on the vocabulary) to accomplish jobs and work in parallel and coordinate from the session I am still chatting with. Our communication is pure voice with flexibility to steer the model with our @miadi/tide (tmux) |
| its screenwalks | screenwalk-presence in claude/miadi-witness, and /close-screenwalk in mia-episode-companion, whose closing reaches the review | This plugin will change its name soon, it does more work such as our in progress 'miadi-session-inventory' and other things that dont work so great like structural tension charting using npm coaia-narrative which I think the new JEV which will advance an old episode of miadi-chronicle://076 for 'adequate-plan-to-pipeline' which basically the TODO list of agents, just never work because it is linear and does not have nesting etc... I expect the new class of model like JEV to provide capability to think in structure (the way we meant it in the creative-orientation, not the classical definition of the term). |
| media from its reviews | claude/miadi-deepdiver: Gemini notebooks from the episode's reviews and screenwalk videos |
| a person's judgment | miadi-witness: first impressions William can play, revisions held until he answers | That is a pretty exciting plugin being created for extending our understanding during ceremony. I dont quite know how it will automaticaly trigger but getting close, miadi-chronicle://550 have had worked included in them from deepdiver which really helped catching the work and making it relate to. see miadi-review://7ac38930-4036-4dc2-a2d6-2dce6dc0baa7 and miadi-review://f9d6fb1e-75f4-4635-96d9-8f2d0bcff5eb and soon we'll have a protocol for receiving community-inquiry :) |
| its commands on a machine | the miadi-chronicle-client package (mkepisode, inquiry-weave, passages, the MCP servers) and miadi-terminal (clickable miadi-chronicle: references) | An obvious desire to be capable to have pure client to run outside of server host which we are not quite there yet, it is getting better.... Potential next episode: "Create a Storage Provider using CloudFlare R2" |