oh-my-customcodex 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (351) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +327 -0
  3. package/dist/cli/index.js +32054 -0
  4. package/dist/index.js +5469 -0
  5. package/package.json +89 -0
  6. package/templates/.claude/agents/arch-documenter.md +38 -0
  7. package/templates/.claude/agents/arch-speckit-agent.md +66 -0
  8. package/templates/.claude/agents/be-django-expert.md +47 -0
  9. package/templates/.claude/agents/be-express-expert.md +31 -0
  10. package/templates/.claude/agents/be-fastapi-expert.md +45 -0
  11. package/templates/.claude/agents/be-go-backend-expert.md +45 -0
  12. package/templates/.claude/agents/be-nestjs-expert.md +29 -0
  13. package/templates/.claude/agents/be-springboot-expert.md +42 -0
  14. package/templates/.claude/agents/db-alembic-expert.md +73 -0
  15. package/templates/.claude/agents/db-postgres-expert.md +38 -0
  16. package/templates/.claude/agents/db-redis-expert.md +38 -0
  17. package/templates/.claude/agents/db-supabase-expert.md +37 -0
  18. package/templates/.claude/agents/de-airflow-expert.md +48 -0
  19. package/templates/.claude/agents/de-dbt-expert.md +36 -0
  20. package/templates/.claude/agents/de-kafka-expert.md +83 -0
  21. package/templates/.claude/agents/de-pipeline-expert.md +34 -0
  22. package/templates/.claude/agents/de-snowflake-expert.md +38 -0
  23. package/templates/.claude/agents/de-spark-expert.md +38 -0
  24. package/templates/.claude/agents/fe-design-expert.md +120 -0
  25. package/templates/.claude/agents/fe-flutter-agent.md +48 -0
  26. package/templates/.claude/agents/fe-svelte-agent.md +33 -0
  27. package/templates/.claude/agents/fe-vercel-agent.md +40 -0
  28. package/templates/.claude/agents/fe-vuejs-agent.md +34 -0
  29. package/templates/.claude/agents/infra-aws-expert.md +49 -0
  30. package/templates/.claude/agents/infra-docker-expert.md +49 -0
  31. package/templates/.claude/agents/lang-golang-expert.md +46 -0
  32. package/templates/.claude/agents/lang-java21-expert.md +42 -0
  33. package/templates/.claude/agents/lang-kotlin-expert.md +45 -0
  34. package/templates/.claude/agents/lang-python-expert.md +45 -0
  35. package/templates/.claude/agents/lang-rust-expert.md +45 -0
  36. package/templates/.claude/agents/lang-typescript-expert.md +45 -0
  37. package/templates/.claude/agents/mgr-claude-code-bible.md +62 -0
  38. package/templates/.claude/agents/mgr-creator.md +57 -0
  39. package/templates/.claude/agents/mgr-gitnerd.md +50 -0
  40. package/templates/.claude/agents/mgr-sauron.md +163 -0
  41. package/templates/.claude/agents/mgr-supplier.md +39 -0
  42. package/templates/.claude/agents/mgr-updater.md +40 -0
  43. package/templates/.claude/agents/qa-engineer.md +36 -0
  44. package/templates/.claude/agents/qa-planner.md +78 -0
  45. package/templates/.claude/agents/qa-writer.md +32 -0
  46. package/templates/.claude/agents/sec-codeql-expert.md +56 -0
  47. package/templates/.claude/agents/slack-cli-expert.md +98 -0
  48. package/templates/.claude/agents/souls/lang-golang-expert.soul.md +21 -0
  49. package/templates/.claude/agents/sys-memory-keeper.md +123 -0
  50. package/templates/.claude/agents/sys-naggy.md +76 -0
  51. package/templates/.claude/agents/tool-bun-expert.md +26 -0
  52. package/templates/.claude/agents/tool-npm-expert.md +31 -0
  53. package/templates/.claude/agents/tool-optimizer.md +37 -0
  54. package/templates/.claude/agents/wiki-curator.md +72 -0
  55. package/templates/.claude/config/required-plugins.json +30 -0
  56. package/templates/.claude/contexts/dev.md +20 -0
  57. package/templates/.claude/contexts/ecomode.md +110 -0
  58. package/templates/.claude/contexts/index.yaml +41 -0
  59. package/templates/.claude/contexts/research.md +28 -0
  60. package/templates/.claude/contexts/review.md +23 -0
  61. package/templates/.claude/hooks/hooks.json +533 -0
  62. package/templates/.claude/hooks/scripts/adaptive-harness-scan.sh +45 -0
  63. package/templates/.claude/hooks/scripts/agent-start-recorder.sh +40 -0
  64. package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +76 -0
  65. package/templates/.claude/hooks/scripts/audit-log.sh +64 -0
  66. package/templates/.claude/hooks/scripts/auto-continue-guard.sh +33 -0
  67. package/templates/.claude/hooks/scripts/content-hash-validator.sh +75 -0
  68. package/templates/.claude/hooks/scripts/context-budget-advisor.sh +107 -0
  69. package/templates/.claude/hooks/scripts/cost-cap-advisor.sh +71 -0
  70. package/templates/.claude/hooks/scripts/cwd-change-detector.sh +36 -0
  71. package/templates/.claude/hooks/scripts/eval-core-batch-save.sh +46 -0
  72. package/templates/.claude/hooks/scripts/feedback-collector.sh +92 -0
  73. package/templates/.claude/hooks/scripts/file-change-validator.sh +26 -0
  74. package/templates/.claude/hooks/scripts/git-delegation-guard.sh +57 -0
  75. package/templates/.claude/hooks/scripts/model-escalation-advisor.sh +106 -0
  76. package/templates/.claude/hooks/scripts/omcodex-auto-update.sh +4 -0
  77. package/templates/.claude/hooks/scripts/omcustom-auto-update.sh +177 -0
  78. package/templates/.claude/hooks/scripts/rtk-intercept.sh +77 -0
  79. package/templates/.claude/hooks/scripts/rule-deletion-guard.sh +60 -0
  80. package/templates/.claude/hooks/scripts/schema-validator.sh +106 -0
  81. package/templates/.claude/hooks/scripts/secret-filter.sh +100 -0
  82. package/templates/.claude/hooks/scripts/session-autofix-prompt.sh +34 -0
  83. package/templates/.claude/hooks/scripts/session-autofix.sh +146 -0
  84. package/templates/.claude/hooks/scripts/session-env-check.sh +254 -0
  85. package/templates/.claude/hooks/scripts/skill-extractor-analyzer.sh +49 -0
  86. package/templates/.claude/hooks/scripts/stage-blocker.sh +16 -0
  87. package/templates/.claude/hooks/scripts/stale-todo-scanner.sh +91 -0
  88. package/templates/.claude/hooks/scripts/stall-detection-advisor.sh +112 -0
  89. package/templates/.claude/hooks/scripts/stop-console-audit.sh +46 -0
  90. package/templates/.claude/hooks/scripts/stuck-detector.sh +199 -0
  91. package/templates/.claude/hooks/scripts/task-outcome-recorder.sh +119 -0
  92. package/templates/.claude/hooks/scripts/task-state-precompact.sh +58 -0
  93. package/templates/.claude/hooks/scripts/user-prompt-preprocessor.sh +32 -0
  94. package/templates/.claude/hooks/skill-count-reminder.sh +34 -0
  95. package/templates/.claude/install-hooks.sh +100 -0
  96. package/templates/.claude/ontology/agents.yaml +546 -0
  97. package/templates/.claude/ontology/graphs/agent-skill.json +102 -0
  98. package/templates/.claude/ontology/graphs/full-graph.json +629 -0
  99. package/templates/.claude/ontology/graphs/routing.json +112 -0
  100. package/templates/.claude/ontology/graphs/skill-rule.json +78 -0
  101. package/templates/.claude/ontology/rules.yaml +251 -0
  102. package/templates/.claude/ontology/schema.yaml +144 -0
  103. package/templates/.claude/ontology/skills.yaml +575 -0
  104. package/templates/.claude/rules/MAY-optimization.md +42 -0
  105. package/templates/.claude/rules/MUST-agent-design.md +340 -0
  106. package/templates/.claude/rules/MUST-agent-identification.md +77 -0
  107. package/templates/.claude/rules/MUST-agent-teams.md +293 -0
  108. package/templates/.claude/rules/MUST-completion-verification.md +112 -0
  109. package/templates/.claude/rules/MUST-continuous-improvement.md +69 -0
  110. package/templates/.claude/rules/MUST-enforcement-policy.md +50 -0
  111. package/templates/.claude/rules/MUST-intent-transparency.md +74 -0
  112. package/templates/.claude/rules/MUST-language-policy.md +28 -0
  113. package/templates/.claude/rules/MUST-orchestrator-coordination.md +399 -0
  114. package/templates/.claude/rules/MUST-parallel-execution.md +184 -0
  115. package/templates/.claude/rules/MUST-permissions.md +32 -0
  116. package/templates/.claude/rules/MUST-safety.md +23 -0
  117. package/templates/.claude/rules/MUST-sync-verification.md +145 -0
  118. package/templates/.claude/rules/MUST-tool-identification.md +97 -0
  119. package/templates/.claude/rules/SHOULD-ecomode.md +123 -0
  120. package/templates/.claude/rules/SHOULD-error-handling.md +33 -0
  121. package/templates/.claude/rules/SHOULD-hud-statusline.md +51 -0
  122. package/templates/.claude/rules/SHOULD-interaction.md +77 -0
  123. package/templates/.claude/rules/SHOULD-memory-integration.md +371 -0
  124. package/templates/.claude/rules/SHOULD-ontology-rag-routing.md +49 -0
  125. package/templates/.claude/rules/SHOULD-wiki-sync.md +73 -0
  126. package/templates/.claude/rules/index.yaml +141 -0
  127. package/templates/.claude/schemas/tool-inputs.json +62 -0
  128. package/templates/.claude/skills/action-validator/SKILL.md +89 -0
  129. package/templates/.claude/skills/adaptive-harness/SKILL.md +335 -0
  130. package/templates/.claude/skills/adversarial-review/SKILL.md +80 -0
  131. package/templates/.claude/skills/agora/SKILL.md +194 -0
  132. package/templates/.claude/skills/airflow-best-practices/SKILL.md +94 -0
  133. package/templates/.claude/skills/alembic-best-practices/SKILL.md +295 -0
  134. package/templates/.claude/skills/ambiguity-gate/SKILL.md +94 -0
  135. package/templates/.claude/skills/analysis/SKILL.md +223 -0
  136. package/templates/.claude/skills/audit-agents/SKILL.md +118 -0
  137. package/templates/.claude/skills/aws-best-practices/SKILL.md +281 -0
  138. package/templates/.claude/skills/claude-code-bible/SKILL.md +93 -0
  139. package/templates/.claude/skills/claude-code-bible/scripts/fetch-docs.js +244 -0
  140. package/templates/.claude/skills/claude-native/SKILL.md +215 -0
  141. package/templates/.claude/skills/codex-exec/SKILL.md +206 -0
  142. package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +430 -0
  143. package/templates/.claude/skills/create-agent/SKILL.md +94 -0
  144. package/templates/.claude/skills/cve-triage/SKILL.md +91 -0
  145. package/templates/.claude/skills/dag-orchestration/SKILL.md +201 -0
  146. package/templates/.claude/skills/dbt-best-practices/SKILL.md +55 -0
  147. package/templates/.claude/skills/de-lead-routing/SKILL.md +230 -0
  148. package/templates/.claude/skills/deep-plan/SKILL.md +344 -0
  149. package/templates/.claude/skills/deep-verify/SKILL.md +111 -0
  150. package/templates/.claude/skills/dev-lead-routing/SKILL.md +161 -0
  151. package/templates/.claude/skills/dev-refactor/SKILL.md +234 -0
  152. package/templates/.claude/skills/dev-review/SKILL.md +172 -0
  153. package/templates/.claude/skills/django-best-practices/SKILL.md +334 -0
  154. package/templates/.claude/skills/docker-best-practices/SKILL.md +276 -0
  155. package/templates/.claude/skills/evaluator-optimizer/SKILL.md +421 -0
  156. package/templates/.claude/skills/fastapi-best-practices/SKILL.md +271 -0
  157. package/templates/.claude/skills/fix-refs/SKILL.md +109 -0
  158. package/templates/.claude/skills/flutter-best-practices/SKILL.md +325 -0
  159. package/templates/.claude/skills/gemini-exec/SKILL.md +215 -0
  160. package/templates/.claude/skills/gemini-exec/scripts/gemini-wrapper.cjs +485 -0
  161. package/templates/.claude/skills/go-backend-best-practices/SKILL.md +135 -0
  162. package/templates/.claude/skills/go-best-practices/SKILL.md +204 -0
  163. package/templates/.claude/skills/hada-scout/SKILL.md +92 -0
  164. package/templates/.claude/skills/harness-eval/SKILL.md +95 -0
  165. package/templates/.claude/skills/harness-synthesizer/SKILL.md +145 -0
  166. package/templates/.claude/skills/help/SKILL.md +127 -0
  167. package/templates/.claude/skills/idea/SKILL.md +88 -0
  168. package/templates/.claude/skills/impeccable-design/SKILL.md +173 -0
  169. package/templates/.claude/skills/intent-detection/SKILL.md +293 -0
  170. package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +438 -0
  171. package/templates/.claude/skills/java21-best-practices/SKILL.md +190 -0
  172. package/templates/.claude/skills/jinja2-prompts/SKILL.md +86 -0
  173. package/templates/.claude/skills/kafka-best-practices/SKILL.md +53 -0
  174. package/templates/.claude/skills/kotlin-best-practices/SKILL.md +257 -0
  175. package/templates/.claude/skills/lists/SKILL.md +80 -0
  176. package/templates/.claude/skills/memory-management/SKILL.md +196 -0
  177. package/templates/.claude/skills/memory-recall/SKILL.md +172 -0
  178. package/templates/.claude/skills/memory-save/SKILL.md +128 -0
  179. package/templates/.claude/skills/model-escalation/SKILL.md +62 -0
  180. package/templates/.claude/skills/monitoring-setup/SKILL.md +215 -0
  181. package/templates/.claude/skills/multi-model-verification/SKILL.md +130 -0
  182. package/templates/.claude/skills/npm-audit/SKILL.md +74 -0
  183. package/templates/.claude/skills/npm-publish/SKILL.md +65 -0
  184. package/templates/.claude/skills/npm-version/SKILL.md +104 -0
  185. package/templates/.claude/skills/omcodex-auto-improve/SKILL.md +136 -0
  186. package/templates/.claude/skills/omcodex-feedback/SKILL.md +205 -0
  187. package/templates/.claude/skills/omcodex-improve-report/SKILL.md +65 -0
  188. package/templates/.claude/skills/omcodex-loop/SKILL.md +45 -0
  189. package/templates/.claude/skills/omcodex-release-notes/SKILL.md +117 -0
  190. package/templates/.claude/skills/omcodex-takeover/SKILL.md +115 -0
  191. package/templates/.claude/skills/omcodex-web/SKILL.md +95 -0
  192. package/templates/.claude/skills/optimize-analyze/SKILL.md +57 -0
  193. package/templates/.claude/skills/optimize-bundle/SKILL.md +69 -0
  194. package/templates/.claude/skills/optimize-report/SKILL.md +76 -0
  195. package/templates/.claude/skills/peer-messaging/SKILL.md +59 -0
  196. package/templates/.claude/skills/pipeline/SKILL.md +103 -0
  197. package/templates/.claude/skills/pipeline-architecture-patterns/SKILL.md +84 -0
  198. package/templates/.claude/skills/pipeline-guards/SKILL.md +173 -0
  199. package/templates/.claude/skills/post-release-followup/SKILL.md +134 -0
  200. package/templates/.claude/skills/postgres-best-practices/SKILL.md +67 -0
  201. package/templates/.claude/skills/pr-auto-improve/SKILL.md +129 -0
  202. package/templates/.claude/skills/professor-triage/SKILL.md +321 -0
  203. package/templates/.claude/skills/python-best-practices/SKILL.md +223 -0
  204. package/templates/.claude/skills/qa-lead-routing/SKILL.md +104 -0
  205. package/templates/.claude/skills/react-best-practices/SKILL.md +102 -0
  206. package/templates/.claude/skills/reasoning-sandwich/SKILL.md +64 -0
  207. package/templates/.claude/skills/redis-best-practices/SKILL.md +84 -0
  208. package/templates/.claude/skills/release-plan/SKILL.md +207 -0
  209. package/templates/.claude/skills/research/SKILL.md +493 -0
  210. package/templates/.claude/skills/result-aggregation/SKILL.md +165 -0
  211. package/templates/.claude/skills/rtk-exec/SKILL.md +199 -0
  212. package/templates/.claude/skills/rtk-exec/scripts/rtk-wrapper.cjs +377 -0
  213. package/templates/.claude/skills/rust-best-practices/SKILL.md +268 -0
  214. package/templates/.claude/skills/sauron-watch/SKILL.md +239 -0
  215. package/templates/.claude/skills/scout/SKILL.md +250 -0
  216. package/templates/.claude/skills/sdd/SKILL.md +24 -0
  217. package/templates/.claude/skills/sdd-dev/SKILL.md +257 -0
  218. package/templates/.claude/skills/sdd-development/SKILL.md +24 -0
  219. package/templates/.claude/skills/secretary-routing/SKILL.md +132 -0
  220. package/templates/.claude/skills/skill-extractor/SKILL.md +155 -0
  221. package/templates/.claude/skills/skills-sh-search/SKILL.md +210 -0
  222. package/templates/.claude/skills/snowflake-best-practices/SKILL.md +66 -0
  223. package/templates/.claude/skills/spark-best-practices/SKILL.md +53 -0
  224. package/templates/.claude/skills/springboot-best-practices/SKILL.md +74 -0
  225. package/templates/.claude/skills/springboot-best-practices/examples/config-properties-example.java +22 -0
  226. package/templates/.claude/skills/springboot-best-practices/examples/controller-example.java +28 -0
  227. package/templates/.claude/skills/springboot-best-practices/examples/controller-test-example.java +33 -0
  228. package/templates/.claude/skills/springboot-best-practices/examples/entity-example.java +22 -0
  229. package/templates/.claude/skills/springboot-best-practices/examples/exception-handler-example.java +30 -0
  230. package/templates/.claude/skills/springboot-best-practices/examples/repository-example.java +17 -0
  231. package/templates/.claude/skills/springboot-best-practices/examples/repository-test-example.java +23 -0
  232. package/templates/.claude/skills/springboot-best-practices/examples/security-config-example.java +27 -0
  233. package/templates/.claude/skills/springboot-best-practices/examples/service-example.java +33 -0
  234. package/templates/.claude/skills/status/SKILL.md +155 -0
  235. package/templates/.claude/skills/structured-dev-cycle/SKILL.md +200 -0
  236. package/templates/.claude/skills/stuck-recovery/SKILL.md +80 -0
  237. package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +100 -0
  238. package/templates/.claude/skills/systematic-debugging/SKILL.md +288 -0
  239. package/templates/.claude/skills/systematic-debugging/condition-based-waiting-example.ts +278 -0
  240. package/templates/.claude/skills/systematic-debugging/condition-based-waiting.md +240 -0
  241. package/templates/.claude/skills/systematic-debugging/defense-in-depth.md +252 -0
  242. package/templates/.claude/skills/systematic-debugging/find-polluter.sh +147 -0
  243. package/templates/.claude/skills/systematic-debugging/root-cause-tracing.md +87 -0
  244. package/templates/.claude/skills/task-decomposition/SKILL.md +197 -0
  245. package/templates/.claude/skills/typescript-best-practices/SKILL.md +322 -0
  246. package/templates/.claude/skills/update-docs/SKILL.md +142 -0
  247. package/templates/.claude/skills/update-external/SKILL.md +169 -0
  248. package/templates/.claude/skills/vercel-deploy/SKILL.md +75 -0
  249. package/templates/.claude/skills/web-design-guidelines/SKILL.md +119 -0
  250. package/templates/.claude/skills/wiki/SKILL.md +426 -0
  251. package/templates/.claude/skills/wiki-rag/SKILL.md +154 -0
  252. package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +165 -0
  253. package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +66 -0
  254. package/templates/.claude/statusline.sh +380 -0
  255. package/templates/.claude/uninstall-hooks.sh +52 -0
  256. package/templates/.github/workflows/wiki-sync.yml +132 -0
  257. package/templates/AGENTS.md.en +255 -0
  258. package/templates/AGENTS.md.ko +255 -0
  259. package/templates/CLAUDE.md +263 -0
  260. package/templates/CLAUDE.md.en +256 -0
  261. package/templates/CLAUDE.md.ko +256 -0
  262. package/templates/deprecated-files.json +10 -0
  263. package/templates/guides/agents-md-quality/README.md +110 -0
  264. package/templates/guides/airflow/README.md +47 -0
  265. package/templates/guides/alembic/README.md +438 -0
  266. package/templates/guides/aws/common-patterns.md +169 -0
  267. package/templates/guides/aws/index.yaml +26 -0
  268. package/templates/guides/aws/well-architected.md +143 -0
  269. package/templates/guides/cc-token-saver/README.md +97 -0
  270. package/templates/guides/claude-code/01-overview.md +42 -0
  271. package/templates/guides/claude-code/03-tools.md +107 -0
  272. package/templates/guides/claude-code/04-agent-skills.md +90 -0
  273. package/templates/guides/claude-code/05-agent-sdk.md +129 -0
  274. package/templates/guides/claude-code/06-mcp.md +165 -0
  275. package/templates/guides/claude-code/07-prompt-engineering.md +100 -0
  276. package/templates/guides/claude-code/08-testing.md +56 -0
  277. package/templates/guides/claude-code/09-guardrails.md +78 -0
  278. package/templates/guides/claude-code/10-monitoring.md +87 -0
  279. package/templates/guides/claude-code/11-sub-agents.md +159 -0
  280. package/templates/guides/claude-code/12-workflow-patterns.md +182 -0
  281. package/templates/guides/claude-code/13-cli-flags.md +151 -0
  282. package/templates/guides/claude-code/index.yaml +61 -0
  283. package/templates/guides/dbt/README.md +32 -0
  284. package/templates/guides/django-best-practices/README.md +476 -0
  285. package/templates/guides/docker/compose-best-practices.md +284 -0
  286. package/templates/guides/docker/dockerfile-best-practices.md +262 -0
  287. package/templates/guides/docker/index.yaml +26 -0
  288. package/templates/guides/drizzle-orm/README.md +69 -0
  289. package/templates/guides/elements-of-style/elements-of-style.html +2609 -0
  290. package/templates/guides/fastapi/best-practices.md +232 -0
  291. package/templates/guides/fastapi/index.yaml +21 -0
  292. package/templates/guides/flutter/architecture.md +141 -0
  293. package/templates/guides/flutter/fundamentals.md +119 -0
  294. package/templates/guides/flutter/index.yaml +44 -0
  295. package/templates/guides/flutter/performance.md +119 -0
  296. package/templates/guides/flutter/security.md +120 -0
  297. package/templates/guides/flutter/state-management.md +144 -0
  298. package/templates/guides/flutter/testing.md +155 -0
  299. package/templates/guides/git-worktree-workflow/README.md +138 -0
  300. package/templates/guides/go-backend/index.yaml +26 -0
  301. package/templates/guides/go-backend/project-layout.md +243 -0
  302. package/templates/guides/go-backend/uber-style.md +212 -0
  303. package/templates/guides/golang/concurrency.md +282 -0
  304. package/templates/guides/golang/effective-go.md +309 -0
  305. package/templates/guides/golang/error-handling.md +250 -0
  306. package/templates/guides/golang/index.yaml +27 -0
  307. package/templates/guides/hook-data-flow/README.md +135 -0
  308. package/templates/guides/iceberg/README.md +49 -0
  309. package/templates/guides/impeccable-design/color-and-contrast.md +278 -0
  310. package/templates/guides/impeccable-design/index.yaml +12 -0
  311. package/templates/guides/impeccable-design/motion-design.md +390 -0
  312. package/templates/guides/impeccable-design/typography.md +386 -0
  313. package/templates/guides/impeccable-design/ux-writing.md +400 -0
  314. package/templates/guides/index.yaml +265 -0
  315. package/templates/guides/java21/index.yaml +29 -0
  316. package/templates/guides/java21/java-style-guide.md +248 -0
  317. package/templates/guides/java21/modern-java21.md +303 -0
  318. package/templates/guides/kafka/README.md +32 -0
  319. package/templates/guides/kotlin/coding-conventions.md +247 -0
  320. package/templates/guides/kotlin/idioms.md +234 -0
  321. package/templates/guides/kotlin/index.yaml +26 -0
  322. package/templates/guides/multi-model-routing/README.md +101 -0
  323. package/templates/guides/multi-provider-exec/README.md +83 -0
  324. package/templates/guides/postgres/README.md +58 -0
  325. package/templates/guides/python/index.yaml +26 -0
  326. package/templates/guides/python/pep8-style-guide.md +202 -0
  327. package/templates/guides/python/zen-of-python.md +79 -0
  328. package/templates/guides/redis/README.md +50 -0
  329. package/templates/guides/rust/error-handling.md +262 -0
  330. package/templates/guides/rust/index.yaml +26 -0
  331. package/templates/guides/rust/ownership.md +180 -0
  332. package/templates/guides/skill-bundle-design/README.md +106 -0
  333. package/templates/guides/slack-cli/README.md +145 -0
  334. package/templates/guides/snowflake/README.md +32 -0
  335. package/templates/guides/spark/README.md +32 -0
  336. package/templates/guides/springboot/best-practices.md +361 -0
  337. package/templates/guides/springboot/index.yaml +22 -0
  338. package/templates/guides/supabase-postgres/README.md +32 -0
  339. package/templates/guides/supabase-postgres/index.yaml +19 -0
  340. package/templates/guides/typescript/advanced-types.md +225 -0
  341. package/templates/guides/typescript/index.yaml +26 -0
  342. package/templates/guides/typescript/type-system.md +219 -0
  343. package/templates/guides/web-design/accessibility.md +66 -0
  344. package/templates/guides/web-design/index.yaml +20 -0
  345. package/templates/guides/web-design/performance.md +102 -0
  346. package/templates/guides/web-scraping/README.md +926 -0
  347. package/templates/guides/web-scraping/index.yaml +19 -0
  348. package/templates/guides/worktree-lifecycle/README.md +104 -0
  349. package/templates/index.yaml +18 -0
  350. package/templates/manifest.json +49 -0
  351. package/templates/workflows/auto-dev.yaml +46 -0
