Skip to main content
Mibyan is a large repository, and most contributions touch exactly one subsystem. This page maps each subsystem to its source directories and the documentation entry point you should read before changing it. Use it to find the right starting doc, the right place for a change, and the right test directory (tests mirror source: code in tools/ is tested in tests/tools/, plugins in tests/plugins/<type>/, and so on). A few conventions that fall out of this map:
  • Changes should stay inside their subsystem. A plugin that needs to edit core files is a design smell — widen the generic plugin surface instead (see the contribution rubric in the repository’s AGENTS.md).
  • Run the mirror test directory for every source directory you touch. A change to plugins/platforms/telegram/ needs tests/plugins/platforms/ green, not just the test file you happened to think of.
  • When two subsystems are involved, the narrower one owns the change. Prefer a fix in an adapter or plugin over a branch in the agent core; the core is a narrow waist, and every addition there is paid for on every API call.