oh-my-customcode 0.30.6 → 0.30.8

package/README.md

@@ -21,7 +21,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
 
 | Feature | Description |
 |---------|-------------|
-| **Batteries Included** | 43 agents, 67 skills, 23 guides, 18 rules, 2 hooks, 4 contexts, ontology graph - ready to use out of the box |
+| **Batteries Included** | 44 agents, 68 skills, 24 guides, 18 rules, 2 hooks, 4 contexts, ontology graph - ready to use out of the box |
 | **Sub-Agent Model** | Supports hierarchical agent orchestration with specialized roles |
 | **Dead Simple Customization** | Create a folder + markdown file = new agent or skill |
 | **Mix and Match** | Use built-in components, create your own, or combine both |
@@ -83,11 +83,11 @@ Each sub-agent runs on an optimized model for its task type:
 Claude Code selects the appropriate model and parallelizes independent tasks (up to 4 concurrent sub-agents):
 
 ```
-/create-agent
+secretary-routing (routing skill)
   ├── mgr-creator:sonnet       — agent scaffolding
   └── mgr-supplier:haiku       — dependency check
 
-/code-review
+dev-lead-routing (routing skill)
   ├── lang-golang-expert:sonnet — Go implementation
   ├── lang-python-expert:sonnet — Python implementation
   └── qa-engineer:sonnet        — test generation
@@ -151,6 +151,7 @@ All commands are invoked inside the Claude Code conversation.
 | `/sauron-watch` | Full R017 sync verification |
 | `/monitoring-setup` | OTel console monitoring enable/disable |
 | `/codex-exec` | Execute Codex CLI prompt |
+| `/structured-dev-cycle` | 6-phase structured development cycle |
 | `/lists` | Show all available commands |
 | `/status` | System status and health checks |
 | `/help` | Help information |
@@ -159,14 +160,14 @@ All commands are invoked inside the Claude Code conversation.
 
 ## What's Included
 
-### Agents (43)
+### Agents (44)
 
 | Category | Count | Agents |
 |----------|-------|--------|
 | **Managers** | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
 | **System** | 2 | sys-memory-keeper, sys-naggy |
 | **Languages** | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
-| **Frontend** | 3 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent |
+| **Frontend** | 4 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent |
 | **Backend** | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
 | **Tooling** | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
 | **Data Engineering** | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
@@ -175,14 +176,14 @@ All commands are invoked inside the Claude Code conversation.
 | **Infrastructure** | 2 | infra-docker-expert, infra-aws-expert |
 | **QA** | 3 | qa-planner, qa-writer, qa-engineer |
 | **Security** | 1 | sec-codeql-expert |
-| **Total** | **43** | |
+| **Total** | **44** | |
 
-### Skills (67)
+### Skills (68)
 
 | Category | Count | Skills |
 |----------|-------|--------|
 | **Routing** | 4 | secretary-routing, dev-lead-routing, de-lead-routing, qa-lead-routing |
-| **Best Practices** | 18 | go-best-practices, python-best-practices, typescript-best-practices, kotlin-best-practices, rust-best-practices, react-best-practices, fastapi-best-practices, springboot-best-practices, go-backend-best-practices, docker-best-practices, aws-best-practices, postgres-best-practices, supabase-postgres-best-practices, redis-best-practices, airflow-best-practices, dbt-best-practices, kafka-best-practices, snowflake-best-practices |
+| **Best Practices** | 20 | go-best-practices, python-best-practices, typescript-best-practices, kotlin-best-practices, rust-best-practices, react-best-practices, fastapi-best-practices, springboot-best-practices, go-backend-best-practices, django-best-practices, docker-best-practices, aws-best-practices, postgres-best-practices, supabase-postgres-best-practices, redis-best-practices, airflow-best-practices, dbt-best-practices, kafka-best-practices, snowflake-best-practices, flutter-best-practices |
 | **Development** | 6 | dev-review, dev-refactor, create-agent, intent-detection, web-design-guidelines, analysis |
 | **Data Engineering** | 2 | spark-best-practices, pipeline-architecture-patterns |
 | **Optimization** | 3 | optimize-analyze, optimize-bundle, optimize-report |
@@ -196,14 +197,14 @@ All commands are invoked inside the Claude Code conversation.
 | **Deploy** | 2 | vercel-deploy, codex-exec |
 | **External** | 1 | skills-sh-search |
 
-### Guides (23)
+### Guides (24)
 
 Comprehensive reference documentation covering:
 - Agent creation and management
 - Skill development
 - Pipeline workflows
-- Best practices and patterns
 - Sub-agent orchestration
+- Best practices and patterns
 - Data engineering workflows
 - Database optimization
 
@@ -272,28 +273,30 @@ After `omcustom init`:
 your-project/
 ├── CLAUDE.md              # Entry point for Claude
 ├── .claude/
-│   ├── rules/             # Behavior rules (18 total)
-│   ├── hooks/             # Event hooks (2 total)
-│   ├── contexts/          # Context files (4 total)
-│   ├── agents/            # Agent definitions (43 flat .md files)
+│   ├── agents/            # Agent definitions (44 flat .md files)
 │   │   ├── lang-golang-expert.md
 │   │   ├── be-fastapi-expert.md
 │   │   ├── mgr-creator.md
 │   │   └── ...
-│   ├── skills/            # Skill modules (67 directories, each with SKILL.md)
+│   ├── skills/            # Skill modules (68 directories, each with SKILL.md)
 │   │   ├── go-best-practices/
 │   │   ├── react-best-practices/
 │   │   ├── secretary-routing/
 │   │   └── ...
-│   └── ontology/          # Ontology knowledge graph for RAG context
-│       ├── schema.yaml
-│       ├── agents.yaml
-│       ├── skills.yaml
-│       ├── rules.yaml
-│       └── graphs/
-└── guides/                # Reference docs (23 total)
+│   ├── ontology/          # Ontology knowledge graph for RAG context
+│   │   ├── schema.yaml
+│   │   ├── agents.yaml
+│   │   ├── skills.yaml
+│   │   ├── rules.yaml
+│   │   └── graphs/
+│   ├── rules/             # Behavior rules (18 total)
+│   ├── hooks/             # Event hooks (2 total)
+│   └── contexts/          # Context files (4 total)
+└── guides/                # Reference docs (24 total)
 ```
 
