oh-my-customcode 0.1.3 → 0.2.0

package/README.md

@@ -14,7 +14,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
 
 | Feature | Description |
 |---------|-------------|
-| **Batteries Included** | 37 agents, 17 skills, 12 guides - synced with baekgom-agents templates |
+| **Batteries Included** | 34 agents, 42 skills, 13 guides - synced with baekgom-agents templates |
 | **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 |
@@ -39,146 +39,86 @@ That's it. You now have a fully configured Claude Code environment.
 
 This is what oh-my-customcode is all about. **Making Claude Code yours.**
 
-### Create a Custom Agent (2 files)
+### Just Tell Claude What You Need
 
-Want an agent that reviews database migrations? Just create:
+No manual file editing. Describe what you want in natural language, and the orchestrator delegates to the right agent:
 
 ```
-agents/sw-engineer/migration-expert/
-├── AGENT.md       # What the agent does
-└── index.yaml     # Metadata
+"Create a migration review expert agent"
+"Add a SQL optimization skill"
+"Make code reviews stricter"
+"Set up a deploy review pipeline"
 ```
 
-**AGENT.md:**
-```markdown
-# Migration Expert Agent
+**How it works:**
 
-> **Type**: Worker
-
-## Purpose
-
-Expert in database migrations, schema design, and data integrity.
-
-## Capabilities
-
-1. Review migration files for safety issues
-2. Suggest rollback strategies
-3. Check for data loss risks
-4. Optimize migration performance
-
-## When to Use
-
-- Before running migrations in production
-- Designing new database schemas
-- Reviewing team members' migrations
 ```
-
-**index.yaml:**
-```yaml
-metadata:
-  name: migration-expert
-  type: worker
-  category: sw-engineer
-  description: Database migration specialist
+User (natural language)
+  → /create-agent (routing skill)
+    → mgr-creator:sonnet       — scaffolds agent, registers, verifies
+    → mgr-updater:sonnet       — syncs documentation
+    → mgr-supplier:haiku       — checks dependencies
 ```
 
-Done. Your custom agent is ready to use.
-
-### Add a Custom Skill
-
-Skills define **how** agents do things. Create specialized knowledge:
+Claude Code's routing system analyzes your request, routes it to the appropriate skill and agent, and the sub-agent handles everything automatically.
 
-```
-skills/development/sql-optimization/
-├── SKILL.md       # The skill instructions
-└── index.yaml     # Metadata
-```
+### Sub-Agent Model
 
-**SKILL.md:**
-```markdown
-# SQL Optimization Skill
+Each sub-agent runs on an optimized model for its task type:
 
-## Rules
+| Model | Usage | Examples |
+|-------|-------|---------|
+| `opus` | Complex reasoning, architecture | Code review, design analysis |
+| `sonnet` | General tasks (default) | Agent creation, code generation |
+| `haiku` | Fast, simple operations | File search, validation |
 
-### Query Optimization
-- Always use EXPLAIN ANALYZE before suggesting changes
-- Prefer indexes over full table scans
-- Avoid SELECT * in production code
-- Use CTEs for complex queries
+Claude Code selects the appropriate model and parallelizes independent tasks (up to 4 concurrent sub-agents):
 
-### Migration Safety
-- Always include rollback scripts
-- Test migrations on production-like data
-- Never delete columns without deprecation period
 ```
+/create-agent
+  ├── mgr-creator:sonnet       — agent scaffolding
+  ├── mgr-supplier:haiku       — dependency check
+  └── mgr-sync-checker:haiku   — registry verification
 
-### Modify Rules
-
-Rules control behavior. Edit them in `.claude/rules/`:
-
-```
-.claude/rules/
-├── MUST-*.md      # Required (safety, permissions)
-├── SHOULD-*.md    # Recommended (interactions, error handling)
-└── MAY-*.md       # Optional (optimizations)
+/code-review
+  ├── lang-golang-expert:sonnet — Go implementation
+  ├── lang-python-expert:sonnet — Python implementation
+  └── qa-engineer:sonnet        — test generation
 ```
 
