oh-my-customcodex 0.1.0

package/templates/.claude/ontology/skills.yaml

@@ -0,0 +1,575 @@
+# Auto-generated from templates/.claude/skills/
+# Do not edit manually — regenerate with: omcustom ontology build
+version: "1.0.0"
+generated_at: "2026-02-12T00:00:00Z"
+
+# Skill class hierarchy
+classes:
+  RoutingSkill:
+    skills: [secretary-routing, dev-lead-routing, de-lead-routing, qa-lead-routing]
+    description: "Route tasks to appropriate agents"
+
+  BestPracticeSkill:
+    skills: [
+      go-best-practices, python-best-practices, rust-best-practices,
+      kotlin-best-practices, typescript-best-practices, react-best-practices,
+      flutter-best-practices, fastapi-best-practices, springboot-best-practices,
+      go-backend-best-practices, docker-best-practices, aws-best-practices,
+      postgres-best-practices, redis-best-practices, supabase-postgres-best-practices,
+      airflow-best-practices, dbt-best-practices, kafka-best-practices,
+      spark-best-practices, snowflake-best-practices, pipeline-architecture-patterns
+    ]
+    description: "Language/framework best practices and architecture patterns"
+
+  ManagementSkill:
+    skills: [create-agent, update-docs, update-external, audit-agents, fix-refs, claude-code-bible]
+    description: "Agent and project management"
+
+  OptimizationSkill:
+    skills: [optimize-analyze, optimize-bundle, optimize-report]
+    description: "Performance optimization"
+
+  MemorySkill:
+    skills: [memory-save, memory-recall, memory-management]
+    description: "Memory persistence operations"
+
+  PackageSkill:
+    skills: [npm-publish, npm-version, npm-audit]
+    description: "Package management"
+
+  DevelopmentSkill:
+    skills: [dev-review, dev-refactor]
+    description: "Code review and refactoring"
+
+  SystemSkill:
+    skills: [status, help, lists]
+    description: "System information and utilities"
+
+  VerificationSkill:
+    skills: [sauron-watch]
+    description: "Verification and compliance"
+
+  IntentSkill:
+    skills: [intent-detection, result-aggregation]
+    description: "Intent analysis and result processing"
+
+  DeploymentSkill:
+    skills: [vercel-deploy]
+    description: "Deployment automation"
+
+  WritingSkill:
+    skills: [writing-clearly-and-concisely, web-design-guidelines]
+    description: "Writing quality and UI/UX guidelines"
+
+  MonitoringSkill:
+    skills: [monitoring-setup]
+    description: "Monitoring configuration"
+
+  ExternalSkillSourceSkill:
+    skills: [skills-sh-search]
+    description: "External skill marketplace discovery and installation"
+
+# Skill instances
+skills:
+  airflow-best-practices:
+    class: BestPracticeSkill
+    description: "Apache Airflow best practices for DAG authoring, testing, and production deployment"
+    user_invocable: false
+    model_invocable: true
+    summary: "Best practices for Airflow DAG authoring, scheduling, testing, and production deployment"
+    keywords: [airflow, dag, scheduling, orchestration, testing, performance]
+    rule_references: []
+
+  audit-agents:
+    class: ManagementSkill
+    description: "Audit agent dependencies and references"
+    user_invocable: true
+    model_invocable: true
+    scope: harness
+    summary: "Audit agent dependencies to ensure all skill and guide references are valid"
+    keywords: [audit, dependencies, validation, references]
+    rule_references: []
+
+  aws-best-practices:
+    class: BestPracticeSkill
+    description: "AWS patterns from Well-Architected Framework"
+    user_invocable: false
+    model_invocable: true
+    summary: "AWS Well-Architected Framework patterns for scalable, secure cloud infrastructure"
+    keywords: [aws, cloud, well-architected, security, performance, cost]
+    rule_references: []
+
+  claude-code-bible:
+    class: ManagementSkill
+    description: "Fetch and verify Claude Code official documentation. Use when checking official spec compliance or updating local reference docs."
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Maintain up-to-date local copies of Claude Code official documentation"
+    keywords: [claude-code, documentation, spec, compliance, verification]
+    rule_references: []
+
+  create-agent:
+    class: ManagementSkill
+    description: "Create a new agent with complete structure"
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Create a new agent with complete directory structure and validation"
+    keywords: [create, agent, structure, validation]
+    rule_references: []
+
+  dbt-best-practices:
+    class: BestPracticeSkill
+    description: "dbt best practices for SQL modeling, testing, and analytics engineering workflows"
+    user_invocable: false
+    model_invocable: true
+    summary: "Best practices for dbt project structure, modeling, testing, and documentation"
+    keywords: [dbt, sql, modeling, testing, analytics-engineering]
+    rule_references: []
+
+  de-lead-routing:
+    class: RoutingSkill
+    description: "Routes data engineering tasks to the correct DE expert agent. Use when user requests data pipeline design, DAG authoring, SQL modeling, stream processing, or warehouse optimization."
+    user_invocable: false
+    model_invocable: true
+    summary: "Routes data engineering tasks to appropriate DE expert agents"
+    keywords: [routing, data-engineering, pipeline, airflow, dbt, spark, kafka, snowflake]
+    routes_to: [de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert]
+    rule_references: [R009]
+
+  dev-lead-routing:
+    class: RoutingSkill
+    description: "Routes development tasks to the correct language or framework expert agent. Use when user requests code review, implementation, refactoring, or debugging."
+    user_invocable: false
+    model_invocable: true
+    summary: "Routes development tasks to appropriate language or framework expert agents"
+    keywords: [routing, development, code-review, implementation, refactoring]
+    routes_to: [
+      lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert,
+      lang-typescript-expert, lang-java21-expert, fe-vercel-agent, fe-vuejs-agent,
+      fe-svelte-agent, fe-flutter-agent, be-fastapi-expert, be-springboot-expert,
+      be-go-backend-expert, be-nestjs-expert, be-express-expert, tool-npm-expert,
+      tool-optimizer, tool-bun-expert, db-supabase-expert, db-postgres-expert,
+      db-redis-expert, arch-documenter, arch-speckit-agent, infra-docker-expert,
+      infra-aws-expert
+    ]
+    rule_references: []
+
+  dev-refactor:
+    class: DevelopmentSkill
+    description: "Refactor code for better structure and patterns"
+    user_invocable: true
+    model_invocable: true
+    summary: "Refactor code using language-specific expert agents for better structure and patterns"
+    keywords: [refactor, structure, patterns, naming, complexity]
+    rule_references: []
+
+  dev-review:
+    class: DevelopmentSkill
+    description: "Review code against language-specific best practices"
+    user_invocable: true
+    model_invocable: true
+    summary: "Review code for best practices using language-specific expert agents"
+    keywords: [review, code-review, best-practices, quality]
+    rule_references: []
+
+  docker-best-practices:
+    class: BestPracticeSkill
+    description: "Docker patterns for optimized containerization"
+    user_invocable: false
+    model_invocable: true
+    summary: "Docker patterns for building optimized and secure container images"
+    keywords: [docker, container, multi-stage, security, optimization]
+    rule_references: []
+
+  fastapi-best-practices:
+    class: BestPracticeSkill
+    description: "FastAPI patterns for high-performance async APIs"
+    user_invocable: false
+    model_invocable: true
+    summary: "FastAPI patterns for building high-performance async APIs with Python"
+    keywords: [fastapi, python, async, api, performance]
+    rule_references: []
+
+  flutter-best-practices:
+    class: BestPracticeSkill
+    description: "Flutter/Dart best practices for widget composition, state management (Riverpod, BLoC), and cross-platform performance optimization"
+    user_invocable: false
+    model_invocable: true
+    summary: "Flutter/Dart best practices for widget composition, state management, and cross-platform mobile/desktop development"
+    keywords: [flutter, dart, riverpod, bloc, widget, cross-platform, mobile, performance]
+    rule_references: []
+
+  fix-refs:
+    class: ManagementSkill
+    description: "Fix broken agent references and symlinks"
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Fix broken references, missing symlinks, and agent dependency issues"
+    keywords: [fix, references, symlinks, dependencies]
+    rule_references: []
+
+  go-backend-best-practices:
+    class: BestPracticeSkill
+    description: "Go backend patterns from Uber style and standard layout"
+    user_invocable: false
+    model_invocable: true
+    summary: "Go backend patterns for building production-ready services"
+    keywords: [go, golang, backend, uber-style, standard-layout]
+    rule_references: []
+
+  go-best-practices:
+    class: BestPracticeSkill
+    description: "Idiomatic Go patterns from Effective Go"
+    user_invocable: false
+    model_invocable: true
+    summary: "Idiomatic Go patterns and best practices from official documentation"
+    keywords: [go, golang, effective-go, formatting, naming, concurrency]
+    rule_references: []
+
+  help:
+    class: SystemSkill
+    description: "Show help information for commands and system"
+    user_invocable: true
+    model_invocable: true
+    scope: harness
+    summary: "Show help information for commands, agents, and system rules"
+    keywords: [help, documentation, commands, agents, rules]
+    rule_references: []
+
+  intent-detection:
+    class: IntentSkill
+    description: "Automatically detect user intent and route to appropriate agent"
+    user_invocable: false
+    model_invocable: true
+    summary: "Detect user intent and route to appropriate agent with transparency"
+    keywords: [intent, detection, routing, confidence, transparency]
+    rule_references: [R015]
+
+  kafka-best-practices:
+    class: BestPracticeSkill
+    description: "Apache Kafka best practices for event streaming, topic design, and producer-consumer patterns"
+    user_invocable: false
+    model_invocable: true
+    summary: "Best practices for Kafka producer-consumer patterns, topic design, and performance"
+    keywords: [kafka, streaming, event, producer, consumer, performance]
+    rule_references: []
+
+  kotlin-best-practices:
+    class: BestPracticeSkill
+    description: "Idiomatic Kotlin patterns from JetBrains conventions"
+    user_invocable: false
+    model_invocable: true
+    summary: "Idiomatic Kotlin patterns and best practices from official JetBrains documentation"
+    keywords: [kotlin, jetbrains, naming, null-safety, coroutines]
+    rule_references: []
+
+  lists:
+    class: SystemSkill
+    description: "Show all available commands"
+    user_invocable: true
+    model_invocable: true
+    scope: harness
+    summary: "Show all available commands with optional filtering and detailed information"
+    keywords: [lists, commands, categories, system]
+    rule_references: []
+
+  memory-management:
+    class: MemorySkill
+    description: "Memory persistence operations using claude-mem"
+    user_invocable: false
+    model_invocable: true
+    summary: "Provide memory persistence operations using claude-mem for session context"
+    keywords: [memory, claude-mem, persistence, session, context]
+    rule_references: [R011]
+
+  memory-recall:
+    class: MemorySkill
+    description: "Search and recall memories from claude-mem"
+    user_invocable: true
+    model_invocable: true
+    summary: "Search and recall relevant memories from claude-mem using semantic search"
+    keywords: [memory, recall, search, semantic, claude-mem]
+    rule_references: [R011]
+
+  memory-save:
+    class: MemorySkill
+    description: "Save current session context to claude-mem"
+    user_invocable: true
+    model_invocable: false
+    summary: "Save current session context to claude-mem for persistence across compaction"
+    keywords: [memory, save, session, context, claude-mem]
+    rule_references: [R011]
+
+  monitoring-setup:
+    class: MonitoringSkill
+    description: "Enable/disable OpenTelemetry console monitoring for Claude Code usage tracking"
+    user_invocable: true
+    model_invocable: true
+    scope: package
+    summary: "Enable or disable OpenTelemetry console monitoring for usage metrics"
+    keywords: [monitoring, telemetry, otel, metrics, usage]
+    rule_references: []
+
+  npm-audit:
+    class: PackageSkill
+    description: "Audit npm dependencies for security and updates"
+    user_invocable: true
+    model_invocable: true
+    scope: package
+    summary: "Audit npm dependencies for security vulnerabilities and outdated packages"
+    keywords: [npm, audit, security, dependencies, vulnerabilities]
+    rule_references: []
+
+  npm-publish:
+    class: PackageSkill
+    description: "Publish package to npm registry with pre-checks"
+    user_invocable: true
+    model_invocable: false
+    scope: package
+    summary: "Publish package to npm registry with comprehensive pre-publish checks"
+    keywords: [npm, publish, package, registry, validation]
+    rule_references: []
+
+  npm-version:
+    class: PackageSkill
+    description: "Manage semantic versions for npm packages"
+    user_invocable: true
+    model_invocable: false
+    scope: package
+    summary: "Manage semantic versions for npm packages with changelog and git integration"
+    keywords: [npm, version, semantic, changelog, git]
+    rule_references: []
+
+  optimize-analyze:
+    class: OptimizationSkill
+    description: "Analyze bundle size and performance metrics"
+    user_invocable: true
+    model_invocable: true
+    summary: "Analyze bundle size and performance metrics for web applications"
+    keywords: [optimize, analyze, bundle, performance, metrics]
+    rule_references: []
+
+  optimize-bundle:
+    class: OptimizationSkill
+    description: "Apply bundle size optimizations"
+    user_invocable: true
+    model_invocable: false
+    summary: "Apply bundle size optimizations to reduce build output and improve performance"
+    keywords: [optimize, bundle, size, performance, build]
+    rule_references: []
+
+  optimize-report:
+    class: OptimizationSkill
+    description: "Generate comprehensive optimization report"
+    user_invocable: true
+    model_invocable: true
+    summary: "Generate comprehensive optimization report with analysis, metrics, and recommendations"
+    keywords: [optimize, report, analysis, metrics, recommendations]
+    rule_references: []
+
+  pipeline-architecture-patterns:
+    class: BestPracticeSkill
+    description: "Data pipeline architecture patterns for ETL/ELT design, orchestration, and data quality frameworks"
+    user_invocable: false
+    model_invocable: true
+    summary: "Architecture patterns for ETL/ELT pipelines, orchestration, and data quality"
+    keywords: [pipeline, architecture, etl, elt, orchestration, data-quality]
+    rule_references: []
+
+  postgres-best-practices:
+    class: BestPracticeSkill
+    description: "PostgreSQL best practices for database design, query optimization, and performance tuning"
+    user_invocable: false
+    model_invocable: true
+    summary: "PostgreSQL best practices for query optimization, indexing, and performance tuning"
+    keywords: [postgres, postgresql, database, optimization, performance]
+    rule_references: []
+
+  python-best-practices:
+    class: BestPracticeSkill
+    description: "Pythonic patterns from PEP 8 and PEP 20"
+    user_invocable: false
+    model_invocable: true
+    summary: "Idiomatic Python patterns and best practices from official Python documentation"
+    keywords: [python, pep8, pep20, zen, idioms]
+    rule_references: []
+
+  qa-lead-routing:
+    class: RoutingSkill
+    description: "Coordinates QA workflow across planning, writing, and execution agents. Use when user requests testing, quality assurance, or test documentation."
+    user_invocable: false
+    model_invocable: true
+    summary: "Coordinates QA team activities by routing tasks to qa-planner, qa-writer, and qa-engineer"
+    keywords: [routing, qa, testing, quality-assurance, coordination]
+    routes_to: [qa-planner, qa-writer, qa-engineer]
+    rule_references: []
+
+  react-best-practices:
+    class: BestPracticeSkill
+    description: "React/Next.js performance optimization with 40+ rules in 8 categories"
+    user_invocable: false
+    model_invocable: true
+    summary: "React/Next.js performance optimization patterns and best practices"
+    keywords: [react, nextjs, performance, optimization, bundle]
+    rule_references: []
+
+  redis-best-practices:
+    class: BestPracticeSkill
+    description: "Redis best practices for caching, data structures, and in-memory data architecture"
+    user_invocable: false
+    model_invocable: true
+    summary: "Redis best practices for caching patterns, data structures, and performance"
+    keywords: [redis, cache, data-structures, in-memory, performance]
+    rule_references: []
+
+  result-aggregation:
+    class: IntentSkill
+    description: "Aggregate parallel agent results into concise output"
+    user_invocable: false
+    model_invocable: true
+    summary: "Aggregate and format results from multiple parallel agent executions"
+    keywords: [aggregation, parallel, batch, results, ecomode]
+    rule_references: [R009, R013]
+
+  rust-best-practices:
+    class: BestPracticeSkill
+    description: "Idiomatic Rust patterns from official guidelines"
+    user_invocable: false
+    model_invocable: true
+    summary: "Idiomatic Rust patterns and best practices from official documentation"
+    keywords: [rust, ownership, borrowing, safety, concurrency]
+    rule_references: []
+
+  skills-sh-search:
+    class: ExternalSkillSourceSkill
+    description: "Search and install skills from skills.sh marketplace when internal skills are insufficient"
+    user_invocable: true
+    model_invocable: true
+    summary: "Search skills.sh marketplace for external skills and install them into the project"
+    keywords: [skills-sh, marketplace, external, install, search, discover, npx]
+    rule_references: [R003, R006]
+
+  sauron-watch:
+    class: VerificationSkill
+    description: "Full R017 verification (5+3 rounds) before commit"
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Execute full R017 verification with 5 rounds of manager verification and 3 rounds of deep review"
+    keywords: [verification, r017, sync, validation, compliance]
+    rule_references: [R017]
+
+  secretary-routing:
+    class: RoutingSkill
+    description: "Routes agent management tasks to the correct manager agent. Use when user requests agent creation, updates, audits, git operations, sync checks, or verification."
+    user_invocable: false
+    model_invocable: true
+    summary: "Routes agent management tasks to appropriate manager agents"
+    keywords: [routing, management, agent-creation, git, memory, verification]
+    routes_to: [mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible, sys-memory-keeper, sys-naggy]
+    rule_references: []
+
+  snowflake-best-practices:
+    class: BestPracticeSkill
+    description: "Snowflake best practices for cloud data warehouse design, query optimization, and cost management"
+    user_invocable: false
+    model_invocable: true
+    summary: "Snowflake best practices for warehouse design, query optimization, and cost management"
+    keywords: [snowflake, warehouse, clustering, optimization, cost]
+    rule_references: []
+
+  spark-best-practices:
+    class: BestPracticeSkill
+    description: "Apache Spark best practices for PySpark and Scala distributed data processing"
+    user_invocable: false
+    model_invocable: true
+    summary: "Apache Spark best practices for performance optimization and resource management"
+    keywords: [spark, pyspark, distributed, performance, optimization]
+    rule_references: []
+
+  springboot-best-practices:
+    class: BestPracticeSkill
+    description: "Spring Boot patterns for enterprise Java applications"
+    user_invocable: false
+    model_invocable: true
+    summary: "Spring Boot patterns for enterprise Java applications with layered architecture"
+    keywords: [springboot, java, enterprise, dependency-injection, rest]
+    rule_references: []
+
+  status:
+    class: SystemSkill
+    description: "Show system status and health checks"
+    user_invocable: true
+    model_invocable: true
+    scope: harness
+    summary: "Show comprehensive system status including agents, skills, guides, and health checks"
+    keywords: [status, health, system, agents, skills]
+    rule_references: []
+
+  supabase-postgres-best-practices:
+    class: BestPracticeSkill
+    description: "PostgreSQL performance optimization guidelines from Supabase. Apply when writing SQL, designing schemas, configuring RLS, or optimizing database performance."
+    user_invocable: false
+    model_invocable: true
+    summary: "Supabase PostgreSQL best practices for query performance, RLS, and schema design"
+    keywords: [supabase, postgres, postgresql, rls, performance, security]
+    rule_references: []
+
+  typescript-best-practices:
+    class: BestPracticeSkill
+    description: "Type-safe TypeScript patterns from industry standards"
+    user_invocable: false
+    model_invocable: true
+    summary: "Type-safe TypeScript patterns and best practices from industry standards"
+    keywords: [typescript, type-safety, strict-mode, interfaces, generics]
+    rule_references: []
+
+  update-docs:
+    class: ManagementSkill
+    description: "Sync documentation with project structure"
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Ensure documentation accurately reflects current project state and agents work together"
+    keywords: [update, documentation, sync, validation, consistency]
+    rule_references: []
+
+  update-external:
+    class: ManagementSkill
+    description: "Update agents from external sources (GitHub, docs, etc.)"
+    user_invocable: true
+    model_invocable: false
+    scope: harness
+    summary: "Update agents, skills, and guides from external sources to latest versions"
+    keywords: [update, external, github, sources, versioning]
+    rule_references: []
+
+  vercel-deploy:
+    class: DeploymentSkill
+    description: "Deploy applications to Vercel with auto-detection and preview URLs"
+    user_invocable: true
+    model_invocable: true
+    summary: "Deploy applications to Vercel with framework auto-detection and preview URLs"
+    keywords: [vercel, deploy, deployment, preview, framework]
+    rule_references: []
+
+  web-design-guidelines:
+    class: WritingSkill
+    description: "UI code review with 100+ rules for accessibility, performance, and UX"
+    user_invocable: false
+    model_invocable: true
+    summary: "UI code review guidelines for accessibility, performance, and UX best practices"
+    keywords: [ui, accessibility, ux, performance, design]
+    rule_references: []
+
+  writing-clearly-and-concisely:
+    class: WritingSkill
+    description: "Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional."
+    user_invocable: true
+    model_invocable: true
+    summary: "Apply Strunk's Elements of Style rules to improve clarity and conciseness in writing"
+    keywords: [writing, clarity, conciseness, elements-of-style, strunk]
+    rule_references: []

