
harmoge
Bring a direction, a design or an implementation to what you intend through concrete cases, until the solution space shown is enough for your purpose — /fit (ἁρμογή: a fitting together)
- GitHub stars
- 177
Add marketplace
/plugin marketplace add jongwony/epistemic-protocolsRun it inside Claude Code once, then install the plugin below.
Install
/plugin install harmoge@epistemic-protocolsRun it inside Claude Code after adding the marketplace.
From the jongwony/epistemic-protocols README
Epistemic Protocols
When AI collaboration goes off-track, you redo everything. These protocols bring the decisions that set the direction to you early — often at the plan level, before a wrong one hardens into code or other downstream work — and leave each one yours to settle.
A prompt that already states everything that matters can work nearly as well, but writing it means recalling every unknown up front. With a protocol, the AI asks questions or shows candidates at the right point, and you answer or recognize what fits.
Watch three agents handle the same request with and without /elicit (click for the video):
Companies, reasons and numbers in the clip are illustrative, not a run result.
Watch /inquire check the sources for next week's churn meeting and return what it confirmed, what conflicts, what it could not reach, and what only you decide (click for the video):
Meetings, sources and numbers in the clip are illustrative, not a run result.
Quick Start
Claude Code
Install every protocol, together with the route plugin:
curl -fsSL https://raw.githubusercontent.com/jongwony/epistemic-protocols/main/scripts/install.sh | bash
route gives the agent the information it needs to choose a protocol for your conversation and find relevant collaboration principles when needed. It is experimental; its wording and hooks can change between releases. To disable it, run claude plugin disable route@epistemic-protocols after installing — every protocol stays installed. You can always type a command yourself, such as /inquire before handing off work or /bound when you are unsure which decisions are yours.
Not sure which protocol to start with? Clone this repository and start /onboard from inside it. It recommends a protocol from your recent sessions, and can go on to teach the protocols through a scenario, a trial and a quiz.
git clone https://github.com/jongwony/epistemic-protocols.git
cd epistemic-protocols
claude /onboard
Codex
From GitHub:
curl -fsSL https://raw.githubusercontent.com/jongwony/epistemic-protocols/main/scripts/install-codex.sh | bash
From a local checkout:
codex plugin marketplace add /path/to/epistemic-protocols
A checkpoint shows what you need to decide and what each answer changes. In a non-interactive codex exec run, work may already have started when you see it.
Other agent tools
The Codex marketplace lives at .agents/plugins/marketplace.json; each plugin keeps its Codex manifest beside its Claude manifest at <plugin>/.codex-plugin/plugin.json.
Protocol skill sources live in each plugin directory under <plugin>/skills/<name>/SKILL.md. The repository does not ship a pre-materialized .agents/skills/ symlink view because Codex marketplace discovery can scan both plugin manifests and Agent Skills symlinks, producing duplicate skill entries.
Hosts that need an Agent Skills-style view should materialize it outside the Codex marketplace checkout or use host-specific packaging. Runtime tool grounding still varies by tool, so protocol behavior in non-Claude-Code hosts is provisional pending accumulated cross-host use evidence.
Protocols
You can also use a protocol when handing off work, checking whether a result fits your situation, finding an earlier discussion, or making sense of something you need to use.
| Command | When to use |
|---|---|
/inquire | Your task is missing context or relies on unchecked assumptions, and you need to see what remains unknown |
/elicit | You know roughly what you want, but can't yet say what should change |
/ideate | You want to open up the options, widen a list that narrowed too soon, or return to ideas you explored earlier |
/preview | You're choosing between directions and need to see what each would look like before deciding |
/sketch | You cannot describe what you want to make in advance, but you will recognize it when you see it |
/fit | You know the goal and need concrete cases to see where a design or implementation fits and where it needs to change |
/ground | You're applying an analogy or earlier design to a new case, or checking a general claim against its examples, and want to know which conclusions follow |
/induce | You suspect several cases have something in common, and either it has no name yet or the old name no longer fits |
/apportion | You're handing a goal to an autonomous run and want to split it into units that each fit one stretch of the run and have a clear completion check |
/contextualize | A result may have missed something you said or decided, or may not fit the situation where you'll use it |
/bound | You cannot yet see what a task rests on — what is settled and by whose judgment, or which decisions to keep versus delegate |
/recollect | You vaguely remember something was discussed before — in one session or across several — but cannot name where or what it was called |
/grasp | Something in front of you — code, a document, a result — is hard to follow, or you think you understand it but aren't sure |
/conduct | The work has several parts, and it's unclear what can run independently, what order matters, how results come together, where they go, or when to stop |
The protocols are not a fixed sequence: pick the one that matches the gap you are facing, and combine them as your situation requires.
What each protocol leaves you with
| Command | Protocol | Once it has run |
|---|---|---|
/inquire | Aitesis | You can recognize what was settled and from where, what rests on weak or unreached ground, and what only you decide |
/elicit | Euporia | You can say "this is my intent, aligned enough" — each recorded value stands on your own words, and what you left open is carried |
/ideate | Heuresis | You can look over one map of your idea field — each frame and its branches, every candidate with its origin, what stays unexplored, and what you set aside — and carry that field forward before choosing or ranking |
/preview | Proplasma | You can say what each direction means for your purpose, whether that rests on a probe you saw, a description, your own account, or evidence, and which one you take |
/sketch | Hypotyposis | You can point at a version you met and say "this is the form, for this purpose", and see where it and the passed-over versions are |
/fit | Harmoge | You can see the solution space as it now stands — the cases you settled, what the target does on every case gathered so far, and the boundaries still open — and judge when it is enough for your purpose |
/ground | Analogia | You can say what carries each conclusion, what was checked and found, what would break it, and whether it holds, is blocked, or remains undetermined |
/induce | Periagoge | You can name what your cases share, say which cases it takes in and which it leaves out, and recognize it as serving your goal |
/apportion | Merismos | You can call the plan yours — units with their checks, accepted gaps, and held judgments; what needed you before the run is settled, and the rest comes back to you once at the end |
/contextualize | Epharmoge | You can see again what fell away and what it means for the result now, with settled items that were misapplied fixed and reread, and what is yours to judge handed back with a proposal |
/bound | Horismos | You can see what the work treats as settled, on what ground and by whose judgment, with every open item filled in as the AI's choice or marked proposal |
/recollect | Anamnesis | You recognize the past you were reaching for — a conversation, line of work, topic, or settled concept across several — in a story whose every sentence rests on a record you can reopen, knowing it took place, not that it still holds |
/grasp | Katalepsis | You can say your understanding serves your purpose, on a map built with you and checked against the material, knowing what would settle the checks still pending |
/conduct | Hyphegesis | You can say how the lines order, combine, stop, and where their results go, recognize what you entrusted and kept, and call the method yours |
Route
For utility plugin installation in Claude Code, see Quick Start.
Experimental. The hook set and the injected wording can change between releases — see route/README.md before depending on either.
Context-driven protocol routing. A session-start hook places the two protocols to reach for first — /inquire before gathering context, /elicit where the intent is unclear (the plugin's purpose.md) — the installed-protocol table with each protocol's declared description, and the premise index at the head of context, once per context epoch; the agent in the main conversation judges in the turn itself, at the prompt and mid-turn; a delegated agent, a fork included, invokes no protocol. With it, you meet the deficit your conversation shows as the core protocol that resolves it, without recalling which protocols exist: the agent brings in /inquire or /elicit where the purpose names them and reads any other gap against the protocols' declared descriptions, and the invoked protocol's own gates hold your judgment. Route has no command of its own: where you already know the protocol you want, type that protocol's command.
What the checks cover
Different mechanisms check different things, and it helps to know where each one stops.
- Lean proofs — a protocol's contract is also written as a Lean model inside its
SKILL.md. Lean checks that the properties stated about that model hold, under the assumptions the model declares; the judgments the model leaves open are among those assumptions, not things it proves. A protocol'slean/EpistemicProtocols/<Protocol>/Theorems.leanholds what is stated and proved about its model. - Runtime evidence — the contributor skill
/realizeruns a protocol in a real session and collects evidence that the steps it declares actually happen, through automatic checks plus a review of the transcript. - Static checks —
static-checks.jschecks the files' structure: required sections, consistent names and references, matching versions.
None of these measures what happens downstream of a protocol, such as whether it reduces rework, and that is deliberate: how much a protocol helps depends on what each person does not yet know, and on the model, which keeps improving. What a run can show is which decisions entered the conversation because the AI asked or presented them rather than because they were written up front. The contributor skill /outcome runs the same request with and without a protocol and lists those decisions with the passages they came from.
For Contributors
Start with ONBOARDING.md. Paste the full file into a fresh Claude Code session to use Claude as an onboarding buddy for environment setup, core docs, and the contribution workflow.
For architecture, read CLAUDE.md. For the underlying collaboration principles, explore premise/.
When editing the project's public description, follow the Mission/vision wording change row in co-change.md.
Greek Codex
| Protocol | Greek | Meaning |
|---|---|---|
| Katalepsis | κατάληψις | Grasping, comprehension |
| Horismos | ὁρισμός | A bounding |
| Aitesis | αἴτησις | Request, inquiry |
| Analogia | ἀναλογία | Proportion |
| Periagoge | περιαγωγή | Turning-around |
| Euporia | εὐπορία | Way through, resourcefulness |
| Merismos | μερισμός | Apportionment |
| Epharmoge | ἐφαρμογή | Application, fitting |
| Anamnesis | ἀνάμνησις | Recollection |
| Hyphegesis | ὑφήγησις | Leading the way, guiding from ahead |
| Proplasma | πρόπλασμα | Preliminary model, first mold |
| Hypotyposis | ὑποτύπωσις | Outline, first sketch |
| Harmoge | ἁρμογή | Fitting together, joining |
| Heuresis | εὕρεσις | Finding, discovery |
Acknowledgments
- @yolohyo — Comment-lifecycle UX design contribution for comment-review (the skill has since moved to cc-plugin as a protocol-free substrate plugin)
- @zzsza — Quiz-based participatory UX design contribution for Onboard
License
MIT
Details
- Marketplace
- jongwony/epistemic-protocols
- Source
- harmoge
- Category
- Community
More from jongwony/epistemic-protocols
All 23Similar to harmoge
More Design & Creative
example-skillsanthropics/skills196.9K starsCollection of example skills demonstrating various capabilities including skill creation, MCP building, visual design, algorithmic art, internal communications,
feature-devanthropics/claude-code156.1K starsComprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
ui-ux-pro-maxnextlevelbuilder/ui-ux-pro-max-skill152.6K starsProfessional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for Reac
taste-skillLeonxlnx/taste-skill117.9K starstasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept fo
impeccablepbakaus/impeccable114.7K starsDesign fluency for frontend development. 1 skill with 24 commands (/impeccable polish, /impeccable audit, /impeccable critique, etc.) and curated anti-pattern d
storybookstorybookjs/storybook91.6K starsBuild, preview, and test UI components with Storybook.