-Want stricter code review? Edit `SHOULD-interaction.md`:
-
-```markdown
-## Code Review Standards
+### Built-in Commands
 
-### Before Approving Any Code
-- [ ] All tests pass
-- [ ] No security vulnerabilities
-- [ ] Performance impact assessed
-- [ ] Documentation updated
-```
+| Command | Agent | Description |
+|---------|-------|-------------|
+| `/create-agent <name>` | mgr-creator | Create a new agent |
+| `/update-docs` | mgr-updater | Sync docs with project structure |
+| `/audit-dependencies` | mgr-supplier | Verify agent dependencies |
+| `/code-review` | lang-* experts | Review code with expert agents |
+| `/run-pipeline <name>` | pipeline skill | Execute a workflow pipeline |
+| `/sync-check` | mgr-sync-checker | Full synchronization check |
 
-### Create Custom Pipelines
+### Custom Pipelines
 
-Define repeatable workflows in `pipelines/`:
+Define repeatable multi-agent workflows:
 
 ```yaml
-# pipelines/deploy-review.yaml
+# .claude/skills/pipelines/deploy-review.yaml
 name: deploy-review
-description: Pre-deployment review workflow
-
 steps:
   - id: security_scan
-    agent: qa-lead
+    agent: qa-planner
     action: security_review
 
   - id: performance_check
-    agent: optimizer
+    agent: tool-optimizer
     action: analyze_performance
 
   - id: migration_review
-    agent: migration-expert  # Your custom agent!
+    agent: db-migration-expert
     action: review_migrations
 ```
 
-Run it: `pipeline:run deploy-review`
-
-### Mix Built-in + Custom
-
-The real power is combining everything:
-
-```
-your-project/
-├── agents/
-│   ├── orchestrator/          # Built-in: planner, secretary
-│   ├── sw-engineer/
-│   │   ├── language/          # Built-in: golang, python, rust...
-│   │   └── migration-expert/  # YOUR custom agent
-│   └── your-team/             # YOUR team-specific agents
-├── skills/
-│   ├── development/           # Built-in: best practices
-│   └── your-company/          # YOUR company standards
-└── .claude/rules/
-    ├── MUST-safety.md         # Built-in
-    └── MUST-your-policy.md    # YOUR company policy
-```
+Run it: `/run-pipeline deploy-review`
 
 ---
 
