oh-my-customcode 0.1.3 → 0.2.0

package/templates/{commands/system/status.md → .claude/skills/status/SKILL.md}

@@ -1,14 +1,12 @@
-# Command: status
+---
+name: status
+description: Show system status and health checks
+argument-hint: "[--verbose] [--health]"
+---
 
-> Show system status
+# System Status Skill
 
-## Usage
-
-```
-status
-status --verbose
-status --health
-```
+Show comprehensive system status including agents, skills, guides, and health checks.
 
 ## Options
 
@@ -17,10 +15,9 @@ status --health
 --health, -h     Health checks only
 ```
 
-## Output
+## Output Format
 
 ### Default Status
-
 ```
 Baekgom Agents - Status
 
@@ -29,7 +26,7 @@ System:
 
 Agents:
   Orchestrator:     1 (secretary)
-  Manager:          3 (creator, updater, supplier)
+  Manager:          3 (mgr-creator, mgr-updater, mgr-supplier)
   SW Engineer:      6
   Backend Engineer: 3
   Infra Engineer:   2
@@ -48,7 +45,6 @@ Health: ✓ OK
 ```
 
 ### Verbose Status
-
 ```
 status --verbose
 
@@ -76,26 +72,26 @@ Agents:
     ✓ secretary (internal)
 
   manager/
-    ✓ creator (internal)
-    ✓ updater (internal)
-    ✓ supplier (internal)
+    ✓ mgr-creator (internal)
+    ✓ mgr-updater (internal)
+    ✓ mgr-supplier (internal)
 
   sw-engineer/
-    ✓ golang-expert (internal)
-    ✓ python-expert (internal)
-    ✓ rust-expert (internal)
-    ✓ kotlin-expert (internal)
-    ✓ typescript-expert (internal)
-    ✓ vercel-agent (external v1.0.0)
+    ✓ lang-golang-expert (internal)
+    ✓ lang-python-expert (internal)
+    ✓ lang-rust-expert (internal)
+    ✓ lang-kotlin-expert (internal)
+    ✓ lang-typescript-expert (internal)
+    ✓ fe-vercel-agent (external v1.0.0)
 
   sw-engineer/backend/
-    ✓ fastapi-expert (internal)
-    ✓ springboot-expert (internal)
-    ✓ go-backend-expert (internal)
+    ✓ be-fastapi-expert (internal)
+    ✓ be-springboot-expert (internal)
+    ✓ be-go-backend-expert (internal)
 
   infra-engineer/
-    ✓ docker-expert (internal)
-    ✓ aws-expert (internal)
+    ✓ infra-docker-expert (internal)
+    ✓ infra-aws-expert (internal)
 
 Skills:
   development/
@@ -125,16 +121,13 @@ Guides:
 
 Commands:
   system:    lists, status, help
-  creator:   agent
-  updater:   docs, external
-  supplier:  audit, fix
-  dev:       review, refactor
+  manager:   create-agent, update-docs, update-external, audit-agents, fix-refs
+  dev:       dev-review, dev-refactor
 
 All systems operational.
 ```
 
 ### Health Check
-
 ```
 status --health
 
@@ -142,22 +135,19 @@ Health Checks:
 
 Agents:
   ✓ 15/15 agents valid
-  ✓ All paths exist
-  ✓ All index.yaml valid
+  ✓ All agent files exist in .claude/agents/
 
 Dependencies:
   ✓ All skill references valid
   ✓ All guide references valid
-  ✓ No broken symlinks
 
 External Sources:
-  ✓ vercel-agent (github: reachable)
+  ✓ fe-vercel-agent (github: reachable)
 
 Documentation:
   ✓ CLAUDE.md in sync