@@ -0,0 +1,371 @@
1
+ # [SHOULD] Memory Integration Rules
2
+
3
+ > **Priority**: SHOULD | **ID**: R011
4
+
5
+ ## Architecture
6
+
7
+ **Primary**: Native auto memory (`memory` field in agent frontmatter). No external dependencies.
8
+ **Supplementary**: claude-mem MCP (optional, for cross-session search and temporal queries).
9
+
10
+ Rule: If native auto memory can handle it, do NOT use claude-mem.
11
+
12
+ ## Native Auto Memory
13
+
14
+ Agent frontmatter `memory: project|user|local` enables persistent memory:
15
+ - System creates memory directory, loads first 200 lines of MEMORY.md into prompt
16
+ - Read/Write/Edit tools auto-enabled for memory directory
17
+ - Custom directory: set `autoMemoryDirectory` in settings to override default paths (v2.1.74+)
18
+
19
+ | Scope | Location | Git Tracked |
20
+ |-------|----------|-------------|
21
+ | `user` | `~/.codex/agent-memory/<name>/` | No |
22
+ | `project` | `.codex/agent-memory/<name>/` | Yes |
23
+ | `local` | `.codex/agent-memory-local/<name>/` | No |
24
+
25
+ ## When to Use claude-mem
26
+
27
+ | Scenario | Native | claude-mem |
28
+ |----------|--------|------------|
29
+ | Agent learns project patterns | Yes | |
30
+ | Search across sessions | | Yes |
31
+ | Temporal queries | | Yes |
32
+ | Cross-agent sharing | | Yes |
33
+
34
+ ## Best Practices
35
+
36
+ - Consult memory before starting work
37
+ - Update after discovering patterns
38
+ - Keep MEMORY.md under 200 lines
39
+ - Do not store sensitive data or duplicate AGENTS.md content
40
+ - Memory write failures should not block main task
41
+
42
+ <!-- DETAIL: Confidence-Tracked Memory (sys-memory-keeper reference)
43
+
44
+ Memory entries in MEMORY.md should include confidence annotations to distinguish verified facts from hypotheses.
45
+
46
+ ### Confidence Levels
47
+
48
+ | Level | Tag | Meaning | Example |
49
+ |-------|-----|---------|---------|
50
+ | High | `[confidence: high]` | Verified across multiple sessions or confirmed by user | Architecture decisions, confirmed patterns |
51
+ | Medium | `[confidence: medium]` | Observed pattern, not yet fully verified | Code conventions seen in 2-3 files |
52
+ | Low | `[confidence: low]` | Single observation or hypothesis | First-time discovery, untested assumption |
53
+
54
+ ### Format in MEMORY.md
55
+
56
+ ### Key Patterns [confidence: high]
57
+ - `.codex/` files are gitignored — always use `git add -f`
58
+ - pre-commit hooks auto-detect README/manifest count mismatches
59
+
60
+ ### Hypotheses [confidence: medium]
61
+ - Template sync might need CI enforcement (seen in 2 PRs)
62
+
63
+ ### Unverified [confidence: low]
64
+ - Possible race condition in parallel hook execution (observed once)
65
+
66
+ ### Confidence Lifecycle
67
+
68
+ [low] — observed again — [medium] — confirmed by user/testing — [high]
69
+ [any] — contradicted by evidence — demoted or removed
70
+
71
+ ### Temporal Decay
72
+
73
+ Memory entries include an optional verification timestamp for decay tracking.
74
+
75
+ Format: `[confidence: high, verified: 2026-03-15]`
76
+
77
+ | Age (unverified) | Action |
78
+ |-------------------|--------|
79
+ | 0-30 days | No change — entry is fresh |
80
+ | 30-60 days | Demote one level (high->medium, medium->low) |
81
+ | 60-90 days | Demote again if not re-verified |
82
+ | 90+ days | Removal candidate — flag for review |
83
+
84
+ Decay Schedule:
85
+ Day 0: [confidence: high, verified: 2026-03-15]
86
+ Day 30: [confidence: high, verified: 2026-03-15] <- still within window
87
+ Day 31: [confidence: medium, verified: 2026-03-15] <- auto-demoted
88
+ Day 61: [confidence: low, verified: 2026-03-15] <- demoted again
89
+ Day 91: [REVIEW NEEDED, verified: 2026-03-15] <- flagged
90
+
91
+ Re-verification: Any session that confirms a memory entry resets the verified date:
92
+ Before: [confidence: medium, verified: 2026-01-15]
93
+ Action: Pattern confirmed in session
94
+ After: [confidence: high, verified: 2026-03-15]
95
+
96
+ Enforcement: sys-memory-keeper checks decay at session start and end:
97
+ 1. Session start: scan MEMORY.md for entries past decay threshold
98
+ 2. Flag stale entries with `[STALE]` prefix
99
+ 3. Session end: remove or demote unconfirmed stale entries
100
+
101
+ Exceptions: Entries marked `[permanent]` are exempt from decay:
102
+ ### Architecture Decisions [confidence: high, permanent]
103
+
104
+ -->
105
+
106
+ <!-- DETAIL: Behavioral Memory (sys-memory-keeper reference)
107
+
108
+ MEMORY.md supports an optional `## Behaviors` section for tracking user interaction preferences and workflow patterns.
109
+
110
+ ### Behaviors Section Format
111
+
112
+ ## Behaviors [confidence: medium]
113
+ - User prefers concise responses — 3 sentences max
114
+ - Commit messages always include issue number
115
+ - Security-first review perspective
116
+
117
+ ## Behavior Lifecycle
118
+ - New observation — [confidence: low]
119
+ - Seen in 2+ sessions — [confidence: medium]
120
+ - User-confirmed — [confidence: high]
121
+ - Contradicted — demote or remove
122
+
123
+ ### What Counts as a Behavior
124
+
125
+ | Category | Examples |
126
+ |----------|---------|
127
+ | Communication | Verbosity preference, language, format |
128
+ | Workflow | Tool preferences, review habits, branching patterns |
129
+ | Domain priority | Security-first, performance-first, simplicity-first |
130
+
131
+ ### What Does NOT Count as a Behavior
132
+
133
+ - Facts about the codebase (use existing sections)
134
+ - One-time instructions (ephemeral, not persistent)
135
+ - Tool configuration (belongs in AGENTS.md or settings)
136
+
137
+ ### Extraction Guidelines
138
+
139
+ sys-memory-keeper extracts behavioral patterns at session end:
140
+ 1. Analyze conversation for repeated user preferences
141
+ 2. New behaviors start at `[confidence: low]`
142
+ 3. Promote on repeated observation across sessions
143
+ 4. Demote or remove when contradicted
144
+
145
+ ### Budget Management
146
+
147
+ Behaviors share the 200-line MEMORY.md budget with facts. When approaching the limit:
148
+ 1. Prune `[confidence: low]` behaviors first
149
+ 2. Then prune `[confidence: medium]` behaviors
150
+ 3. `[confidence: high]` behaviors are never auto-pruned
151
+
152
+ ### Precedence
153
+
154
+ Behavioral memory observations override soul defaults (R006 Soul Identity) when they conflict. Behaviors are user-specific and session-derived; souls are template defaults.
155
+
156
+ ### Rules
157
+
158
+ | Rule | Detail |
159
+ |------|--------|
160
+ | New discoveries | Start at `[confidence: low]` unless user explicitly confirms |
161
+ | Cross-session verification | Promote to `[confidence: medium]` when seen in 2+ sessions |
162
+ | User confirmation | Promote to `[confidence: high]` when user confirms or tests pass |
163
+ | Contradiction | Demote or remove when contradicted by new evidence |
164
+ | Default | Entries without tags are treated as `[confidence: high]` (backward compatibility) |
165
+
166
+ ### Integration with Session-End
167
+
168
+ When sys-memory-keeper updates MEMORY.md at session end:
169
+ 1. New findings from this session — `[confidence: low]`
170
+ 2. Findings that match existing entries — promote confidence
171
+ 3. Findings that contradict existing entries — flag for review
172
+
173
+ -->
174
+
175
+ <!-- DETAIL: Agent Metrics (sys-memory-keeper reference)
176
+
177
+ MEMORY.md supports an optional `## Metrics` section for tracking per-agent-type performance data.
178
+
179
+ ### Metrics Section Format
180
+
181
+ ## Metrics [auto-updated by sys-memory-keeper]
182
+
183
+ | Agent Type | Tasks | Success Rate | Avg Model | Last Used |
184
+ |------------|-------|-------------|-----------|-----------|
185
+ | lang-golang-expert | 12 | 92% | sonnet | 2026-03-15 |
186
+ | mgr-gitnerd | 8 | 100% | sonnet | 2026-03-15 |
187
+
188
+ ### Metrics Collection
189
+
190
+ sys-memory-keeper aggregates metrics at session end:
191
+
192
+ 1. Read `/tmp/.codex-task-outcomes-${PPID}` (JSONL from task-outcome-recorder hook)
193
+ 2. Parse each entry: `{agent_type, outcome, model, timestamp}`
194
+ 3. Aggregate by agent_type: total tasks, success count, model distribution
195
+ 4. Merge with existing Metrics table in MEMORY.md
196
+ 5. Budget: max 20 rows (prune lowest-usage agents when exceeded)
197
+
198
+ ### Metrics Fields
199
+
200
+ | Field | Source | Calculation |
201
+ |-------|--------|-------------|
202
+ | Tasks | task-outcome-recorder JSONL | Count of entries per agent_type |
203
+ | Success Rate | outcome field | `success_count / total_count * 100` |
204
+ | Avg Model | model field | Most frequently used model |
205
+ | Last Used | timestamp field | Most recent invocation |
206
+
207
+ ### Budget Management
208
+
209
+ The Metrics section shares the 200-line MEMORY.md budget:
210
+ 1. Max 20 agent rows in Metrics table
211
+ 2. When adding new agent, prune agent with lowest task count
212
+ 3. Merge identical agent types across sessions (cumulative)
213
+
214
+ -->
215
+
216
+ <!-- DETAIL: User Model (sys-memory-keeper reference)
217
+
218
+ MEMORY.md supports an optional `## User Model` section (DISTINCT from `## Behaviors`) for tracking structured user interaction patterns.
219
+
220
+ ### User Model vs Behaviors
221
+
222
+ | Aspect | Behaviors | User Model |
223
+ |--------|-----------|------------|
224
+ | Focus | Communication/workflow preferences | Correction patterns, expertise, skill usage |
225
+ | Source | Conversation style observations | R016 violations, tool invocations, override decisions |
226
+ | Update | Session-end extraction | Session-end aggregation from task outcomes |
227
+
228
+ ### User Model Section Format
229
+
230
+ ## User Model [auto-updated by sys-memory-keeper]
231
+
232
+ ### Correction Patterns [confidence: medium]
233
+ - R010 direct-write attempts: 3 times → now delegates consistently
234
+ - Prefers explicit agent selection over auto-routing
235
+
236
+ ### Skill Preferences [confidence: high]
237
+ | Skill | Invocations | Last Used |
238
+ |-------|------------|-----------|
239
+ | /research | 12 | 2026-04-03 |
240
+ | /pipeline auto-dev | 8 | 2026-04-03 |
241
+
242
+ ### Expertise Profile [confidence: medium]
243
+ - Primary domains: TypeScript, Python, Go
244
+ - Focus: AI agent orchestration, CLI tooling
245
+
246
+ ### Override Decisions [confidence: low]
247
+ - Overrode /scout SKIP verdict → INTEGRATE for RTK (#756)
248
+
249
+ ### Categories
250
+
251
+ | Category | Source | Description |
252
+ |----------|--------|-------------|
253
+ | Correction Patterns | R016 violation history | Rules the user corrected most |
254
+ | Skill Preferences | Skill tool invocation count | Most-invoked skills ranked |
255
+ | Expertise Profile | File patterns + routing history | User's domain expertise areas |
256
+ | Override Decisions | Explicit user overrides | When user disagreed with agent recommendation |
257
+
258
+ ### Budget Management
259
+
260
+ User Model shares the 200-line MEMORY.md budget:
261
+ - Max 30 lines for User Model section
262
+ - Prune low-confidence entries first
263
+ - Skill Preferences table: max 10 rows (top by invocation count)
264
+ - Override Decisions: max 5 entries (most recent)
265
+
266
+ ### Extraction Guidelines
267
+
268
+ sys-memory-keeper extracts user model data at session end:
269
+ 1. Parse task outcomes for Skill invocations → update Skill Preferences
270
+ 2. Scan conversation for R016 violations → update Correction Patterns
271
+ 3. Analyze file patterns and routing decisions → update Expertise Profile
272
+ 4. Detect explicit user overrides (verdict changes, agent redirects) → update Override Decisions
273
+
274
+ ### Precedence
275
+
276
+ User Model data feeds into intent-detection (R015) and routing skill confidence scoring. Higher expertise in a domain → higher confidence for auto-routing to that domain's agent.
277
+
278
+ -->
279
+
280
+ ## Mid-Session Immediate Save
281
+
282
+ Save memory IMMEDIATELY upon surprising discovery — do not defer to session end.
283
+
284
+ | Trigger | Action | Rationale |
285
+ |---------|--------|-----------|
286
+ | Repeated pattern observed (2nd time) | Save `feedback_*.md` now | Pattern will recur within session |
287
+ | Unexpected tool behavior / workaround | Save `feedback_*.md` now | Session state defense |
288
+ | Subagent false-positive detected | Save `feedback_*.md` now | Prevent repeat in same session |
289
+ | User correction / feedback | Save `feedback_*.md` now | Honor correction immediately |
290
+
291
+ ### Why Immediate?
292
+
293
+ Session-end saves lose context: by the time the session ends, multiple discoveries have compounded and nuance is lost. Immediate saves preserve the exact trigger context that makes the memory actionable.
294
+
295
+ **Anti-pattern**: "I'll batch all learnings at session end" — by then you'll have forgotten WHY each one mattered, and further violations may have occurred using the un-saved pattern.
296
+
297
+ ### Cross-reference
298
+
299
+ Related records from session v0.87.2~v0.88.0 (issue #869):
300
+ - `feedback_subagent_pre_existing_claims.md`
301
+ - `feedback_github_workflows_inventory.md`
302
+ - `feedback_bun_mock_module.md`
303
+
304
+ ## Session-End Auto-Save
305
+
306
+ ### Trigger
307
+
308
+ Session-end detected when user says: "끝", "종료", "마무리", "done", "wrap up", "end session", or explicitly requests session save.
309
+
310
+ ### Flow
311
+
312
+ ```
313
+ User signals session end
314
+ → Orchestrator delegates to sys-memory-keeper
315
+ → sys-memory-keeper performs:
316
+ 1. Collect session summary (tasks, decisions, open items)
317
+ 2. Update native auto-memory (MEMORY.md)
318
+ 3. Return formatted summary to orchestrator
319
+ → Orchestrator performs MCP saves directly:
320
+ 1. claude-mem save (if available via ToolSearch)
321
+ (episodic-memory auto-indexes after session — no action needed)
322
+ → Orchestrator confirms to user
323
+ ```
324
+
325
+ ### Responsibility Split
326
+
327
+ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inherited by subagents. Therefore:
328
+
329
+ | Responsibility | Owner | Reason |
330
+ |----------------|-------|--------|
331
+ | Session summary collection | sys-memory-keeper | Domain expertise in memory formatting |
332
+ | Native auto-memory (MEMORY.md) | sys-memory-keeper | Has Write access to memory directory |
333
+ | claude-mem MCP save | Orchestrator | MCP tools only available at orchestrator level |
334
+ | episodic-memory | Automatic | Conversations are auto-indexed after session ends — no manual action needed |
335
+
336
+ ### Dual-System Save
337
+
338
+ | System | Owner | Tool | Action | Required |
339
+ |--------|-------|------|--------|----------|
340
+ | Native auto-memory | sys-memory-keeper | Write | Update MEMORY.md with session learnings | Yes |
341
+ | claude-mem | Orchestrator | `mcp__plugin_claude-mem_mcp-search__save_memory` | Save session summary with project, tasks, decisions | No (best-effort) |
342
+ | episodic-memory | Automatic | (auto-indexed) | No action needed — conversations are indexed automatically after session ends | N/A |
343
+
344
+ ### Session-End Self-Check (MANDATORY)
345
+
346
+ ```
347
+ ╔══════════════════════════════════════════════════════════════════╗
348
+ ║ BEFORE CONFIRMING SESSION-END TO USER: ║
349
+ ║ ║
350
+ ║ 1. Did sys-memory-keeper update MEMORY.md? ║
351
+ ║ YES → Continue ║
352
+ ║ NO → Delegate to sys-memory-keeper first ║
353
+ ║ ║
354
+ ║ 2. Did I attempt claude-mem save? ║
355
+ ║ YES → Continue (even if it failed) ║
356
+ ║ NO → ToolSearch + save now ║
357
+ ║ ║
358
+ ║ Note: episodic-memory auto-indexes conversations after session ║
359
+ ║ ends. No manual action needed — do NOT search as "verification" ║
360
+ ║ ║
361
+ ║ BOTH steps must be completed before confirming to user. ║
362
+ ║ "Attempted" means called the tool — failure is OK, skipping ║
363
+ ║ is NOT. ║
364
+ ╚══════════════════════════════════════════════════════════════════╝
365
+ ```
366
+
367
+ ### Failure Policy
368
+
369
+ - MCP saves are **non-blocking**: memory failure MUST NOT prevent session from ending
370
+ - If claude-mem unavailable: skip, log warning
371
+ - episodic-memory: no action needed (auto-indexed after session)
@@ -0,0 +1,49 @@
1
+ # [SHOULD] Ontology-RAG Assisted Routing
2
+
3
+ > **Priority**: SHOULD | **ID**: R019
4
+
5
+ ## Core Rule
6
+
7
+ Routing skills SHOULD use ontology-RAG's `get_agent_for_task` MCP tool to enrich agent selection with contextual skill suggestions. Ontology-RAG is an enrichment layer — it does NOT replace static routing.
8
+
9
+ ## Integration Pattern
10
+
11
+ After static routing selects an agent, call `get_agent_for_task(query)` and extract `suggested_skills` from the response. Inject these into the spawned agent's prompt as contextual hints.
12
+
13
+ ```
14
+ Static routing → agent selected
15
+
16
+ get_agent_for_task(original_query)
17
+
18
+ Extract suggested_skills
19
+
20
+ Prepend to spawned agent prompt:
21
+ "Ontology context suggests these skills may be relevant: {suggested_skills}"
22
+ ```
23
+
24
+ ## Failure Handling
25
+
26
+ | Scenario | Action |
27
+ |----------|--------|
28
+ | MCP server unavailable | Skip silently, proceed with unmodified prompt |
29
+ | get_agent_for_task returns empty | Proceed with unmodified prompt |
30
+ | Response parsing error | Skip silently, log warning |
31
+
32
+ **MCP failure MUST NOT block or delay routing.** Ontology-RAG is advisory only.
33
+
34
+ ## Scope
35
+
36
+ | Applies to | Details |
37
+ |------------|---------|
38
+ | secretary-routing | Enriches manager agent selection |
39
+ | dev-lead-routing | Enriches language/framework expert selection |
40
+ | de-lead-routing | Enriches data engineering expert selection |
41
+ | qa-lead-routing | Enriches QA workflow routing |
42
+
43
+ ## Interaction with Other Rules
44
+
45
+ | Rule | Interaction |
46
+ |------|-------------|
47
+ | R010 | Orchestrator calls MCP tool; subagent receives enriched prompt |
48
+ | R015 | Post-fix confidence (0.30-0.40) remains below R015's 70% threshold; display behavior unchanged |
49
+ | R009 | Ontology-RAG call adds ~300 tokens; no parallelism impact |
@@ -0,0 +1,73 @@
1
+ # [SHOULD] Wiki Sync Rules
2
+
3
+ > **Priority**: SHOULD | **ID**: R022
4
+
5
+ ## Core Rule
6
+
7
+ When agents, skills, rules, or guides are created or modified, corresponding wiki pages SHOULD be updated to keep the knowledge base current. The wiki is the project's compiled knowledge — stale wikis degrade team and LLM onboarding speed.
8
+
9
+ ## When to Sync
10
+
11
+ | Change Type | Wiki Action |
12
+ |-------------|-------------|
13
+ | New agent created | Create wiki/agents/{name}.md |
14
+ | Agent modified | Update wiki/agents/{name}.md |
15
+ | New skill created | Create wiki/skills/{name}.md |
16
+ | Skill modified | Update wiki/skills/{name}.md |
17
+ | Rule created/modified | Update wiki/rules/r{nnn}.md |
18
+ | Guide created/modified | Update wiki/guides/{name}.md |
19
+ | Architecture change | Update wiki/architecture/ pages |
20
+ | Multiple changes | Run `/omcodex:wiki` for full update |
21
+
22
+ ## How to Sync
23
+
24
+ | Method | When |
25
+ |--------|------|
26
+ | `/omcodex:wiki ingest <path>` | Single file/directory changed |
27
+ | `/omcodex:wiki` | Multiple files changed or periodic refresh |
28
+ | `/omcodex:wiki lint` | After major structural changes |
29
+ | Automatic (CI) | `.github/workflows/wiki-sync.yml` checks on PR |
30
+
31
+ ## Delegation — All wiki writes via wiki-curator agent (R010). See workflow via Read tool.
32
+
33
+ <!-- DETAIL: Delegation
34
+ All wiki writes MUST go through the `wiki-curator` agent (R010). The orchestrator reads wiki pages freely but never writes them directly.
35
+
36
+ ```
37
+ Orchestrator
38
+ ├── Detects source change
39
+ ├── Delegates to wiki-curator
40
+ │ ├── Reads source file
41
+ │ ├── Creates/updates wiki page
42
+ │ ├── Updates cross-references
43
+ │ └── Updates index.md
44
+ └── Verifies via wiki lint
45
+ ```
46
+ -->
47
+
48
+ ## Integration — Interacts with R010, R017, R020, R006, R021. See table via Read tool.
49
+
50
+ <!-- DETAIL: Integration
51
+ | Rule | Interaction |
52
+ |------|-------------|
53
+ | R010 | Wiki writes delegated to wiki-curator agent |
54
+ | R017 | Wiki sync added to sauron verification Phase 3 |
55
+ | R020 | Wiki-dependent tasks verify wiki is current before [Done] |
56
+ | R006 | Wiki pages follow same separation of concerns as source |
57
+ | R021 | SHOULD priority — advisory enforcement, CI check |
58
+ -->
59
+
60
+ ## CI Enforcement
61
+
62
+ `.github/workflows/wiki-sync.yml` checks for missing wiki pages on every PR. Missing pages cause CI failure with guidance to run `/omcodex:wiki`.
63
+
64
+ ## Self-Check — 3 checks: wiki pages updated, index refreshed, lint passed. See details via Read tool.
65
+
66
+ <!-- DETAIL: Self-Check
67
+ Before completing a session that modified agents/skills/rules/guides:
68
+ 1. Were wiki pages updated for all changes?
69
+ 2. Was index.md refreshed?
70
+ 3. Did wiki lint pass?
71
+
72
+ If any NO → run `/omcodex:wiki ingest` for affected paths.
73
+ -->
@@ -0,0 +1,141 @@
1
+ # Global Rules
2
+ # Priority: MUST > SHOULD > MAY
3
+
4
+ rules:
5
+ # MUST - Never violate
6
+ - id: R000
7
+ name: language-policy
8
+ title: Language & Delegation Policy
9
+ path: ./MUST-language-policy.md
10
+ priority: MUST
11
+ scope: all
12
+
13
+ - id: R001
14
+ name: safety
15
+ title: Safety Rules
16
+ path: ./MUST-safety.md
17
+ priority: MUST
18
+ scope: all
19
+
20
+ - id: R002
21
+ name: permissions
22
+ title: Permission Rules
23
+ path: ./MUST-permissions.md
24
+ priority: MUST
25
+ scope: all
26
+
27
+ - id: R007
28
+ name: agent-identification
29
+ title: Agent Identification Rules
30
+ path: ./MUST-agent-identification.md
31
+ priority: MUST
32
+ scope: all
33
+
34
+ - id: R008
35
+ name: tool-identification
36
+ title: Tool Usage Identification Rules
37
+ path: ./MUST-tool-identification.md
38
+ priority: MUST
39
+ scope: all
40
+
41
+ - id: R009
42
+ name: parallel-execution
43
+ title: Parallel Execution Rules
44
+ path: ./MUST-parallel-execution.md
45
+ priority: MUST
46
+ scope: all
47
+
48
+ # Agent Design - MUST
49
+ - id: R006
50
+ name: agent-design
51
+ title: Agent Design Rules
52
+ path: ./MUST-agent-design.md
53
+ priority: MUST
54
+ scope: agents
55
+
56
+ # Orchestrator Coordination - MUST
57
+ - id: R010
58
+ name: orchestrator-coordination
59
+ title: Orchestrator Coordination Rules
60
+ path: ./MUST-orchestrator-coordination.md
61
+ priority: MUST
62
+ scope: agents
63
+
64
+ # Intent Transparency - MUST
65
+ - id: R015
66
+ name: intent-transparency
67
+ title: Intent Transparency Rules
68
+ path: ./MUST-intent-transparency.md
69
+ priority: MUST
70
+ scope: orchestrator
71
+
72
+ # Continuous Improvement - MUST
73
+ - id: R016
74
+ name: continuous-improvement
75
+ title: Continuous Improvement Rules
76
+ path: ./MUST-continuous-improvement.md
77
+ priority: MUST
78
+ scope: all
79
+
80
+ # Sync Verification - MUST
81
+ - id: R017
82
+ name: sync-verification
83
+ title: Sync Verification Rules
84
+ path: ./MUST-sync-verification.md
85
+ priority: MUST
86
+ scope: all
87
+
88
+ # SHOULD - Strongly recommended
89
+ - id: R003
90
+ name: interaction
91
+ title: Interaction Rules
92
+ path: ./SHOULD-interaction.md
93
+ priority: SHOULD
94
+ scope: all
95
+
96
+ - id: R004
97
+ name: error-handling
98
+ title: Error Handling Rules
99
+ path: ./SHOULD-error-handling.md
100
+ priority: SHOULD
101
+ scope: all
102
+
103
+ # Memory Integration - SHOULD
104
+ - id: R011
105
+ name: memory-integration
106
+ title: Memory Integration Rules
107
+ path: ./SHOULD-memory-integration.md
108
+ priority: SHOULD
109
+ scope: all
110
+
111
+ # HUD Statusline - SHOULD
112
+ - id: R012
113
+ name: hud-statusline
114
+ title: HUD Statusline Rules
115
+ path: ./SHOULD-hud-statusline.md
116
+ priority: SHOULD
117
+ scope: all
118
+
119
+ # Ecomode - SHOULD
120
+ - id: R013
121
+ name: ecomode
122
+ title: Ecomode Rules
123
+ path: ./SHOULD-ecomode.md
124
+ priority: SHOULD
125
+ scope: all
126
+
127
+ # Agent Teams - MUST (Conditional)
128
+ - id: R018
129
+ name: agent-teams
130
+ title: Agent Teams Rules (Conditional)
131
+ path: ./MUST-agent-teams.md
132
+ priority: MUST
133
+ scope: orchestrator
134
+
135
+ # MAY - Optional
136
+ - id: R005
137
+ name: optimization
138
+ title: Optimization Guide
139
+ path: ./MAY-optimization.md
140
+ priority: MAY
141
+ scope: all
@@ -0,0 +1,62 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "description": "Tool input validation schemas for PreToolUse hook",
4
+ "definitions": {
5
+ "Write": {
6
+ "type": "object",
7
+ "required": ["file_path", "content"],
8
+ "properties": {
9
+ "file_path": {
10
+ "type": "string",
11
+ "minLength": 1,
12
+ "description": "Absolute file path to write"
13
+ },
14
+ "content": {
15
+ "type": "string",
16
+ "description": "File content to write"
17
+ }
18
+ }
19
+ },
20
+ "Edit": {
21
+ "type": "object",
22
+ "required": ["file_path", "old_string", "new_string"],
23
+ "properties": {
24
+ "file_path": {
25
+ "type": "string",
26
+ "minLength": 1,
27
+ "description": "Absolute file path to edit"
28
+ },
29
+ "old_string": {
30
+ "type": "string",
31
+ "minLength": 1,
32
+ "description": "Text to find and replace"
33
+ },
34
+ "new_string": {
35
+ "type": "string",
36
+ "description": "Replacement text"
37
+ }
38
+ },
39
+ "additionalValidation": {
40
+ "rule": "old_string !== new_string",
41
+ "message": "old_string and new_string must be different"
42
+ }
43
+ },
44
+ "Bash": {
45
+ "type": "object",
46
+ "required": ["command"],
47
+ "properties": {
48
+ "command": {
49
+ "type": "string",
50
+ "minLength": 1,
51
+ "description": "Shell command to execute"
52
+ }
53
+ },
54
+ "dangerousPatterns": [
55
+ { "pattern": "rm\\s+-rf\\s+/", "message": "Dangerous recursive delete from root" },
56
+ { "pattern": "sudo\\s+", "message": "Elevated privilege command detected" },
57
+ { "pattern": "> /dev/sd", "message": "Direct disk write detected" },
58
+ { "pattern": "mkfs\\.", "message": "Filesystem format command detected" }
59
+ ]
60
+ }
61
+ }
62
+ }