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.
- package/LICENSE +21 -0
- package/README.md +327 -0
- package/dist/cli/index.js +32054 -0
- package/dist/index.js +5469 -0
- package/package.json +89 -0
- package/templates/.claude/agents/arch-documenter.md +38 -0
- package/templates/.claude/agents/arch-speckit-agent.md +66 -0
- package/templates/.claude/agents/be-django-expert.md +47 -0
- package/templates/.claude/agents/be-express-expert.md +31 -0
- package/templates/.claude/agents/be-fastapi-expert.md +45 -0
- package/templates/.claude/agents/be-go-backend-expert.md +45 -0
- package/templates/.claude/agents/be-nestjs-expert.md +29 -0
- package/templates/.claude/agents/be-springboot-expert.md +42 -0
- package/templates/.claude/agents/db-alembic-expert.md +73 -0
- package/templates/.claude/agents/db-postgres-expert.md +38 -0
- package/templates/.claude/agents/db-redis-expert.md +38 -0
- package/templates/.claude/agents/db-supabase-expert.md +37 -0
- package/templates/.claude/agents/de-airflow-expert.md +48 -0
- package/templates/.claude/agents/de-dbt-expert.md +36 -0
- package/templates/.claude/agents/de-kafka-expert.md +83 -0
- package/templates/.claude/agents/de-pipeline-expert.md +34 -0
- package/templates/.claude/agents/de-snowflake-expert.md +38 -0
- package/templates/.claude/agents/de-spark-expert.md +38 -0
- package/templates/.claude/agents/fe-design-expert.md +120 -0
- package/templates/.claude/agents/fe-flutter-agent.md +48 -0
- package/templates/.claude/agents/fe-svelte-agent.md +33 -0
- package/templates/.claude/agents/fe-vercel-agent.md +40 -0
- package/templates/.claude/agents/fe-vuejs-agent.md +34 -0
- package/templates/.claude/agents/infra-aws-expert.md +49 -0
- package/templates/.claude/agents/infra-docker-expert.md +49 -0
- package/templates/.claude/agents/lang-golang-expert.md +46 -0
- package/templates/.claude/agents/lang-java21-expert.md +42 -0
- package/templates/.claude/agents/lang-kotlin-expert.md +45 -0
- package/templates/.claude/agents/lang-python-expert.md +45 -0
- package/templates/.claude/agents/lang-rust-expert.md +45 -0
- package/templates/.claude/agents/lang-typescript-expert.md +45 -0
- package/templates/.claude/agents/mgr-claude-code-bible.md +62 -0
- package/templates/.claude/agents/mgr-creator.md +57 -0
- package/templates/.claude/agents/mgr-gitnerd.md +50 -0
- package/templates/.claude/agents/mgr-sauron.md +163 -0
- package/templates/.claude/agents/mgr-supplier.md +39 -0
- package/templates/.claude/agents/mgr-updater.md +40 -0
- package/templates/.claude/agents/qa-engineer.md +36 -0
- package/templates/.claude/agents/qa-planner.md +78 -0
- package/templates/.claude/agents/qa-writer.md +32 -0
- package/templates/.claude/agents/sec-codeql-expert.md +56 -0
- package/templates/.claude/agents/slack-cli-expert.md +98 -0
- package/templates/.claude/agents/souls/lang-golang-expert.soul.md +21 -0
- package/templates/.claude/agents/sys-memory-keeper.md +123 -0
- package/templates/.claude/agents/sys-naggy.md +76 -0
- package/templates/.claude/agents/tool-bun-expert.md +26 -0
- package/templates/.claude/agents/tool-npm-expert.md +31 -0
- package/templates/.claude/agents/tool-optimizer.md +37 -0
- package/templates/.claude/agents/wiki-curator.md +72 -0
- package/templates/.claude/config/required-plugins.json +30 -0
- package/templates/.claude/contexts/dev.md +20 -0
- package/templates/.claude/contexts/ecomode.md +110 -0
- package/templates/.claude/contexts/index.yaml +41 -0
- package/templates/.claude/contexts/research.md +28 -0
- package/templates/.claude/contexts/review.md +23 -0
- package/templates/.claude/hooks/hooks.json +533 -0
- package/templates/.claude/hooks/scripts/adaptive-harness-scan.sh +45 -0
- package/templates/.claude/hooks/scripts/agent-start-recorder.sh +40 -0
- package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +76 -0
- package/templates/.claude/hooks/scripts/audit-log.sh +64 -0
- package/templates/.claude/hooks/scripts/auto-continue-guard.sh +33 -0
- package/templates/.claude/hooks/scripts/content-hash-validator.sh +75 -0
- package/templates/.claude/hooks/scripts/context-budget-advisor.sh +107 -0
- package/templates/.claude/hooks/scripts/cost-cap-advisor.sh +71 -0
- package/templates/.claude/hooks/scripts/cwd-change-detector.sh +36 -0
- package/templates/.claude/hooks/scripts/eval-core-batch-save.sh +46 -0
- package/templates/.claude/hooks/scripts/feedback-collector.sh +92 -0
- package/templates/.claude/hooks/scripts/file-change-validator.sh +26 -0
- package/templates/.claude/hooks/scripts/git-delegation-guard.sh +57 -0
- package/templates/.claude/hooks/scripts/model-escalation-advisor.sh +106 -0
- package/templates/.claude/hooks/scripts/omcodex-auto-update.sh +4 -0
- package/templates/.claude/hooks/scripts/omcustom-auto-update.sh +177 -0
- package/templates/.claude/hooks/scripts/rtk-intercept.sh +77 -0
- package/templates/.claude/hooks/scripts/rule-deletion-guard.sh +60 -0
- package/templates/.claude/hooks/scripts/schema-validator.sh +106 -0
- package/templates/.claude/hooks/scripts/secret-filter.sh +100 -0
- package/templates/.claude/hooks/scripts/session-autofix-prompt.sh +34 -0
- package/templates/.claude/hooks/scripts/session-autofix.sh +146 -0
- package/templates/.claude/hooks/scripts/session-env-check.sh +254 -0
- package/templates/.claude/hooks/scripts/skill-extractor-analyzer.sh +49 -0
- package/templates/.claude/hooks/scripts/stage-blocker.sh +16 -0
- package/templates/.claude/hooks/scripts/stale-todo-scanner.sh +91 -0
- package/templates/.claude/hooks/scripts/stall-detection-advisor.sh +112 -0
- package/templates/.claude/hooks/scripts/stop-console-audit.sh +46 -0
- package/templates/.claude/hooks/scripts/stuck-detector.sh +199 -0
- package/templates/.claude/hooks/scripts/task-outcome-recorder.sh +119 -0
- package/templates/.claude/hooks/scripts/task-state-precompact.sh +58 -0
- package/templates/.claude/hooks/scripts/user-prompt-preprocessor.sh +32 -0
- package/templates/.claude/hooks/skill-count-reminder.sh +34 -0
- package/templates/.claude/install-hooks.sh +100 -0
- package/templates/.claude/ontology/agents.yaml +546 -0
- package/templates/.claude/ontology/graphs/agent-skill.json +102 -0
- package/templates/.claude/ontology/graphs/full-graph.json +629 -0
- package/templates/.claude/ontology/graphs/routing.json +112 -0
- package/templates/.claude/ontology/graphs/skill-rule.json +78 -0
- package/templates/.claude/ontology/rules.yaml +251 -0
- package/templates/.claude/ontology/schema.yaml +144 -0
- package/templates/.claude/ontology/skills.yaml +575 -0
- package/templates/.claude/rules/MAY-optimization.md +42 -0
- package/templates/.claude/rules/MUST-agent-design.md +340 -0
- package/templates/.claude/rules/MUST-agent-identification.md +77 -0
- package/templates/.claude/rules/MUST-agent-teams.md +293 -0
- package/templates/.claude/rules/MUST-completion-verification.md +112 -0
- package/templates/.claude/rules/MUST-continuous-improvement.md +69 -0
- package/templates/.claude/rules/MUST-enforcement-policy.md +50 -0
- package/templates/.claude/rules/MUST-intent-transparency.md +74 -0
- package/templates/.claude/rules/MUST-language-policy.md +28 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +399 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +184 -0
- package/templates/.claude/rules/MUST-permissions.md +32 -0
- package/templates/.claude/rules/MUST-safety.md +23 -0
- package/templates/.claude/rules/MUST-sync-verification.md +145 -0
- package/templates/.claude/rules/MUST-tool-identification.md +97 -0
- package/templates/.claude/rules/SHOULD-ecomode.md +123 -0
- package/templates/.claude/rules/SHOULD-error-handling.md +33 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +51 -0
- package/templates/.claude/rules/SHOULD-interaction.md +77 -0
- package/templates/.claude/rules/SHOULD-memory-integration.md +371 -0
- package/templates/.claude/rules/SHOULD-ontology-rag-routing.md +49 -0
- package/templates/.claude/rules/SHOULD-wiki-sync.md +73 -0
- package/templates/.claude/rules/index.yaml +141 -0
- package/templates/.claude/schemas/tool-inputs.json +62 -0
- package/templates/.claude/skills/action-validator/SKILL.md +89 -0
- package/templates/.claude/skills/adaptive-harness/SKILL.md +335 -0
- package/templates/.claude/skills/adversarial-review/SKILL.md +80 -0
- package/templates/.claude/skills/agora/SKILL.md +194 -0
- package/templates/.claude/skills/airflow-best-practices/SKILL.md +94 -0
- package/templates/.claude/skills/alembic-best-practices/SKILL.md +295 -0
- package/templates/.claude/skills/ambiguity-gate/SKILL.md +94 -0
- package/templates/.claude/skills/analysis/SKILL.md +223 -0
- package/templates/.claude/skills/audit-agents/SKILL.md +118 -0
- package/templates/.claude/skills/aws-best-practices/SKILL.md +281 -0
- package/templates/.claude/skills/claude-code-bible/SKILL.md +93 -0
- package/templates/.claude/skills/claude-code-bible/scripts/fetch-docs.js +244 -0
- package/templates/.claude/skills/claude-native/SKILL.md +215 -0
- package/templates/.claude/skills/codex-exec/SKILL.md +206 -0
- package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +430 -0
- package/templates/.claude/skills/create-agent/SKILL.md +94 -0
- package/templates/.claude/skills/cve-triage/SKILL.md +91 -0
- package/templates/.claude/skills/dag-orchestration/SKILL.md +201 -0
- package/templates/.claude/skills/dbt-best-practices/SKILL.md +55 -0
- package/templates/.claude/skills/de-lead-routing/SKILL.md +230 -0
- package/templates/.claude/skills/deep-plan/SKILL.md +344 -0
- package/templates/.claude/skills/deep-verify/SKILL.md +111 -0
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +161 -0
- package/templates/.claude/skills/dev-refactor/SKILL.md +234 -0
- package/templates/.claude/skills/dev-review/SKILL.md +172 -0
- package/templates/.claude/skills/django-best-practices/SKILL.md +334 -0
- package/templates/.claude/skills/docker-best-practices/SKILL.md +276 -0
- package/templates/.claude/skills/evaluator-optimizer/SKILL.md +421 -0
- package/templates/.claude/skills/fastapi-best-practices/SKILL.md +271 -0
- package/templates/.claude/skills/fix-refs/SKILL.md +109 -0
- package/templates/.claude/skills/flutter-best-practices/SKILL.md +325 -0
- package/templates/.claude/skills/gemini-exec/SKILL.md +215 -0
- package/templates/.claude/skills/gemini-exec/scripts/gemini-wrapper.cjs +485 -0
- package/templates/.claude/skills/go-backend-best-practices/SKILL.md +135 -0
- package/templates/.claude/skills/go-best-practices/SKILL.md +204 -0
- package/templates/.claude/skills/hada-scout/SKILL.md +92 -0
- package/templates/.claude/skills/harness-eval/SKILL.md +95 -0
- package/templates/.claude/skills/harness-synthesizer/SKILL.md +145 -0
- package/templates/.claude/skills/help/SKILL.md +127 -0
- package/templates/.claude/skills/idea/SKILL.md +88 -0
- package/templates/.claude/skills/impeccable-design/SKILL.md +173 -0
- package/templates/.claude/skills/intent-detection/SKILL.md +293 -0
- package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +438 -0
- package/templates/.claude/skills/java21-best-practices/SKILL.md +190 -0
- package/templates/.claude/skills/jinja2-prompts/SKILL.md +86 -0
- package/templates/.claude/skills/kafka-best-practices/SKILL.md +53 -0
- package/templates/.claude/skills/kotlin-best-practices/SKILL.md +257 -0
- package/templates/.claude/skills/lists/SKILL.md +80 -0
- package/templates/.claude/skills/memory-management/SKILL.md +196 -0
- package/templates/.claude/skills/memory-recall/SKILL.md +172 -0
- package/templates/.claude/skills/memory-save/SKILL.md +128 -0
- package/templates/.claude/skills/model-escalation/SKILL.md +62 -0
- package/templates/.claude/skills/monitoring-setup/SKILL.md +215 -0
- package/templates/.claude/skills/multi-model-verification/SKILL.md +130 -0
- package/templates/.claude/skills/npm-audit/SKILL.md +74 -0
- package/templates/.claude/skills/npm-publish/SKILL.md +65 -0
- package/templates/.claude/skills/npm-version/SKILL.md +104 -0
- package/templates/.claude/skills/omcodex-auto-improve/SKILL.md +136 -0
- package/templates/.claude/skills/omcodex-feedback/SKILL.md +205 -0
- package/templates/.claude/skills/omcodex-improve-report/SKILL.md +65 -0
- package/templates/.claude/skills/omcodex-loop/SKILL.md +45 -0
- package/templates/.claude/skills/omcodex-release-notes/SKILL.md +117 -0
- package/templates/.claude/skills/omcodex-takeover/SKILL.md +115 -0
- package/templates/.claude/skills/omcodex-web/SKILL.md +95 -0
- package/templates/.claude/skills/optimize-analyze/SKILL.md +57 -0
- package/templates/.claude/skills/optimize-bundle/SKILL.md +69 -0
- package/templates/.claude/skills/optimize-report/SKILL.md +76 -0
- package/templates/.claude/skills/peer-messaging/SKILL.md +59 -0
- package/templates/.claude/skills/pipeline/SKILL.md +103 -0
- package/templates/.claude/skills/pipeline-architecture-patterns/SKILL.md +84 -0
- package/templates/.claude/skills/pipeline-guards/SKILL.md +173 -0
- package/templates/.claude/skills/post-release-followup/SKILL.md +134 -0
- package/templates/.claude/skills/postgres-best-practices/SKILL.md +67 -0
- package/templates/.claude/skills/pr-auto-improve/SKILL.md +129 -0
- package/templates/.claude/skills/professor-triage/SKILL.md +321 -0
- package/templates/.claude/skills/python-best-practices/SKILL.md +223 -0
- package/templates/.claude/skills/qa-lead-routing/SKILL.md +104 -0
- package/templates/.claude/skills/react-best-practices/SKILL.md +102 -0
- package/templates/.claude/skills/reasoning-sandwich/SKILL.md +64 -0
- package/templates/.claude/skills/redis-best-practices/SKILL.md +84 -0
- package/templates/.claude/skills/release-plan/SKILL.md +207 -0
- package/templates/.claude/skills/research/SKILL.md +493 -0
- package/templates/.claude/skills/result-aggregation/SKILL.md +165 -0
- package/templates/.claude/skills/rtk-exec/SKILL.md +199 -0
- package/templates/.claude/skills/rtk-exec/scripts/rtk-wrapper.cjs +377 -0
- package/templates/.claude/skills/rust-best-practices/SKILL.md +268 -0
- package/templates/.claude/skills/sauron-watch/SKILL.md +239 -0
- package/templates/.claude/skills/scout/SKILL.md +250 -0
- package/templates/.claude/skills/sdd/SKILL.md +24 -0
- package/templates/.claude/skills/sdd-dev/SKILL.md +257 -0
- package/templates/.claude/skills/sdd-development/SKILL.md +24 -0
- package/templates/.claude/skills/secretary-routing/SKILL.md +132 -0
- package/templates/.claude/skills/skill-extractor/SKILL.md +155 -0
- package/templates/.claude/skills/skills-sh-search/SKILL.md +210 -0
- package/templates/.claude/skills/snowflake-best-practices/SKILL.md +66 -0
- package/templates/.claude/skills/spark-best-practices/SKILL.md +53 -0
- package/templates/.claude/skills/springboot-best-practices/SKILL.md +74 -0
- package/templates/.claude/skills/springboot-best-practices/examples/config-properties-example.java +22 -0
- package/templates/.claude/skills/springboot-best-practices/examples/controller-example.java +28 -0
- package/templates/.claude/skills/springboot-best-practices/examples/controller-test-example.java +33 -0
- package/templates/.claude/skills/springboot-best-practices/examples/entity-example.java +22 -0
- package/templates/.claude/skills/springboot-best-practices/examples/exception-handler-example.java +30 -0
- package/templates/.claude/skills/springboot-best-practices/examples/repository-example.java +17 -0
- package/templates/.claude/skills/springboot-best-practices/examples/repository-test-example.java +23 -0
- package/templates/.claude/skills/springboot-best-practices/examples/security-config-example.java +27 -0
- package/templates/.claude/skills/springboot-best-practices/examples/service-example.java +33 -0
- package/templates/.claude/skills/status/SKILL.md +155 -0
- package/templates/.claude/skills/structured-dev-cycle/SKILL.md +200 -0
- package/templates/.claude/skills/stuck-recovery/SKILL.md +80 -0
- package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md +100 -0
- package/templates/.claude/skills/systematic-debugging/SKILL.md +288 -0
- package/templates/.claude/skills/systematic-debugging/condition-based-waiting-example.ts +278 -0
- package/templates/.claude/skills/systematic-debugging/condition-based-waiting.md +240 -0
- package/templates/.claude/skills/systematic-debugging/defense-in-depth.md +252 -0
- package/templates/.claude/skills/systematic-debugging/find-polluter.sh +147 -0
- package/templates/.claude/skills/systematic-debugging/root-cause-tracing.md +87 -0
- package/templates/.claude/skills/task-decomposition/SKILL.md +197 -0
- package/templates/.claude/skills/typescript-best-practices/SKILL.md +322 -0
- package/templates/.claude/skills/update-docs/SKILL.md +142 -0
- package/templates/.claude/skills/update-external/SKILL.md +169 -0
- package/templates/.claude/skills/vercel-deploy/SKILL.md +75 -0
- package/templates/.claude/skills/web-design-guidelines/SKILL.md +119 -0
- package/templates/.claude/skills/wiki/SKILL.md +426 -0
- package/templates/.claude/skills/wiki-rag/SKILL.md +154 -0
- package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +165 -0
- package/templates/.claude/skills/writing-clearly-and-concisely/SKILL.md +66 -0
- package/templates/.claude/statusline.sh +380 -0
- package/templates/.claude/uninstall-hooks.sh +52 -0
- package/templates/.github/workflows/wiki-sync.yml +132 -0
- package/templates/AGENTS.md.en +255 -0
- package/templates/AGENTS.md.ko +255 -0
- package/templates/CLAUDE.md +263 -0
- package/templates/CLAUDE.md.en +256 -0
- package/templates/CLAUDE.md.ko +256 -0
- package/templates/deprecated-files.json +10 -0
- package/templates/guides/agents-md-quality/README.md +110 -0
- package/templates/guides/airflow/README.md +47 -0
- package/templates/guides/alembic/README.md +438 -0
- package/templates/guides/aws/common-patterns.md +169 -0
- package/templates/guides/aws/index.yaml +26 -0
- package/templates/guides/aws/well-architected.md +143 -0
- package/templates/guides/cc-token-saver/README.md +97 -0
- package/templates/guides/claude-code/01-overview.md +42 -0
- package/templates/guides/claude-code/03-tools.md +107 -0
- package/templates/guides/claude-code/04-agent-skills.md +90 -0
- package/templates/guides/claude-code/05-agent-sdk.md +129 -0
- package/templates/guides/claude-code/06-mcp.md +165 -0
- package/templates/guides/claude-code/07-prompt-engineering.md +100 -0
- package/templates/guides/claude-code/08-testing.md +56 -0
- package/templates/guides/claude-code/09-guardrails.md +78 -0
- package/templates/guides/claude-code/10-monitoring.md +87 -0
- package/templates/guides/claude-code/11-sub-agents.md +159 -0
- package/templates/guides/claude-code/12-workflow-patterns.md +182 -0
- package/templates/guides/claude-code/13-cli-flags.md +151 -0
- package/templates/guides/claude-code/index.yaml +61 -0
- package/templates/guides/dbt/README.md +32 -0
- package/templates/guides/django-best-practices/README.md +476 -0
- package/templates/guides/docker/compose-best-practices.md +284 -0
- package/templates/guides/docker/dockerfile-best-practices.md +262 -0
- package/templates/guides/docker/index.yaml +26 -0
- package/templates/guides/drizzle-orm/README.md +69 -0
- package/templates/guides/elements-of-style/elements-of-style.html +2609 -0
- package/templates/guides/fastapi/best-practices.md +232 -0
- package/templates/guides/fastapi/index.yaml +21 -0
- package/templates/guides/flutter/architecture.md +141 -0
- package/templates/guides/flutter/fundamentals.md +119 -0
- package/templates/guides/flutter/index.yaml +44 -0
- package/templates/guides/flutter/performance.md +119 -0
- package/templates/guides/flutter/security.md +120 -0
- package/templates/guides/flutter/state-management.md +144 -0
- package/templates/guides/flutter/testing.md +155 -0
- package/templates/guides/git-worktree-workflow/README.md +138 -0
- package/templates/guides/go-backend/index.yaml +26 -0
- package/templates/guides/go-backend/project-layout.md +243 -0
- package/templates/guides/go-backend/uber-style.md +212 -0
- package/templates/guides/golang/concurrency.md +282 -0
- package/templates/guides/golang/effective-go.md +309 -0
- package/templates/guides/golang/error-handling.md +250 -0
- package/templates/guides/golang/index.yaml +27 -0
- package/templates/guides/hook-data-flow/README.md +135 -0
- package/templates/guides/iceberg/README.md +49 -0
- package/templates/guides/impeccable-design/color-and-contrast.md +278 -0
- package/templates/guides/impeccable-design/index.yaml +12 -0
- package/templates/guides/impeccable-design/motion-design.md +390 -0
- package/templates/guides/impeccable-design/typography.md +386 -0
- package/templates/guides/impeccable-design/ux-writing.md +400 -0
- package/templates/guides/index.yaml +265 -0
- package/templates/guides/java21/index.yaml +29 -0
- package/templates/guides/java21/java-style-guide.md +248 -0
- package/templates/guides/java21/modern-java21.md +303 -0
- package/templates/guides/kafka/README.md +32 -0
- package/templates/guides/kotlin/coding-conventions.md +247 -0
- package/templates/guides/kotlin/idioms.md +234 -0
- package/templates/guides/kotlin/index.yaml +26 -0
- package/templates/guides/multi-model-routing/README.md +101 -0
- package/templates/guides/multi-provider-exec/README.md +83 -0
- package/templates/guides/postgres/README.md +58 -0
- package/templates/guides/python/index.yaml +26 -0
- package/templates/guides/python/pep8-style-guide.md +202 -0
- package/templates/guides/python/zen-of-python.md +79 -0
- package/templates/guides/redis/README.md +50 -0
- package/templates/guides/rust/error-handling.md +262 -0
- package/templates/guides/rust/index.yaml +26 -0
- package/templates/guides/rust/ownership.md +180 -0
- package/templates/guides/skill-bundle-design/README.md +106 -0
- package/templates/guides/slack-cli/README.md +145 -0
- package/templates/guides/snowflake/README.md +32 -0
- package/templates/guides/spark/README.md +32 -0
- package/templates/guides/springboot/best-practices.md +361 -0
- package/templates/guides/springboot/index.yaml +22 -0
- package/templates/guides/supabase-postgres/README.md +32 -0
- package/templates/guides/supabase-postgres/index.yaml +19 -0
- package/templates/guides/typescript/advanced-types.md +225 -0
- package/templates/guides/typescript/index.yaml +26 -0
- package/templates/guides/typescript/type-system.md +219 -0
- package/templates/guides/web-design/accessibility.md +66 -0
- package/templates/guides/web-design/index.yaml +20 -0
- package/templates/guides/web-design/performance.md +102 -0
- package/templates/guides/web-scraping/README.md +926 -0
- package/templates/guides/web-scraping/index.yaml +19 -0
- package/templates/guides/worktree-lifecycle/README.md +104 -0
- package/templates/index.yaml +18 -0
- package/templates/manifest.json +49 -0
- 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
|
+
}
|