-  ✓ agents/index.yaml in sync
-  ✓ skills/index.yaml in sync
-  ✓ guides/index.yaml in sync
+  ✓ All .claude/agents/*.md files valid
+  ✓ All .claude/skills/*/SKILL.md files valid
 
 Result: HEALTHY
 ```

package/templates/.claude/skills/supabase-postgres-best-practices/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: supabase-postgres-best-practices
+description: PostgreSQL performance optimization guidelines from Supabase. Apply when writing SQL, designing schemas, configuring RLS, or optimizing database performance.
+---
+
+## Supabase PostgreSQL Best Practices
+
+> Source: https://github.com/supabase/agent-skills
+
+### Rule Categories (Prioritized by Impact)
+
+| Priority | Category | Impact | Prefix |
+|----------|----------|--------|--------|
+| 1 | Query Performance | CRITICAL | query- |
+| 2 | Connection Management | CRITICAL | conn- |
+| 3 | Security & RLS | CRITICAL | security- |
+| 4 | Schema Design | HIGH | schema- |
+| 5 | Concurrency & Locking | MEDIUM-HIGH | lock- |
+| 6 | Data Access Patterns | MEDIUM | data- |
+| 7 | Monitoring & Diagnostics | LOW-MEDIUM | monitor- |
+| 8 | Advanced Features | LOW | advanced- |
+
+### 1. Query Performance (CRITICAL)
+
+- Always add indexes for columns used in WHERE, JOIN, and ORDER BY clauses
+- Use partial indexes for filtered queries: `CREATE INDEX idx_active ON users(email) WHERE active = true`
+- Prefer `EXISTS` over `IN` for subqueries
+- Avoid `SELECT *` - specify only needed columns
+- Use `EXPLAIN ANALYZE` to verify query plans
+- Add composite indexes for multi-column queries (column order matters)
+- Use covering indexes to avoid heap lookups
+
+### 2. Connection Management (CRITICAL)
+
+- Use Supabase connection pooler (PgBouncer) for serverless/edge functions
+- Use transaction mode for short-lived queries
+- Use session mode only when needed (prepared statements, advisory locks)
+- Set appropriate pool size limits
+- Release connections promptly - avoid holding connections during external calls
+- Use connection timeouts to prevent leaks
+
+### 3. Security & RLS (CRITICAL)
+
+- Enable RLS on ALL tables exposed via Supabase API
+- Write policies using `auth.uid()` and `auth.jwt()`
+- Avoid functions marked `SECURITY DEFINER` unless necessary
+- Use `SECURITY INVOKER` as default for functions
+- Never trust client-side data - validate in policies
+- Test RLS policies with different roles
+- Use `USING` for read policies, `WITH CHECK` for write policies
+
+### 4. Schema Design (HIGH)
+
+- Use appropriate data types (e.g., `uuid` for IDs, `timestamptz` for times)
+- Add `NOT NULL` constraints where applicable
+- Use `CHECK` constraints for data validation
+- Prefer `text` over `varchar(n)` unless length limit is meaningful
+- Use partial indexes instead of filtered queries
+- Design schemas for the access patterns, not just the data model
+
+### 5. Concurrency & Locking (MEDIUM-HIGH)
+
+- Use `SELECT ... FOR UPDATE SKIP LOCKED` for queue patterns
+- Keep transactions short to minimize lock contention
+- Avoid long-running transactions during migrations
+- Use advisory locks for application-level coordination
+- Be aware of lock ordering to prevent deadlocks
+
+### 6. Data Access Patterns (MEDIUM)
+
+- Use Supabase client libraries for standard CRUD
+- Use RPC functions for complex operations
+- Implement pagination with cursor-based approach (not OFFSET)
+- Use realtime subscriptions judiciously
+- Batch operations where possible
+
+### 7. Monitoring & Diagnostics (LOW-MEDIUM)
+
+- Monitor `pg_stat_statements` for slow queries
+- Check `pg_stat_user_indexes` for unused indexes
+- Monitor connection count and pool utilization
+- Set up alerts for long-running queries
+- Review lock waits periodically
+
+### 8. Advanced Features (LOW)
+
+- Use CTEs for readable complex queries (but note CTE materialization)
+- Leverage PostgreSQL extensions (pgvector, pg_trgm, etc.)
+- Use generated columns for computed values
+- Consider table partitioning for very large tables
+- Use LISTEN/NOTIFY for event-driven patterns
+
+### References
+- Supabase Documentation: https://supabase.com/docs
+- PostgreSQL Official Docs: https://www.postgresql.org/docs/
+- Supabase Agent Skills: https://github.com/supabase/agent-skills
+
+For detailed rule files with specific examples, see guides/supabase-postgres/.

package/templates/{skills/development → .claude/skills}/typescript-best-practices/SKILL.md

@@ -1,7 +1,7 @@
-# TypeScript Best Practices Skill
-
-> **Category**: Development
-> **Source**: Internal (based on Google TypeScript Style Guide and TypeScript Handbook)
+---
+name: typescript-best-practices
+description: Type-safe TypeScript patterns from industry standards
+---
 
 ## Purpose
 

package/templates/{commands/updater/docs.md → .claude/skills/update-docs/SKILL.md}

@@ -1,25 +1,14 @@
-# Command: updater:docs
+---
+name: update-docs
+description: Sync documentation with project structure
+argument-hint: "[--check] [--target <path>]"
+disable-model-invocation: true
+---
 
-> Sync documentation with project structure
-
-## Purpose
+# Update Documentation Skill
 
 Ensures all documentation (AGENT.md, SKILL.md, index.yaml, CLAUDE.md) accurately reflects the current project state and that agents work together organically.
 
-## Usage
-
-```
-updater:docs
-updater:docs --check
-updater:docs --target <path>
-```
-
-## Parameters
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| target | string | no | Specific path to update |
-
 ## Options
 
 ```
