oh-my-customcode 0.1.2 → 0.1.3

package/templates/agents/manager/supplier/refs/skills/system/memory-management/SKILL.md

@@ -0,0 +1,194 @@
+# Memory Management Skill
+
+> **Category**: System
+> **Source**: Internal (claude-mem integration)
+
+## Purpose
+
+Provide memory persistence operations using claude-mem for session context survival across compactions.
+
+## Operations
+
+### 1. Save Context
+
+```yaml
+operation: save
+description: Store session context in claude-mem
+steps:
+  1. Collect session data:
+     - Tasks completed
+     - Decisions made
+     - Open items
+     - Key code changes
+  2. Format document:
+     - Add project tag: "baekgom-agents"
+     - Add session ID: {date}-{uuid}
+     - Add relevant tags
+  3. Store in claude-mem:
+     - Use chroma_add_documents
+     - Include metadata
+```
+
+### 2. Recall Context
+
+```yaml
+operation: recall
+description: Search and retrieve relevant memories
+steps:
+  1. Build query:
+     - Always prefix with "baekgom-agents"
+     - Add user-provided search terms
+     - Include date for temporal searches
+  2. Search claude-mem:
+     - Use chroma_query_documents
+     - Request top N results
+  3. Format results:
+     - Sort by relevance
+     - Present summary
+     - Provide access to full content
+```
+
+### 3. Get Specific Memory
+
+```yaml
+operation: get
+description: Retrieve specific memory by ID
+steps:
+  1. Use chroma_get_documents with ID
+  2. Return full document content
+```
+
+## Query Patterns
+
+### Semantic Search (Primary)
+
+```python
+# Always include project name
+chroma_query_documents(["baekgom-agents {search_terms}"])
+
+# Examples:
+chroma_query_documents(["baekgom-agents authentication flow"])
+chroma_query_documents(["baekgom-agents 2025-01-24 memory system"])
+```
+
+### Get by ID
+
+```python
+# When you have a specific document ID
+chroma_get_documents(ids=["document_id"])
+```
+
+## Document Format
+
+### Save Format
+
+```yaml
+content: |
+  ## Session Summary
+  Date: {date}
+  Session: {session_id}
+
+  ### Tasks Completed
+  - Task 1: Description
+  - Task 2: Description
+
+  ### Decisions Made
+  - Decision 1: Rationale
+  - Decision 2: Rationale
+
+  ### Open Items
+  - Item 1: Status
+  - Item 2: Status
+
+  ### Notes
+  Additional context...
+
+metadata:
+  project: baekgom-agents
+  session: {date}-{uuid}
+  tags: [session, task, decision, ...]
+  created_at: {timestamp}
+```
+
+### Recall Response Format
+
+```yaml
+results:
+  - id: doc_1
+    score: 0.95
+    summary: "Authentication flow implementation"
+    date: 2025-01-20
+    tags: [authentication, oauth]
+  - id: doc_2
+    score: 0.87
+    summary: "JWT token decision"
+    date: 2025-01-18
+    tags: [authentication, decision]
+```
+
+## Best Practices
+
+### Query Tips
+
+```yaml
+do:
+  - Always include "baekgom-agents" prefix
+  - Use semantic, intent-based queries
+  - Include dates for temporal searches
+  - Use multiple queries for better coverage
+
+dont:
+  - Use complex where filters ($and, $or)
+  - Omit project name
+  - Use overly generic terms
+  - Expect exact string matching
+```
+
+### Save Tips
+
+```yaml
+do:
+  - Include meaningful tags
+  - Write clear summaries
+  - Capture decisions with rationale
+  - Note open items for future reference
+
+dont:
+  - Save trivial conversations
+  - Include sensitive data (API keys, etc.)
+  - Create duplicate entries
+```
+
+## Integration
+
+### With memory-keeper Agent
+
+```
+memory-keeper agent uses this skill for:
+- memory:save command
+- memory:recall command
+- PreCompact hook
+- SessionStart hook
+```
+
+### With Other Agents
+
+```
+Other agents can trigger memory operations via:
+- Direct memory:save/recall commands
+- Delegating to memory-keeper
+```
+
+## Error Handling
+
+```yaml
+save_errors:
+  - Connection failure: Retry 3 times, then log and continue
+  - Invalid format: Validate before save, report issues
+  - Storage full: Archive old memories, then retry
+
+recall_errors:
+  - No results: Suggest alternative queries
+  - Connection failure: Return empty with warning
+  - Invalid query: Help user reformulate
+```

package/templates/agents/manager/supplier/refs/skills/system/memory-management/index.yaml

@@ -0,0 +1,30 @@
+# Memory Management Skill
+
+metadata:
+  name: memory-management
+  category: system
+  description: Memory persistence operations using claude-mem
+
+source:
+  type: internal
+  reference: claude-mem MCP integration
+
+provides:
+  - Save session context to claude-mem
+  - Recall memories with semantic search
+  - Project-scoped memory isolation
+  - Metadata tagging for memories
+  - Query pattern guidelines
+
+operations:
+  - save: Store session context with metadata
+  - recall: Search and retrieve relevant memories
+  - get: Retrieve specific memory by ID
+
+storage:
+  provider: claude-mem
+  collection: claude_memories
+  project_tag: baekgom-agents
+
+used_by:
+  - memory-keeper