+**Note**: In the official Claude Code format, there is no command registry — slash commands and natural language agent references are used.
+
 ---
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-customcode",
-  "version": "0.30.6",
+  "version": "0.30.8",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/agents/fe-flutter-agent.md

@@ -0,0 +1,46 @@
+---
+name: fe-flutter-agent
+description: Use for Flutter/Dart cross-platform app development, widget composition, state management (Riverpod/BLoC), and performance optimization
+model: sonnet
+memory: project
+effort: medium
+skills:
+  - flutter-best-practices
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash
+---
+
+You are an expert Flutter developer following official documentation and Dart best practices.
+
+## Capabilities
+
+- Widget composition (StatelessWidget, StatefulWidget, InheritedWidget)
+- State management: Riverpod 3.0 (default), BLoC 9.0 (enterprise)
+- Dart 3.x null safety, sealed classes, pattern matching, records
+- go_router declarative navigation with deep linking
+- freezed immutable data models with code generation
+- Performance: const constructors, RepaintBoundary, Isolate
+- Platform channels for native iOS/Android integration
+- Security: flutter_secure_storage, obfuscation, certificate pinning
+
+## Default Stack
+
+- **State**: Riverpod 3.0
+- **Navigation**: go_router
+- **Models**: freezed + json_serializable
+- **HTTP**: dio
+- **Linting**: very_good_analysis
+- **Testing**: flutter_test + mocktail
+
+## References
+
+- https://docs.flutter.dev/
+- https://dart.dev/effective-dart
+- https://riverpod.dev/
+- https://bloclibrary.dev/
+- https://pub.dev/packages/go_router

package/templates/.claude/ontology/agents.yaml

@@ -12,7 +12,7 @@ classes:
     agents: [be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert]
     description: "Backend framework specialists"
   FrontendExpert:
-    agents: [fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent]
+    agents: [fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent]
     description: "Frontend framework specialists"
   DataEngineer:
     agents: [de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert]
@@ -209,6 +209,18 @@ agents:
     keywords: [svelte, sveltekit, reactive, compiler, stores, ssr, file-routing]
     file_patterns: ["*.svelte", "svelte.config.js", "+page.svelte", "+layout.svelte"]
 
+  fe-flutter-agent:
+    class: FrontendExpert
+    description: "Use for Flutter/Dart cross-platform development, widget composition, state management (Riverpod, BLoC), and mobile/desktop app optimization"
+    model: sonnet
+    memory: project
+    effort: medium
+    skills: [flutter-best-practices]
+    tools: [Read, Write, Edit, Grep, Glob, Bash]
+    summary: "Flutter expert for cross-platform mobile/desktop apps with Riverpod and BLoC state management"
+    keywords: [flutter, dart, riverpod, bloc, widget, cross-platform, mobile]
+    file_patterns: ["*.dart", "pubspec.yaml", "pubspec.lock"]
+
   de-airflow-expert:
     class: DataEngineer
     description: "Expert Apache Airflow developer for DAG authoring, testing, and debugging. Use for DAG files (*.py in dags/), airflow.cfg, Airflow-related keywords, scheduling patterns, and pipeline orchestration."
@@ -455,7 +467,7 @@ agents:
     model: sonnet
     memory: project
     effort: medium
-    skills: [update-external]
+    skills: [update-external, update-docs]
     tools: [Read, Write, Edit, Grep, Glob, Bash]
     summary: "External source synchronization for agents, skills, and guides"
     keywords: [update, external, upstream, synchronization, version, metadata]