@@ -32,21 +21,20 @@ updater:docs --target <path>
 
 ```
 1. Scan project structure
-   ├── agents/
-   ├── skills/
+   ├── .claude/agents/
+   ├── .claude/skills/
    ├── guides/
    └── commands/
 
 2. Validate consistency
-   ├── Check agent index.yaml matches folder structure
+   ├── Check agent files exist
    ├── Check skill references exist
    ├── Check guide references exist
    └── Check command definitions match files
 
 3. Update documentation
-   ├── Sync agents/index.yaml
-   ├── Sync skills/index.yaml
-   ├── Sync guides/index.yaml
+   ├── Verify all .claude/agents/*.md files
+   ├── Verify all .claude/skills/*/SKILL.md files
    ├── Update CLAUDE.md summary
    └── Update inter-agent references
 
@@ -57,83 +45,18 @@ updater:docs --target <path>
    └── Check for orphaned resources
 ```
 
-## Output
-
-### Check Mode
-
-```
-[updater:docs --check]
-
-Scanning project structure...
-
-agents/index.yaml:
-  ✓ 15 agents declared
-  ✓ All paths valid
-  ✗ Missing: agents/sw-engineer/java-expert (declared but not found)
-
-skills/index.yaml:
-  ✓ 13 skills declared
-  ✓ All paths valid
-
-guides/index.yaml:
-  ✓ 12 guides declared
-  ✗ Orphan: guides/old-guide/ (exists but not declared)
-
-CLAUDE.md:
-  ✗ Agent count outdated (shows 14, actual 15)
-
-Issues Found: 3
-Run "updater:docs" to fix.
-```
-
-### Update Mode
-
-```
-[updater:docs]
-
-Syncing documentation with project structure...
-
-[1/4] Updating agents/index.yaml
-  - Removed: java-expert (not found)
-  ✓ 15 → 14 agents
-
-[2/4] Updating skills/index.yaml
-  ✓ No changes needed
-
-[3/4] Updating guides/index.yaml
-  - Added: old-guide (found in filesystem)
-  ✓ 12 → 13 guides
-
-[4/4] Updating CLAUDE.md
-  - Updated agent count: 14 → 15
-  - Updated summary table
-  ✓ Synced
-
-Summary:
-  Modified: 3 files
-  Added: 1 entry
-  Removed: 1 entry
-
-All documentation synced successfully.
-```
-
 ## What Gets Updated
 