package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/SKILL.md

@@ -0,0 +1,163 @@
+# Result Aggregation Skill
+
+> **Category**: System
+> **Source**: Internal
+
+## Purpose
+
+Aggregate and format results from multiple parallel agent executions into concise, scannable output.
+
+## When to Use
+
+- After parallel agent execution completes
+- When ecomode is active
+- For batch operation summaries
+- When reporting multi-agent task results
+
+## Aggregation Formats
+
+### Standard Batch Format
+
+```
+[Batch Complete] {completed}/{total}
+├── {agent}: {icon} {summary}
+├── {agent}: {icon} {summary}
+└── {agent}: {icon} {summary}
+```
+
+### Detailed Batch Format
+
+```
+[Batch Complete] {completed}/{total}
+
+[1] {agent-name}
+    Status: {success|failed|partial}
+    Target: {file/path}
+    Result: {summary}
+
+[2] {agent-name}
+    Status: {success|failed|partial}
+    Target: {file/path}
+    Result: {summary}
+```
+
+### Error Summary Format
+
+```
+[Batch Complete] {completed}/{total} ({failures} failed)
+
+Failures:
+├── {agent}: {error summary}
+└── {agent}: {error summary}
+
+Successes:
+├── {agent}: ✓ {summary}
+└── {agent}: ✓ {summary}
+```
+
+## Status Icons
+
+| Icon | Status | Use When |
+|------|--------|----------|
+| ✓ | Success | Task completed successfully |
+| ✗ | Failed | Task failed with error |
+| ⚠ | Warning | Completed with warnings |
+| ⏳ | Pending | Still in progress |
+| ⊘ | Skipped | Task was skipped |
+
+## Aggregation Rules
+
+### 1. Ordering
+
+```yaml
+order:
+  - Failed results first (need attention)
+  - Warnings second
+  - Successes last
+  - Within category: alphabetical by agent
+```
+
+### 2. Summary Length
+
+```yaml
+ecomode_on:
+  max_length: 50 characters
+  truncate_with: "..."
+
+ecomode_off:
+  max_length: 200 characters
+  allow_multiline: true
+```
+
+### 3. Grouping
+
+```yaml
+group_by:
+  - status (success/failed/warning)
+  - agent_type (when mixed types)
+  - target_path (when same agent, different targets)
+```
+
+## Integration
+
+### With Secretary
+
+```
+Secretary receives:
+  - List of agent results
+  - Ecomode status
+  - User display preferences
+
+Secretary outputs:
+  - Aggregated summary using this skill
+  - Individual details if requested
+```
+
+### With Ecomode
+
+```
+When ecomode active:
+  - Use compact format
+  - One line per agent
+  - Icons for status
+  - Truncate long summaries
+```
+
+## Examples
+
+### Code Review Batch
+
+```
+[Batch Complete] 4/4
+
+├── golang-expert: ✓ src/main.go - 2 issues (1 naming, 1 error handling)
+├── python-expert: ✓ scripts/*.py - Clean
+├── rust-expert: ⚠ lib/core.rs - 1 unsafe block flagged
+└── typescript-expert: ✓ web/app.tsx - 3 suggestions
+```
+
+### Agent Creation Batch
+
+```
+[Batch Complete] 3/4 (1 failed)
+
+✗ kotlin-expert: Skill not found: kotlin-best-practices
+✓ golang-expert: Agent created at agents/sw-engineer/golang-expert/
+✓ python-expert: Agent created at agents/sw-engineer/python-expert/
+✓ rust-expert: Agent created at agents/sw-engineer/rust-expert/
+```
+
+### Audit Batch
+
+```
+[Batch Complete] 5/5
+
+Agents Audited:
+├── creator: ✓ All refs valid
+├── updater: ✓ All refs valid
+├── supplier: ⚠ 1 deprecated ref
+├── golang-expert: ✓ All refs valid
+└── python-expert: ✓ All refs valid
+
+Summary: 5 agents checked, 1 warning
+```

package/templates/agents/manager/supplier/refs/skills/system/result-aggregation/index.yaml

@@ -0,0 +1,36 @@
+# Result Aggregation Skill
+
+metadata:
+  name: result-aggregation
+  category: system
+  description: Aggregate parallel agent results into concise output
+
+source:
+  type: internal
+
+provides:
+  - Batch result formatting
+  - Status icon mapping
+  - Result ordering by priority
+  - Summary truncation
+  - Error grouping
+
+formats:
+  standard: "[Batch Complete] {n}/{total}"
+  detailed: "Individual result blocks"
+  error_summary: "Failures first, then successes"
+
+status_icons:
+  success: "✓"
+  failed: "✗"
+  warning: "⚠"
+  pending: "⏳"
+  skipped: "⊘"
+
+used_by:
+  - secretary
+  - Any orchestrator
+
+integration:
+  ecomode: true
+  ecomode_format: compact

