Epistemic Protocols
한국어
When AI collaboration goes off-track, you redo everything. These protocols catch direction errors early — at the plan level, not the code level. Fix the direction, not the implementation.
Why
Correcting a wrong direction at the plan level costs one conversation turn.
At the code level, it costs hours of rework.
These protocols insert structured checkpoints at decision points — intent, goal, context, perspective, execution — so you and AI stay aligned before committing to implementation.
Quick Start
Claude Code
Install all protocols and utilities:
curl -fsSL https://raw.githubusercontent.com/jongwony/epistemic-protocols/main/scripts/install.sh | bash
Then run /onboard — start with a quick recommendation based on your recent sessions, then optionally continue to guided learning with scenarios, trials, and quizzes.
Codex
Paste in Codex and run:
$skill-installer install these skills from jongwony/epistemic-protocols:
- prothesis/skills/frame
- syneidesis/skills/gap
- hermeneia/skills/clarify
- katalepsis/skills/grasp
- telos/skills/goal
- aitesis/skills/inquire
- horismos/skills/bound
- analogia/skills/ground
- prosoche/skills/attend
- epharmoge/skills/contextualize
- epistemic-cooperative/skills/onboard
Restart Codex, then start with $onboard.
Notes
- This installs 10 protocols +
onboard. /report, /dashboard, reflexion, write are not included.
- To install a single skill, use the same
skill-installer pattern with one path.
- This README is the source of truth for the Codex-supported install set.
Protocols
| Protocol | Command | When to use |
|---|
| Hermeneia | /clarify | AI keeps building what you didn't ask for |
| Telos | /goal | You know you want something but can't define success |
| Aitesis | /inquire | AI charges ahead without asking what it needs to know |
| Prothesis | /frame | Need to look at this from multiple angles, not sure which |
| Analogia | /ground | AI's advice sounds right in theory but unclear in your context |
| Syneidesis | /gap | About to commit but might be missing something |
| Prosoche | /attend | Want execution readiness checked and risky actions gated for your judgment |
| Epharmoge | /contextualize | AI's output is correct but doesn't fit your situation |
| Horismos | /bound | You need to define what you know vs what AI should figure out |
| Katalepsis | /grasp | AI made big changes and you need to actually understand them |
Concern clusters: Planning (/clarify, /goal, /inquire) · Analysis (/frame, /ground) · Decision (/gap) · Execution (/attend) · Verification (/contextualize) · Cross-cutting (/bound, /grasp)
Utilities
| Plugin | Command | Purpose |
|---|
| Epistemic Cooperative | /onboard, /report, /dashboard | Protocol learning, usage analysis, and coverage dashboard |
Design
Each protocol targets a specific point where AI collaboration can go wrong. For architecture details and design philosophy, see CLAUDE.md.
Greek Codex
| Protocol | Greek | Meaning |
|---|
| Prothesis | πρόθεσις | Setting forth |
| Syneidesis | συνείδησις | Shared knowing |
| Hermeneia | ἑρμηνεία | Interpretation |
| Katalepsis | κατάληψις | Grasping, comprehension |
| Telos | τέλος | End, purpose |
| Horismos | ὁρισμός | A bounding |
| Aitesis | αἴτησις | Request, inquiry |
| Analogia | ἀναλογία | Proportion |
| Prosoche | προσοχή | Attention |
| Epharmoge | ἐφαρμογή | Application, fitting |
Acknowledgments
- @zzsza — Quiz-based participatory UX design contribution for Onboard
License
MIT
jongwony