-### agents/index.yaml
-- Agent list matches actual folders
-- Paths are correct
+### Agent Files
+- All .claude/agents/*.md files exist and are valid
+- No orphaned or missing agents
 - Metadata is consistent
 
-### skills/index.yaml
+### Skill Files
+- All .claude/skills/*/SKILL.md files exist
 - Skill categories reflect actual structure
-- All skills in folders are listed
 - References are valid
 
-### guides/index.yaml
-- All guide folders are listed
-- Sources are documented
-- Cross-references work
-
 ### CLAUDE.md
 - Project structure diagram
 - Agent/skill/guide counts
@@ -141,8 +64,8 @@ All documentation synced successfully.
 - Summary tables
 
 ### Individual Agent/Skill Files
-- Skill references in agent index.yaml
-- Guide references in agent index.yaml
+- Skill references in agent files
+- Guide references in agent files
 - Cross-agent references
 
 ## Organic Integration Checks
@@ -163,3 +86,55 @@ command_agent_mapping:
   - Agent capabilities match commands
   - Workflow is documented
 ```
+
+## Output Format
+
+### Check Mode
+```
+[/update-docs --check]
+
+Scanning project structure...
+
+Agents:
+  ✓ 15 agents found in .claude/agents/
+  ✗ Missing: lang-java21-expert.md (referenced but not found)
+
+Skills:
+  ✓ 13 skills found in .claude/skills/
+  ✓ All SKILL.md files valid
+
+Guides:
+  ✓ 12 guides declared
+  ✗ Orphan: guides/old-guide/ (exists but not referenced)
+
+CLAUDE.md:
+  ✗ Agent count outdated (shows 14, actual 15)
+
+Issues Found: 3
+Run "/update-docs" to fix.
+```
+
+### Update Mode
+```
+[/update-docs]
+
+Syncing documentation with project structure...
+
+[1/3] Verifying agents
+  - Removed reference: lang-java21-expert (not found)
+  ✓ 15 → 14 agents
+
+[2/3] Verifying skills
+  ✓ No changes needed
+
+[3/3] Updating CLAUDE.md
+  - Updated agent count: 14 → 15
+  - Updated summary table
+  ✓ Synced
+
+Summary:
+  Modified: 1 file
+  Removed: 1 reference
+
+All documentation synced successfully.
+```

package/templates/{commands/updater/external.md → .claude/skills/update-external/SKILL.md}

@@ -1,25 +1,14 @@
-# Command: updater:external
+---
+name: update-external
+description: Update agents from external sources (GitHub, docs, etc.)
+argument-hint: "[agent-name] [--check] [--force]"
+disable-model-invocation: true
+---
 
-> Update agents from external sources
-
-## Purpose
+# Update External Sources Skill
 
 Updates agents, skills, and guides that have external sources (GitHub, official docs, etc.) to their latest versions.
 
-## Usage
-
-```
-updater:external
-updater:external --check
-updater:external <agent-name>
-```
-
-## Parameters
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| target | string | no | Specific agent/skill/guide to update |
-
 ## Options
 
 ```
@@ -32,7 +21,7 @@ updater:external <agent-name>
 
 ### Agents
 ```yaml
-vercel-agent:
+fe-vercel-agent:
   source: https://github.com/vercel-labs/agent-skills
   type: github
 ```
@@ -57,8 +46,6 @@ golang:
 python:
   source: https://peps.python.org/pep-0008/
   type: documentation
-
-# ... and others
 ```
 
 ## Workflow
@@ -83,20 +70,37 @@ python:
    ├── Update content files
    ├── Update version in index.yaml
    ├── Update last_updated timestamp
-   └── Run supplier:audit to validate
+   └── Run mgr-supplier:audit to validate
 ```
 
-## Output
+## Version Tracking
 