@@ -186,38 +126,42 @@ your-project/
 
 > **Templates synced from [baekgom-agents](https://github.com/baekenough/baekgom-agents)** - Battle-tested agent system with sub-agent orchestration support.
 
-### Agents (37)
+### Agents (34)
 
 | Category | Count | Agents |
 |----------|-------|--------|
-| **Orchestrators** | 4 | planner, secretary, dev-lead, qa-lead |
-| **Managers** | 6 | creator, updater, supplier, gitnerd, sync-checker, sauron |
-| **System** | 2 | memory-keeper, naggy |
-| **Languages** | 6 | golang, python, rust, kotlin, typescript, java21 |
-| **Frontend** | 3 | vercel-agent, vuejs-agent, svelte-agent |
-| **Backend** | 5 | fastapi, springboot, go-backend, express, nestjs |
-| **Tooling** | 3 | npm-expert, optimizer, bun-expert |
-| **Architecture** | 2 | documenter, speckit-agent |
-| **Infrastructure** | 2 | docker-expert, aws-expert |
+| **Managers** | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sync-checker, mgr-sauron |
+| **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 |
+| **Backend** | 5 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert |
+| **Tooling** | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
+| **Database** | 1 | db-supabase-expert |
+| **Architecture** | 2 | arch-documenter, arch-speckit-agent |
+| **Infrastructure** | 2 | infra-docker-expert, infra-aws-expert |
 | **QA** | 3 | qa-planner, qa-writer, qa-engineer |
-| **Tutor** | 1 | go-tutor |
-| **Total** | **37** | |
+| **Tutor** | 1 | tutor-go |
+| **Total** | **34** | |
+
+### Skills (42)
 
-### Skills (17)
+Includes slash commands and capabilities:
 
 - **Development** (8): Go, Python, TypeScript, Kotlin, Rust, Java, React, Vercel
 - **Backend** (5): FastAPI, Spring Boot, Express, NestJS, Go Backend
 - **Infrastructure** (2): Docker, AWS
 - **System** (2): Memory management, result aggregation
 - **Orchestration** (2): Pipeline execution, intent detection
+- **Slash Commands** (20+): /create-agent, /code-review, /audit-dependencies, /sync-check, /commit, /pr, and more
 
-### Guides (12)
+### Guides (13)
 
 Comprehensive reference documentation covering:
 - Agent creation and management
 - Skill development
 - Pipeline workflows
 - Best practices and patterns
+- Sub-agent orchestration
 
 ### Rules (18)
 
@@ -250,15 +194,22 @@ After `omcustom init`:
 ```
 your-project/
 ├── CLAUDE.md              # Entry point for Claude
-├── .claude/
-│   ├── rules/             # Behavior rules
-│   ├── hooks/             # Event hooks
-│   └── contexts/          # Context files
-├── agents/                # All agents
-├── skills/                # All skills
-├── guides/                # Reference docs
-├── pipelines/             # Workflow definitions
-└── commands/              # Command definitions
+└── .claude/
+    ├── rules/             # Behavior rules (18 total)
+    ├── hooks/             # Event hooks
+    ├── contexts/          # Context files
+    ├── agents/            # All agents (flat structure, 34 total)
+    │   ├── lang-golang-expert/
+    │   ├── be-fastapi-expert/
+    │   ├── mgr-creator/
+    │   └── ...
+    ├── skills/            # All skills (42 total, includes slash commands)
+    │   ├── development/
+    │   ├── backend/
+    │   ├── infrastructure/
+    │   ├── system/
+    │   └── orchestration/
+    └── guides/            # Reference docs (13 total)
 ```
 
 ---

package/dist/cli/index.js

@@ -12095,34 +12095,18 @@ async function countDirectories(dirPath) {
   const entries = await fs.readdir(dirPath, { withFileTypes: true });
   return entries.filter((e) => e.isDirectory()).length;
 }
-async function countAgentsInTypeDir(typePath) {
+async function countAgents(agentsDir) {
   let count = 0;
   try {
-    const entries = await fs.readdir(typePath, { withFileTypes: true });
+    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
     for (const entry of entries) {
-      if (!entry.isDirectory())
-        continue;
-      const agentMdPath = path.join(typePath, entry.name, "AGENT.md");
-      if (await pathExists(agentMdPath)) {
+      if (entry.isFile() && entry.name.endsWith(".md")) {
         count++;
       }
     }
   } catch {}
   return count;
 }
-async function countAgents(agentsDir) {
-  let count = 0;
-  try {
-    const typeEntries = await fs.readdir(agentsDir, { withFileTypes: true });
-    for (const typeEntry of typeEntries) {
-      if (!typeEntry.isDirectory())
-        continue;
-      const typePath = path.join(agentsDir, typeEntry.name);
-      count += await countAgentsInTypeDir(typePath);
-    }
-  } catch {}
-  return count;
-}
 async function checkClaudeMd(targetDir) {
   const claudeMdPath = path.join(targetDir, "CLAUDE.md");
   const exists2 = await pathExists(claudeMdPath);
@@ -12161,7 +12145,7 @@ async function checkRules(targetDir) {
   };
 }
 async function checkAgents(targetDir) {
-  const agentsDir = path.join(targetDir, "agents");
+  const agentsDir = path.join(targetDir, ".claude", "agents");
   const exists2 = await isDirectory(agentsDir);
   if (!exists2) {
     return {
@@ -12188,17 +12172,8 @@ async function checkAgents(targetDir) {
   };
 }
 async function checkSymlinks(targetDir) {
-  const agentsDir = path.join(targetDir, "agents");
-  const skillsDir = path.join(targetDir, "skills");
+  const skillsDir = path.join(targetDir, ".claude", "skills");
   const brokenSymlinks = [];
-  if (await isDirectory(agentsDir)) {
-    const agentSymlinks = await findRefsSymlinks(agentsDir);
-    for (const symlink of agentSymlinks) {
-      if (!await isValidSymlink(symlink)) {
-        brokenSymlinks.push(symlink);
-      }
-    }
-  }
   if (await isDirectory(skillsDir)) {
     const skillSymlinks = await findRefsSymlinks(skillsDir);
     for (const symlink of skillSymlinks) {
@@ -12259,7 +12234,7 @@ async function checkIndexFiles(targetDir) {
   };
 }
 async function checkSkills(targetDir) {
-  const skillsDir = path.join(targetDir, "skills");
+  const skillsDir = path.join(targetDir, ".claude", "skills");
   const exists2 = await isDirectory(skillsDir);
   if (!exists2) {
     return {
@@ -12306,8 +12281,8 @@ async function createMissingDirectory(dirPath) {
 async function fixSingleIssue(check, targetDir) {
   const fixMap = {
     Rules: () => createMissingDirectory(path.join(targetDir, ".claude", "rules")),
-    Agents: () => createMissingDirectory(path.join(targetDir, "agents")),
-    Skills: () => createMissingDirectory(path.join(targetDir, "skills")),
+    Agents: () => createMissingDirectory(path.join(targetDir, ".claude", "agents")),
+    Skills: () => createMissingDirectory(path.join(targetDir, ".claude", "skills")),
     Symlinks: async () => {
       if (!check.details || check.details.length === 0)
         return false;
@@ -12830,37 +12805,20 @@ var DIRECTORY_STRUCTURE = [
   ".claude/rules",
   ".claude/hooks",
   ".claude/contexts",
-  "agents",
-  "agents/master",
-  "agents/orchestrator",
-  "agents/manager",
-  "agents/system",
-  "agents/sw-engineer",
-  "agents/sw-architect",
-  "agents/backend-engineer",
-  "agents/infra-engineer",
-  "agents/qa-engineer",
-  "agents/tutor",
-  "skills",
-  "skills/development",
-  "skills/backend",
-  "skills/infrastructure",
-  "skills/system",
-  "skills/orchestration",
+  ".claude/agents",
+  ".claude/skills",
   "guides",
   "pipelines",
   "pipelines/templates",
-  "pipelines/examples",
-  "commands"
+  "pipelines/examples"
 ];
 var COMPONENT_PATHS = {
   "claude-md": "",
   rules: ".claude/rules",
-  agents: "agents",
-  skills: "skills",
+  agents: ".claude/agents",
+  skills: ".claude/skills",
   guides: "guides",
   pipelines: "pipelines",
-  commands: "commands",
   hooks: ".claude/hooks",
   contexts: ".claude/contexts"
 };
@@ -12973,7 +12931,7 @@ async function createDirectoryStructure(targetDir) {
   }
 }
 function getAllComponents() {
-  return ["rules", "agents", "skills", "guides", "pipelines", "commands", "hooks", "contexts"];
+  return ["rules", "agents", "skills", "guides", "pipelines", "hooks", "contexts"];
 }
 async function installComponent(targetDir, component, options) {
   const templatePath = COMPONENT_PATHS[component];
@@ -13023,15 +12981,7 @@ async function backupExisting(sourcePath, backupDir) {
   return backupPath;
 }
 async function checkExistingPaths(targetDir) {
-  const pathsToCheck = [
-    "CLAUDE.md",
-    ".claude",
-    "agents",
-    "skills",
-    "guides",
-    "pipelines",
-    "commands"
-  ];
+  const pathsToCheck = ["CLAUDE.md", ".claude", "guides", "pipelines"];
   const existingPaths = [];
   for (const relativePath of pathsToCheck) {
     const fullPath = join3(targetDir, relativePath);
@@ -13192,14 +13142,26 @@ function parseYamlMetadata(content) {
   }
   return result;
 }
-function extractAgentTypeFromPath(agentPath, baseDir) {
-  const relativePath = relative(join5(baseDir, "agents"), agentPath);
-  const parts = relativePath.split("/").filter(Boolean);
-  parts.pop();
-  return parts.join("/") || "unknown";
+function extractAgentTypeFromFilename(filename) {
+  const name = basename2(filename, ".md");
+  const prefixMap = {
+    lang: "language",
+    be: "backend",
+    fe: "frontend",
+    tool: "tooling",
+    db: "database",
+    arch: "architect",
+    infra: "infrastructure",
+    qa: "qa",
+    mgr: "manager",
+    sys: "system",
+    tutor: "tutor"
+  };
+  const prefix = name.split("-")[0];
+  return prefixMap[prefix] || "unknown";
 }
 function extractSkillCategoryFromPath(skillPath, baseDir) {
-  const relativePath = relative(join5(baseDir, "skills"), skillPath);
+  const relativePath = relative(join5(baseDir, ".claude", "skills"), skillPath);
   const parts = relativePath.split("/").filter(Boolean);
   return parts[0] || "unknown";
 }
@@ -13213,28 +13175,67 @@ function extractRulePriorityFromFilename(filename) {
   const parts = name.split("-");
   return parts[0] || "unknown";
 }
+function shouldSkipLine(trimmed, inFrontmatter) {
+  if (inFrontmatter)
+    return true;
+  if (trimmed.startsWith("#"))
+    return true;
+  if (trimmed.startsWith("```"))
+    return true;
+  if (trimmed === "---")
+    return true;
+  return false;
+}
+function cleanMarkdownFormatting(text) {
+  return text.replace(/\*\*/g, "").replace(/\*/g, "");
+}
+function truncateText(text, maxLength) {
+  if (!maxLength || text.length <= maxLength)
+    return text;
+  return `${text.substring(0, maxLength)}...`;
+}
+function processDescription(text, options) {
+  const cleaned = options.cleanFormatting ? cleanMarkdownFormatting(text) : text;
+  return truncateText(cleaned, options.maxLength);
+}
+function extractFromBlockquote(trimmed, options) {
+  const text = trimmed.replace(/^>\s*/, "").trim();
+  return processDescription(text, options);
+}
+function* skipFrontmatter(lines) {
+  let inFrontmatter = false;
+  let lineIndex = 0;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (lineIndex === 0 && trimmed === "---") {
+      inFrontmatter = true;
+      lineIndex++;
+      continue;
+    }
+    if (inFrontmatter && trimmed === "---") {
+      inFrontmatter = false;
+      lineIndex++;
+      continue;
+    }
+    if (!inFrontmatter) {
+      yield { trimmed, lineIndex };
+    }
+    lineIndex++;
+  }
+}
 function extractDescriptionFromMarkdown(content, options = {}) {
   const { maxLength, cleanFormatting = false } = options;
   const lines = content.split(`
 `);
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (trimmed.startsWith("#") || trimmed.startsWith("```") || trimmed.startsWith("---")) {
+  for (const { trimmed } of skipFrontmatter(lines)) {
+    if (shouldSkipLine(trimmed, false)) {
       continue;
     }
     if (trimmed.startsWith(">")) {
-      let description = trimmed.replace(/^>\s*/, "").trim();
-      if (cleanFormatting) {
-        description = description.replace(/\*\*/g, "").replace(/\*/g, "");
-      }
-      return description;
+      return extractFromBlockquote(trimmed, { cleanFormatting, maxLength });
     }
     if (trimmed) {
-      let description = trimmed;
-      if (maxLength && description.length > maxLength) {
-        description = `${description.substring(0, maxLength)}...`;
-      }
-      return description;
+      return processDescription(trimmed, { cleanFormatting, maxLength });
     }
   }
   return;
@@ -13259,22 +13260,21 @@ async function tryExtractMarkdownDescription(mdPath, options = {}) {
   }
 }
 async function getAgents(targetDir) {
-  const agentsDir = join5(targetDir, "agents");
+  const agentsDir = join5(targetDir, ".claude", "agents");
   if (!await fileExists(agentsDir))
     return [];
   try {
-    const agentMdFiles = await listFiles(agentsDir, { recursive: true, pattern: "AGENT.md" });
+    const agentMdFiles = await listFiles(agentsDir, { recursive: false, pattern: "*.md" });
     const agents = await Promise.all(agentMdFiles.map(async (agentMdPath) => {
-      const agentDir = dirname2(agentMdPath);
-      const indexYamlPath = join5(agentDir, "index.yaml");
-      const { description: yamlDesc, version } = await tryReadIndexYamlMetadata(indexYamlPath);
-      const description = yamlDesc ?? await tryExtractMarkdownDescription(agentMdPath);
+      const filename = basename2(agentMdPath);
+      const name = basename2(filename, ".md");
+      const description = await tryExtractMarkdownDescription(agentMdPath);
       return {
-        name: basename2(agentDir),
-        type: extractAgentTypeFromPath(agentDir, targetDir),
-        path: relative(targetDir, agentDir),
+        name,
+        type: extractAgentTypeFromFilename(filename),
+        path: relative(targetDir, agentMdPath),
         description,
-        version
+        version: undefined
       };
     }));
     return agents.sort((a, b) => a.name.localeCompare(b.name));
@@ -13283,7 +13283,7 @@ async function getAgents(targetDir) {
   }
 }
 async function getSkills(targetDir) {
-  const skillsDir = join5(targetDir, "skills");
+  const skillsDir = join5(targetDir, ".claude", "skills");
   if (!await fileExists(skillsDir))
     return [];
   try {

package/dist/index.js

@@ -422,37 +422,20 @@ var DIRECTORY_STRUCTURE = [
   ".claude/rules",
   ".claude/hooks",
   ".claude/contexts",
-  "agents",
-  "agents/master",
-  "agents/orchestrator",
-  "agents/manager",
-  "agents/system",
-  "agents/sw-engineer",
-  "agents/sw-architect",
-  "agents/backend-engineer",
-  "agents/infra-engineer",
-  "agents/qa-engineer",
-  "agents/tutor",
-  "skills",
-  "skills/development",
-  "skills/backend",
-  "skills/infrastructure",
-  "skills/system",
-  "skills/orchestration",
+  ".claude/agents",
+  ".claude/skills",
   "guides",
   "pipelines",
   "pipelines/templates",
-  "pipelines/examples",
-  "commands"
+  "pipelines/examples"
 ];
 var COMPONENT_PATHS = {
   "claude-md": "",
   rules: ".claude/rules",
-  agents: "agents",
-  skills: "skills",
+  agents: ".claude/agents",
+  skills: ".claude/skills",
   guides: "guides",
   pipelines: "pipelines",
-  commands: "commands",
   hooks: ".claude/hooks",
   contexts: ".claude/contexts"
 };
@@ -592,7 +575,7 @@ async function getTemplateManifest() {
   };
 }
 function getAllComponents() {
-  return ["rules", "agents", "skills", "guides", "pipelines", "commands", "hooks", "contexts"];
+  return ["rules", "agents", "skills", "guides", "pipelines", "hooks", "contexts"];
 }
 async function installComponent(targetDir, component, options) {
   const templatePath = COMPONENT_PATHS[component];
@@ -642,15 +625,7 @@ async function backupExisting(sourcePath, backupDir) {
   return backupPath;
 }
 async function checkExistingPaths(targetDir) {
-  const pathsToCheck = [
-    "CLAUDE.md",
-    ".claude",
-    "agents",
-    "skills",
-    "guides",
-    "pipelines",
-    "commands"
-  ];
+  const pathsToCheck = ["CLAUDE.md", ".claude", "guides", "pipelines"];
   const existingPaths = [];
   for (const relativePath of pathsToCheck) {
     const fullPath = join3(targetDir, relativePath);

package/package.json

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