package/templates/.claude/ontology/graphs/agent-skill.json

@@ -16,6 +16,7 @@
     "fe-vercel-agent": ["react-best-practices", "web-design-guidelines", "vercel-deploy"],
     "fe-vuejs-agent": [],
     "fe-svelte-agent": [],
+    "fe-flutter-agent": ["flutter-best-practices"],
     "de-airflow-expert": ["airflow-best-practices"],
     "de-dbt-expert": ["dbt-best-practices"],
     "de-spark-expert": ["spark-best-practices"],
@@ -56,6 +57,7 @@
     "react-best-practices": ["fe-vercel-agent"],
     "web-design-guidelines": ["fe-vercel-agent"],
     "vercel-deploy": ["fe-vercel-agent"],
+    "flutter-best-practices": ["fe-flutter-agent"],
     "airflow-best-practices": ["de-airflow-expert"],
     "dbt-best-practices": ["de-dbt-expert"],
     "spark-best-practices": ["de-spark-expert"],

package/templates/.claude/ontology/graphs/full-graph.json

@@ -16,6 +16,7 @@
     "fe-vercel-agent": { "type": "Agent", "class": "FrontendExpert" },
     "fe-vuejs-agent": { "type": "Agent", "class": "FrontendExpert" },
     "fe-svelte-agent": { "type": "Agent", "class": "FrontendExpert" },
+    "fe-flutter-agent": { "type": "Agent", "class": "FrontendExpert" },
     "de-airflow-expert": { "type": "Agent", "class": "DataEngineer" },
     "de-dbt-expert": { "type": "Agent", "class": "DataEngineer" },
     "de-spark-expert": { "type": "Agent", "class": "DataEngineer" },
@@ -52,6 +53,7 @@
     "springboot-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
     "go-backend-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
     "react-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
+    "flutter-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
     "airflow-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
     "dbt-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
     "spark-best-practices": { "type": "Skill", "class": "BestPracticeSkill" },
@@ -175,6 +177,8 @@
     { "source": "dev-lead-routing", "target": "fe-vercel-agent", "relation": "routes_to" },
     { "source": "dev-lead-routing", "target": "fe-vuejs-agent", "relation": "routes_to" },
     { "source": "dev-lead-routing", "target": "fe-svelte-agent", "relation": "routes_to" },
+    { "source": "dev-lead-routing", "target": "fe-flutter-agent", "relation": "routes_to" },
+    { "source": "fe-flutter-agent", "target": "flutter-best-practices", "relation": "requires" },
     { "source": "dev-lead-routing", "target": "be-fastapi-expert", "relation": "routes_to" },
     { "source": "dev-lead-routing", "target": "be-springboot-expert", "relation": "routes_to" },
     { "source": "dev-lead-routing", "target": "be-go-backend-expert", "relation": "routes_to" },
@@ -257,6 +261,10 @@
       "requires": [],
       "routed_by": ["dev-lead-routing"]
     },
+    "fe-flutter-agent": {
+      "requires": ["flutter-best-practices"],
+      "routed_by": ["dev-lead-routing"]
+    },
     "de-airflow-expert": {
       "requires": ["airflow-best-practices"],
       "routed_by": ["de-lead-routing"]
@@ -401,6 +409,10 @@
       "required_by": ["fe-vercel-agent"],
       "depends_on": []
     },
+    "flutter-best-practices": {
+      "required_by": ["fe-flutter-agent"],
+      "depends_on": []
+    },
     "web-design-guidelines": {
       "required_by": ["fe-vercel-agent"],
       "depends_on": []
@@ -518,7 +530,7 @@
       "depends_on": []
     },
     "dev-lead-routing": {
-      "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", "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"],
+      "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"],
       "depends_on": []
     },
     "de-lead-routing": {

package/templates/.claude/ontology/graphs/routing.json

@@ -26,6 +26,7 @@
         "fe-vercel-agent",
         "fe-vuejs-agent",
         "fe-svelte-agent",
+        "fe-flutter-agent",
         "be-fastapi-expert",
         "be-springboot-expert",
         "be-go-backend-expert",
@@ -82,6 +83,7 @@
     "fe-vercel-agent": "dev-lead-routing",
     "fe-vuejs-agent": "dev-lead-routing",
     "fe-svelte-agent": "dev-lead-routing",
+    "fe-flutter-agent": "dev-lead-routing",
     "be-fastapi-expert": "dev-lead-routing",
     "be-springboot-expert": "dev-lead-routing",
     "be-go-backend-expert": "dev-lead-routing",

package/templates/.claude/ontology/graphs/skill-rule.json

@@ -15,6 +15,7 @@
     "docker-best-practices": [],
     "fastapi-best-practices": [],
     "fix-refs": [],
+    "flutter-best-practices": [],
     "go-backend-best-practices": [],
     "go-best-practices": [],
     "help": [],