oh-my-customcode 0.78.0 → 0.78.2

package/README.md

@@ -13,7 +13,7 @@
 
 **[한국어 문서 (Korean)](./README_ko.md)**
 
-46 agents. 101 skills. 21 rules. One command.
+47 agents. 101 skills. 21 rules. One command.
 
 ```bash
 npm install -g oh-my-customcode && cd your-project && omcustom init
@@ -124,7 +124,7 @@ Agent(arch-documenter):haiku      ┘
 
 ---
 
-### Agents (46)
+### Agents (47)
 
 | Category | Count | Agents |
 |----------|-------|--------|
@@ -133,7 +133,7 @@ Agent(arch-documenter):haiku      ┘
 | Frontend | 5 | fe-vercel, fe-vuejs, fe-svelte, fe-flutter, fe-design |
 | Data Engineering | 6 | de-airflow, de-dbt, de-spark, de-kafka, de-snowflake, de-pipeline |
 | Database | 4 | db-supabase, db-postgres, db-redis, db-alembic |
-| Tooling | 3 | tool-npm, tool-optimizer, tool-bun |
+| Tooling | 4 | tool-npm, tool-optimizer, tool-bun, slack-cli |
 | Architecture | 2 | arch-documenter, arch-speckit |
 | Infrastructure | 2 | infra-docker, infra-aws |
 | QA | 3 | qa-planner, qa-writer, qa-engineer |
@@ -235,7 +235,7 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (31)
+### Guides (33)
 
 Reference documentation covering best practices, architecture decisions, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
 
@@ -284,7 +284,7 @@ omcustom serve-stop            # Stop Web UI
 your-project/
 ├── CLAUDE.md                   # Entry point
 ├── .claude/
-│   ├── agents/                 # 46 agent definitions
+│   ├── agents/                 # 47 agent definitions
 │   ├── skills/                 # 101 skill modules
 │   ├── rules/                  # 21 governance rules (R000-R021)
 │   ├── hooks/                  # 15 lifecycle hook scripts
@@ -292,7 +292,7 @@ your-project/
 │   ├── specs/                  # Extracted canonical specs
 │   ├── contexts/               # 4 shared context files
 │   └── ontology/               # Knowledge graph for RAG
-└── guides/                     # 31 reference documents
+└── guides/                     # 33 reference documents
 ```
 
 ---

package/dist/cli/index.js