package/templates/.claude/rules/MAY-optimization.md

@@ -0,0 +1,42 @@
+# [MAY] Optimization Guide
+
+> **Priority**: MAY | **ID**: R005
+
+## Efficiency
+
+| Strategy | When | Example |
+|----------|------|---------|
+| Parallel | 3+ independent I/O tasks | Read multiple files simultaneously |
+| Caching | Same data accessed repeatedly | Cache file contents, reuse search results |
+| Lazy Loading | Large datasets, partial use | Read only needed files, stream results |
+
+## Token Optimization
+
+- Include only necessary info, remove duplicates, use summaries
+- Concise expressions, minimize code blocks, no unnecessary repetition
+
+## Task Optimization
+
+- **Batch**: Group similar tasks (edit 10 files at once)
+- **Incremental**: Process only changed parts
+
+## When to Optimize
+
+| Do | Don't |
+|----|-------|
+| Repetitive tasks, clear bottleneck, measurable gain | One-time tasks, already fast, complexity > benefit |
+
+Readability > Optimization. No optimization without measurement.
+
+## Context Optimization via HTML Comments (v2.1.72+)
+
+HTML comments in all auto-injected .md files (AGENTS.md and rules/*.md) are hidden from the model during auto-injection but visible via Read tool.
+
+| Use Case | Example |
+|----------|---------|
+| Metadata tags | `<!-- agents: 44, skills: 74 -->` in AGENTS.md |
+| Validation checksums | `<!-- validate-docs: hash=abc123 -->` in AGENTS.md |
+| Conditional context | `<!-- detailed-architecture: see guides/architecture/ -->` in AGENTS.md |
+| Rule detail hiding | `<!-- DETAIL: Self-Check ... -->` in rules/*.md |
+
+**Rule**: Move model-unnecessary metadata into HTML comments to reduce context token usage. Keep actionable instructions as visible text.