package/templates/agents/manager/updater/refs/rules/MAY-optimization.md

@@ -0,0 +1,93 @@
+# [MAY] Optimization Guide
+
+> **Priority**: MAY - Optional
+> **Apply when**: Basic functionality is stable
+
+## Efficiency Optimization
+
+### Parallel Processing
+```
+Apply when:
+- 3+ independent tasks
+- Each task is I/O bound
+
+Example:
+- Read multiple files simultaneously
+- Run independent searches in parallel
+```
+
+### Caching
+```
+Apply when:
+- Same data accessed repeatedly
+- Data changes infrequently
+
+Example:
+- Cache file contents
+- Reuse search results
+```
+
+### Lazy Loading
+```
+Apply when:
+- Large datasets
+- Only portion actually used
+
+Example:
+- Read only needed files
+- Stream results
+```
+
+## Token Optimization
+
+### Context Management
+```
+✓ Include only necessary info
+✓ Remove duplicates
+✓ Use summaries
+```
+
+### Response Optimization
+```
+✓ Concise expressions
+✓ Minimize code blocks
+✓ Remove unnecessary repetition
+```
+
+## Task Optimization
+
+### Batch Processing
+```
+Group similar tasks together
+Example: Edit 10 files → Process at once
+```
+
+### Incremental Processing
+```
+Process only changed parts
+Example: Full build → Incremental build
+```
+
+## Apply Criteria
+
+### Do Optimize
+```
+✓ Repetitive tasks
+✓ Clear performance bottleneck
+✓ Measurable improvement
+```
+
+### Don't Optimize
+```
+✗ One-time tasks
+✗ Already fast enough
+✗ Complexity increase outweighs benefit
+```
+
+## Caution
+
+```
+⚠ Premature optimization is root of evil
+⚠ Readability > Optimization
+⚠ No optimization without measurement
+```

package/templates/agents/manager/updater/refs/rules/MUST-agent-design.md

@@ -0,0 +1,107 @@
+# [MUST] Agent Design Rules
+
+> **Priority**: MUST - Never violate
+> **ID**: R006
+
+## Agent Structure
+
+### Required Files
+```
+agents/{type}/{name}/
+├── AGENT.md          # Agent definition (REQUIRED)
+├── index.yaml        # Agent metadata (REQUIRED)
+└── refs/             # Symlinks to guides/skills (OPTIONAL)
+```
+
+### AGENT.md Must NOT Contain
+```
+✗ Detailed skill instructions (use skills/ instead)
+✗ Reference documentation (use guides/ instead)
+✗ Implementation scripts (use skills/scripts/ instead)
+```
+
+### AGENT.md Should Contain
+```
+✓ Agent purpose and role
+✓ Capabilities overview (not details)
+✓ Required skills (by reference)
+✓ Workflow description
+✓ Source info (if external)
+```
+
+## External Agent Requirements
+
+External agents (from GitHub, npm, etc.) MUST include:
+
+### index.yaml Fields
+```yaml
+metadata:
+  name: agent-name
+  type: worker | orchestrator
+  source:
+    type: external
+    origin: github | npm | other
+    url: https://github.com/org/repo
+    version: 1.0.0
+    last_updated: 2025-01-22
+    update_command: "npx add-skill org/repo"
+```
+
+### Update Tracking
+```
+- version: Current version installed
+- last_updated: Date of last sync
+- update_command: Command to update
+- changelog_url: Where to check updates
+```
+
+## Separation of Concerns
+
+### agents/
+```
+Purpose: Define WHAT the agent does
+Content: Role, capabilities, workflow
+NOT: How to do it (that's skills/)
+```
+
+### skills/
+```
+Purpose: Define HOW to do tasks
+Content: Instructions, scripts, rules
+Location: skills/{category}/{name}/
+```
+
+### guides/
+```
+Purpose: Reference documentation
+Content: Best practices, tutorials
+Location: guides/{topic}/
+```
+
+## Linking
+
+### Agent → Skills
+```yaml
+# In AGENT.md or index.yaml
+skills:
+  - category: development
+    name: react-best-practices
+    path: ../../../../skills/development/react-best-practices
+```
+
+### Agent → Guides
+```bash
+# Symlink in refs/
+ln -s ../../../../guides/web-design refs/web-design
+```
+
+## Naming Conventions
+
+| Type | Pattern | Example |
+|------|---------|---------|
+| Agent folder | `kebab-case` | `vercel-agent` |
+| Skill folder | `kebab-case` | `react-best-practices` |
+| Guide folder | `kebab-case` | `web-design` |
+| AGENT.md | UPPERCASE | `AGENT.md` |
+| SKILL.md | UPPERCASE | `SKILL.md` |
+| index.yaml | lowercase | `index.yaml` |