@@ -9325,7 +9325,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.78.0",
+    version: "0.78.2",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {

package/dist/index.js

@@ -1820,7 +1820,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.78.0",
+  version: "0.78.2",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.78.0",
+  "version": "0.78.2",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/agents/slack-cli-expert.md

@@ -0,0 +1,98 @@
+---
+name: slack-cli-expert
+description: Expert Slack CLI developer for Slack app management, deployment, triggers, and workspace automation
+model: sonnet
+domain: universal
+effort: medium
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash
+permissionMode: bypassPermissions
+---
+
+You are an expert Slack CLI developer specialized in building, deploying, and managing Slack apps using the official Slack CLI and the Slack Platform (https://docs.slack.dev/tools/slack-cli/).
+
+## Capabilities
+
+1. Create, deploy, run, and delete Slack apps via CLI
+2. Manage authentication and workspace authorization
+3. Create, update, and delete event triggers
+4. Perform CRUD operations on app datastores
+5. Manage app environment variables
+6. Manage app collaborators
+7. Run local development server and validate manifests
+8. Deploy apps to Slack Platform
+
+## Guides
+
+- **slack-cli**: Slack CLI reference documentation
+
+Guides are located at: `guides/slack-cli/`
+
+## Workflow
+
+1. Run `slack doctor` to verify system diagnostics and dependencies
+2. Run `slack auth list` to confirm workspace authorization
+3. Reference `guides/slack-cli/` for command details and options
+4. Run `slack manifest validate` before any deployment
+5. Execute the requested CLI operation with appropriate flags
+6. Verify results and report status to user
+
+## Key Command Patterns
+
+### App Lifecycle
+```bash
+slack create <app-name>          # Scaffold a new Slack app
+slack run                        # Start local development server
+slack deploy                     # Deploy app to Slack Platform
+slack delete                     # Delete a deployed app
+```
+
+### Authentication
+```bash
+slack login                      # Authorize a workspace
+slack logout                     # Remove workspace authorization
+slack auth list                  # List all authorized workspaces
+```
+
+### Triggers
+```bash
+slack trigger create --trigger-def <file>   # Create an event trigger
+slack trigger update --trigger-id <id>      # Update an existing trigger
+slack trigger delete --trigger-id <id>      # Delete a trigger
+slack trigger list                          # List all triggers
+```
+
+### Datastore
+```bash
+slack datastore put    '{"datastore": "<name>", "item": {...}}'
+slack datastore get    '{"datastore": "<name>", "id": "<id>"}'
+slack datastore query  '{"datastore": "<name>"}'
+slack datastore bulk-put    --datastore <name> --data-file <file>
+slack datastore bulk-delete --datastore <name> --data-file <file>
+```
+
+### Environment Variables
+```bash
+slack env add    <key> <value>   # Add or update an env variable
+slack env remove <key>           # Remove an env variable
+slack env list                   # List all env variables
+```
+
+### Collaboration
+```bash
+slack collaborators add    <email>   # Add a collaborator
+slack collaborators remove <email>   # Remove a collaborator
+slack collaborators list             # List collaborators
+```
+
+### Diagnostics
+```bash
+slack doctor                     # System diagnostics and dependency check
+slack manifest validate          # Validate app manifest before deployment
+slack feedback                   # Send feedback to Slack
+```

package/templates/.claude/hooks/hooks.json

@@ -189,7 +189,7 @@
           },
           {
             "type": "command",
-            "command": "count_file=\"/tmp/.claude-loop-count-$PPID\"; if [ -f \"$count_file\" ]; then last_mod=$(stat -c%Y \"$count_file\" 2>/dev/null || stat -f%m \"$count_file\" 2>/dev/null || echo 0); now=$(date +%s); if [ $((now - last_mod)) -gt 60 ]; then echo 0 > \"$count_file\"; fi; fi; count=$(cat \"$count_file\" 2>/dev/null || echo 0); count=$((count + 1)); echo \"$count\" > \"$count_file\"; if [ \"$count\" -ge 4 ]; then echo '[AutoContinue] SAFETY: auto-continue limit (3) reached. Pausing.' >&2; fi; cat"
+            "command": "bash .claude/hooks/scripts/auto-continue-guard.sh"
           },
           {
             "type": "prompt",

package/templates/.claude/hooks/scripts/auto-continue-guard.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+set -euo pipefail
+
+# Auto-Continue Guard
+# Trigger: SubagentStop
+# Purpose: Count consecutive subagent completions and warn when auto-continue limit reached
+# Protocol: stdin JSON -> count check -> stdout pass-through, exit 0 always (R021)
+
+input=$(cat)
+
+count_file="/tmp/.claude-loop-count-${PPID}"
+
+# Reset counter if stale (>60s since last update)
+if [ -f "$count_file" ]; then
+  last_mod=$(stat -c%Y "$count_file" 2>/dev/null || stat -f%m "$count_file" 2>/dev/null || echo 0)
+  now=$(date +%s)
+  if [ $((now - last_mod)) -gt 60 ]; then
+    echo 0 > "$count_file"
+  fi
+fi
+
+# Increment counter
+count=$(cat "$count_file" 2>/dev/null || echo 0)
+count=$((count + 1))
+echo "$count" > "$count_file"
+
+# Warn if limit reached
+if [ "$count" -ge 4 ]; then
+  echo '[AutoContinue] SAFETY: auto-continue limit (3) reached. Pausing.' >&2
+fi
+
+echo "$input"
+exit 0

package/templates/CLAUDE.md

@@ -151,12 +151,12 @@ oh-my-customcode로 구동됩니다.
 project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
-|   +-- agents/                  # 서브에이전트 정의 (46 파일)
-|   +-- skills/                  # 스킬 (100 디렉토리)
+|   +-- agents/                  # 서브에이전트 정의 (47 파일)
+|   +-- skills/                  # 스킬 (101 디렉토리)
 |   +-- rules/                   # 전역 규칙 (R000-R021)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
-+-- guides/                      # 레퍼런스 문서 (31 토픽)
++-- guides/                      # 레퍼런스 문서 (33 토픽)
 ```
 
 ## 오케스트레이션
@@ -202,7 +202,7 @@ oh-my-customcode는 소프트웨어 컴파일과 동일한 구조를 따릅니
 | SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
 | SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
 | SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
-| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-expert |
+| SW Engineer/Tooling | 4 | tool-npm-expert, tool-optimizer, tool-bun-expert, slack-cli-expert |
 | DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
 | SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
 | Security | 1 | sec-codeql-expert |
@@ -211,7 +211,7 @@ oh-my-customcode는 소프트웨어 컴파일과 동일한 구조를 따릅니
 | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
 | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
 | System | 2 | sys-memory-keeper, sys-naggy |
-| **총계** | **46** | |
+| **총계** | **47** | |
 
 ## Agent Teams (MUST when enabled)
 

package/templates/guides/hook-data-flow/README.md

@@ -0,0 +1,135 @@
+# Hook Data Flow: Stall Detection Pipeline
+
+Added in v0.78.0. Documents the three-script pipeline that detects stalled parallel agents and emits R009 Adaptive Parallel Splitting advisories.
+
+Related rule: `.claude/rules/MUST-parallel-execution.md` (R009 Adaptive Parallel Splitting section)
+
+---
+
+## Overview
+
+When multiple agents run in parallel, one agent may take significantly longer than its peers. The stall detection pipeline identifies this condition at the moment any agent completes and advises the orchestrator to spawn independent pending tasks immediately — without cancelling the stalled agent.
+
+The pipeline spans two hook events and three scripts:
+
+| Event | Script | Role |
+|-------|--------|------|
+| SubagentStart | `agent-start-recorder.sh` | Record spawn timestamp |
+| SubagentStop (1st) | `task-outcome-recorder.sh` | Read start time, record outcome with duration |
+| SubagentStop (2nd) | `stall-detection-advisor.sh` | Read start times, compare durations, emit advisory, consume start entry |
+
+---
+
+## Data Flow
+
+```
+SubagentStart event
+  └─ agent-start-recorder.sh
+       reads:  stdin JSON (agent_type, model, description)
+       writes: /tmp/.claude-agent-starts-$PPID  (appends 1 JSON line)
+
+SubagentStop event  [hooks execute in array order — ordering is critical]
+  │
+  ├─ [1] task-outcome-recorder.sh
+  │       reads:  stdin JSON (agent_type, model, outcome)
+  │       reads:  /tmp/.claude-agent-starts-$PPID  (duration calc — entry still present)
+  │       writes: /tmp/.claude-task-outcomes-$PPID  (appends 1 JSON line with duration_seconds)
+  │       writes: stderr  (on failure only)
+  │
+  └─ [2] stall-detection-advisor.sh
+          reads:  stdin JSON (agent_type, model, description)
+          reads:  /tmp/.claude-agent-starts-$PPID  (finds matching start entry for duration)
+          reads:  /tmp/.claude-agent-durations-$PPID  (peer durations for average calculation)
+          writes: /tmp/.claude-agent-durations-$PPID  (appends completed agent's duration)
+          writes: /tmp/.claude-agent-starts-$PPID  (removes consumed start entry)
+          writes: stderr  (advisory block if stall detected — R021 advisory-only)
+```
+
+### Stall Detection Logic
+
+At SubagentStop, after at least one peer has already completed:
+
+1. Calculate `avg_duration` from all entries in `.claude-agent-durations-$PPID`
+2. Set `stall_threshold = avg_duration * 2`
+3. Scan `.claude-agent-starts-$PPID` for agents not yet in the duration file (still running)
+4. For each still-running agent where `elapsed > stall_threshold`, emit advisory to stderr
+
+The current agent's duration is recorded *after* stall detection so it does not inflate the average for its own check.
+
+### Advisory Output Format
+
+```
+─── [Stall Detection Advisory] ───────────────────────────
+  Stalled: {agent_type}:{model} ({elapsed}s elapsed, 2x avg {avg_duration}s)
+  Description: {description}
+  ⚡ Consider spawning independent pending tasks immediately
+  R009 Adaptive Parallel Splitting applies
+──────────────────────────────────────────────────────────
+```
+
+---
+
+## Shared Files
+
+| File | Writer | Readers | Lifecycle |
+|------|--------|---------|-----------|
+| `/tmp/.claude-agent-starts-$PPID` | `agent-start-recorder.sh` (append) | `task-outcome-recorder.sh` (read), `stall-detection-advisor.sh` (read + remove entry) | Session-scoped via PPID; ring buffer 50 entries; entry removed after `stall-detection-advisor` consumes it |
+| `/tmp/.claude-task-outcomes-$PPID` | `task-outcome-recorder.sh` (append) | `feedback-collector.sh`, `eval-core-batch-save.sh` (at Stop) | Session-scoped via PPID; ring buffer 50 entries |
+| `/tmp/.claude-agent-durations-$PPID` | `stall-detection-advisor.sh` (append) | `stall-detection-advisor.sh` (read for average calculation) | Session-scoped via PPID; ring buffer 50 entries |
+
+---
+
+## Execution Order Requirements
+
+The SubagentStop hook array in `hooks.json` defines a strict ordering:
+
+```json
+"SubagentStop": [
+  { "command": "bash .claude/hooks/scripts/task-outcome-recorder.sh" },
+  { "command": "bash .claude/hooks/scripts/stall-detection-advisor.sh" },
+  ...
+]
+```
+
+**task-outcome-recorder MUST run before stall-detection-advisor.**
+
+Reason: `stall-detection-advisor.sh` removes the matching start entry from `.claude-agent-starts-$PPID` after reading it (to prevent re-matching on the next SubagentStop). If the order were reversed, `task-outcome-recorder.sh` would find no start entry for the agent and would always record `duration_seconds=0`.
+
+If the order is swapped:
+- `task-outcome-recorder` records `duration_seconds=0` for all agents
+- Model escalation decisions based on duration become unreliable
+- No other visible error — silent data corruption
+
+---
+
+## Temp File Lifecycle
+
+```
+Session start (PPID assigned)
+  │
+  ├─ First SubagentStart  →  .claude-agent-starts-$PPID  created
+  │
+  ├─ First SubagentStop   →  .claude-task-outcomes-$PPID  created
+  │                          .claude-agent-durations-$PPID  created
+  │
+  ├─ Each SubagentStop    →  start entry consumed (removed by stall-detection-advisor)
+  │                          duration entry appended
+  │                          outcome entry appended
+  │
+  └─ Session end (PPID released)
+       Files remain in /tmp — OS cleans up on reboot
+       Ring buffers cap each file at 50 lines to bound growth
+```
+
+PPID (parent process ID) is used rather than PID (`$$`) to scope files to the Claude Code session rather than to individual script invocations. All three scripts use `${PPID}` consistently.
+
+---
+
+## Design Principles
+
+- **Advisory-only (R021):** All three scripts exit 0 unconditionally. A missing `jq` binary causes silent pass-through, not a blocked hook.
+- **PPID scoping:** Isolates temp files per Claude Code session. Multiple concurrent sessions do not interfere.
+- **Ring buffers:** Each temp file is capped at 50 lines via `tail -50` after each append. Prevents unbounded growth in long sessions with many agents.
+- **grep -F for pattern matching:** Fixed-string matching in `agent-start-recorder` and `task-outcome-recorder` avoids regex injection from agent type names.
+- **Self-exclusion from average:** `stall-detection-advisor` reads the duration file *before* appending its own entry, so the completing agent is never compared against itself.
+- **Sibling preservation:** When removing a start entry, `awk` removes only the first matching line — preserving sibling entries when multiple agents of the same type run in parallel.

package/templates/guides/slack-cli/README.md

@@ -0,0 +1,145 @@
+# Slack CLI Reference Guide
+
+> Source: https://docs.slack.dev/tools/slack-cli/ | Version: v3.15.0
+
+## Overview
+
+Slack CLI allows creating and managing Slack apps from the command line. Works with Deno Slack SDK and Bolt frameworks (JavaScript/Python).
+
+## Installation
+
+```bash
+# macOS/Linux
+curl -fsSL https://downloads.slack-edge.com/slack-cli/install.sh | bash
+
+# Verify
+slack version
+slack doctor
+```
+
+## Quick Start
+
+```bash
+# Login to workspace
+slack login
+
+# Create new app
+slack create my-app
+
+# Run locally (development)
+slack run
+
+# Deploy to production
+slack deploy
+```
+
+## Command Reference
+
+### App Management
+
+| Command | Description |
+|---------|-------------|
+| `slack create` | Create a new Slack project |
+| `slack run` | Start local development server |
+| `slack deploy` | Deploy app to Slack Platform |
+| `slack delete` | Delete an app |
+| `slack app install` | Install app to a workspace |
+| `slack app uninstall` | Uninstall app from a workspace |
+| `slack app list` | List installed apps |
+| `slack doctor` | System diagnostics |
+
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `slack login` / `slack auth login` | Log in to Slack account |
+| `slack logout` / `slack auth logout` | Log out |
+| `slack auth list` | List authorizations |
+| `slack auth token` | Manage access tokens |
+| `slack auth revoke` | Revoke authorization |
+
+### Triggers
+
+| Command | Description |
+|---------|-------------|
+| `slack trigger create` | Create a new trigger |
+| `slack trigger update` | Update a trigger |
+| `slack trigger delete` | Delete a trigger |
+| `slack trigger list` | List all triggers |
+| `slack trigger info` | View trigger details |
+| `slack trigger access` | Manage trigger access |
+
+### Datastore
+
+| Command | Description |
+|---------|-------------|
+| `slack datastore put` | Add an item |
+| `slack datastore get` | Retrieve an item |
+| `slack datastore query` | Query items |
+| `slack datastore update` | Update an item |
+| `slack datastore delete` | Delete an item |
+| `slack datastore count` | Count items |
+| `slack datastore bulk-put` | Bulk add items |
+| `slack datastore bulk-get` | Bulk retrieve items |
+| `slack datastore bulk-delete` | Bulk delete items |
+
+### Environment Variables
+
+| Command | Description |
+|---------|-------------|
+| `slack env add` | Add environment variable |
+| `slack env list` | List environment variables |
+| `slack env remove` | Remove environment variable |
+
+### Collaboration
+
+| Command | Description |
+|---------|-------------|
+| `slack collaborator add` | Add a collaborator |
+| `slack collaborator list` | List collaborators |
+| `slack collaborator remove` | Remove a collaborator |
+
+### Project Management
+
+| Command | Description |
+|---------|-------------|
+| `slack init` | Initialize existing project for Slack CLI |
+| `slack manifest validate` | Validate app manifest |
+| `slack manifest info` | Display manifest information |
+| `slack samples` | List available sample apps |
+| `slack upgrade` | Check for CLI/SDK updates |
+
+## Common Workflows
+
+### Create and Deploy App
+
+```bash
+slack login                    # Authenticate
+slack create my-app            # Create project
+cd my-app
+slack run                      # Test locally
+slack deploy                   # Deploy to production
+slack trigger create           # Set up triggers
+```
+
+### Manage Environment
+
+```bash
+slack env add MY_KEY my_value  # Add env var
+slack env list                 # Verify
+slack env remove MY_KEY        # Remove
+```
+
+### Datastore Operations
+
+```bash
+slack datastore put '{"datastore":"tasks","item":{"id":"1","title":"Test"}}'
+slack datastore query '{"datastore":"tasks","expression":"id = :id","expression_values":{":id":"1"}}'
+```
+
+## Resources
+
+- Documentation: https://docs.slack.dev/tools/slack-cli/
+- Command Reference: https://docs.slack.dev/tools/slack-cli/reference/commands/slack/
+- GitHub: https://github.com/slackapi/slack-cli
+- Changelog: https://docs.slack.dev/changelog/

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.78.0",
+  "version": "0.78.2",
   "lastUpdated": "2026-03-24T00:00:00.000Z",
   "components": [
     {
@@ -12,7 +12,7 @@
       "name": "agents",
       "path": ".claude/agents",
       "description": "AI agent definitions (flat .md files with prefixes)",
-      "files": 46
+      "files": 47
     },
     {
       "name": "skills",
@@ -24,7 +24,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 31
+      "files": 33
     },
     {
       "name": "hooks",