-### Check Mode
+Updates are tracked in each resource's index.yaml:
+
+```yaml
+source:
+  type: external
+  origin: github
+  url: https://github.com/vercel-labs/agent-skills
+  version: "1.2.0"
+  last_updated: "2026-01-22"
+  update_history:
+    - version: "1.0.0"
+      date: "2026-01-20"
+    - version: "1.2.0"
+      date: "2026-01-22"
+```
+
+## Output Format
 
+### Check Mode
 ```
-[updater:external --check]
+[mgr-updater:external --check]
 
 Checking for external updates...
 
 Agents:
-  vercel-agent
+  fe-vercel-agent
     Current: v1.0.0
     Latest:  v1.2.0
     Status:  UPDATE AVAILABLE
@@ -112,26 +116,20 @@ Guides:
     Last fetched: 2026-01-22
     Status: UP TO DATE
 
-  python
-    Source: peps.python.org/pep-0008
-    Last fetched: 2026-01-22
-    Status: UP TO DATE
-
 Summary:
   Updates available: 1 agent, 1 skill
   Up to date: 11 guides
 
-Run "updater:external" to apply updates.
+Run "mgr-updater:external" to apply updates.
 ```
 
 ### Update Mode
-
 ```
-[updater:external]
+[mgr-updater:external]
 
 Updating external resources...
 
-[1/2] Updating vercel-agent
+[1/2] Updating fe-vercel-agent
   Fetching from github.com/vercel-labs/agent-skills...
   ✓ Downloaded v1.2.0
   ✓ Updated AGENT.md
@@ -139,7 +137,7 @@ Updating external resources...
   ✓ Updated related skills
 
 [2/2] Validating updates
-  Running supplier:audit...
+  Running mgr-supplier:audit...
   ✓ All dependencies valid
 
 Summary:
@@ -149,66 +147,3 @@ Summary:
 
 All external resources updated successfully.
 ```
-
-### Single Target Update
-
-```
-[updater:external vercel-agent]
-
-Updating vercel-agent...
-
-Source: https://github.com/vercel-labs/agent-skills
-Current version: v1.0.0
-
-Fetching latest...
-  ✓ Found v1.2.0
-
-Changes:
-  - New skill: nextjs-optimization
-  - Updated: react-best-practices (40 → 45 rules)
-  - Updated: web-design-guidelines (100 → 110 rules)
-
-Apply update? [y/n]: y
-
-Applying...
-  ✓ Updated AGENT.md
-  ✓ Updated skills (3 files)
-  ✓ Updated index.yaml
-  ✓ Version: v1.0.0 → v1.2.0
-
-Update complete.
-```
-
-## Version Tracking
-
-Updates are tracked in each resource's index.yaml:
-
-```yaml
-source:
-  type: external
-  origin: github
-  url: https://github.com/vercel-labs/agent-skills
-  version: "1.2.0"
-  last_updated: "2026-01-22"
-  update_history:
-    - version: "1.0.0"
-      date: "2026-01-20"
-    - version: "1.2.0"
-      date: "2026-01-22"
-```
-
-## Error Handling
-
-```yaml
-network_error:
-  action: Retry with backoff
-  fallback: Skip with warning
-
-parse_error:
-  action: Log and skip
-  fallback: Keep current version
-
-validation_error:
-  action: Rollback changes
-  fallback: Alert user
-```

package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/vercel-deploy/SKILL.md

@@ -1,7 +1,7 @@
-# Vercel Deploy
-
-> **Source**: vercel-labs/agent-skills
-> **Capability**: Instant deployment to Vercel
+---
+name: vercel-deploy
+description: Deploy applications to Vercel with auto-detection and preview URLs
+---
 
 ## When to Use
 

package/templates/{agents/manager/supplier/refs/skills/development → .claude/skills}/web-design-guidelines/SKILL.md

@@ -1,7 +1,7 @@
-# Web Design Guidelines
-
-> **Source**: vercel-labs/agent-skills
-> **Rules**: 100+ rules across 11 categories
+---
+name: web-design-guidelines
+description: UI code review with 100+ rules for accessibility, performance, and UX
+---
 
 ## When to Use