oh-my-customcode 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (237) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +287 -0
  3. package/dist/cli/index.js +13299 -0
  4. package/dist/index.js +927 -0
  5. package/package.json +74 -0
  6. package/templates/.claude/contexts/dev.md +20 -0
  7. package/templates/.claude/contexts/ecomode.md +63 -0
  8. package/templates/.claude/contexts/index.yaml +41 -0
  9. package/templates/.claude/contexts/research.md +28 -0
  10. package/templates/.claude/contexts/review.md +23 -0
  11. package/templates/.claude/hooks/hooks.json +185 -0
  12. package/templates/.claude/hooks/hud/index.yaml +27 -0
  13. package/templates/.claude/hooks/hud/update-status.sh +32 -0
  14. package/templates/.claude/hooks/index.yaml +46 -0
  15. package/templates/.claude/hooks/memory-persistence/pre-compact.sh +37 -0
  16. package/templates/.claude/hooks/memory-persistence/session-end.sh +64 -0
  17. package/templates/.claude/hooks/memory-persistence/session-start.sh +41 -0
  18. package/templates/.claude/hooks/strategic-compact/suggest-compact.sh +50 -0
  19. package/templates/.claude/install-hooks.sh +100 -0
  20. package/templates/.claude/rules/MAY-optimization.md +93 -0
  21. package/templates/.claude/rules/MUST-agent-design.md +107 -0
  22. package/templates/.claude/rules/MUST-agent-identification.md +108 -0
  23. package/templates/.claude/rules/MUST-continuous-improvement.md +132 -0
  24. package/templates/.claude/rules/MUST-intent-transparency.md +199 -0
  25. package/templates/.claude/rules/MUST-language-policy.md +62 -0
  26. package/templates/.claude/rules/MUST-orchestrator-coordination.md +266 -0
  27. package/templates/.claude/rules/MUST-parallel-execution.md +341 -0
  28. package/templates/.claude/rules/MUST-permissions.md +84 -0
  29. package/templates/.claude/rules/MUST-safety.md +69 -0
  30. package/templates/.claude/rules/MUST-sync-verification.md +219 -0
  31. package/templates/.claude/rules/MUST-tool-identification.md +112 -0
  32. package/templates/.claude/rules/SHOULD-ecomode.md +145 -0
  33. package/templates/.claude/rules/SHOULD-error-handling.md +102 -0
  34. package/templates/.claude/rules/SHOULD-hud-statusline.md +89 -0
  35. package/templates/.claude/rules/SHOULD-interaction.md +103 -0
  36. package/templates/.claude/rules/SHOULD-memory-integration.md +114 -0
  37. package/templates/.claude/rules/SHOULD-pipeline-mode.md +165 -0
  38. package/templates/.claude/rules/index.yaml +125 -0
  39. package/templates/.claude/uninstall-hooks.sh +52 -0
  40. package/templates/CLAUDE.md.en +259 -0
  41. package/templates/CLAUDE.md.ko +259 -0
  42. package/templates/agents/index.yaml +237 -0
  43. package/templates/agents/infra-engineer/aws-expert/AGENT.md +47 -0
  44. package/templates/agents/infra-engineer/aws-expert/index.yaml +27 -0
  45. package/templates/agents/infra-engineer/docker-expert/AGENT.md +47 -0
  46. package/templates/agents/infra-engineer/docker-expert/index.yaml +27 -0
  47. package/templates/agents/manager/creator/AGENT.md +274 -0
  48. package/templates/agents/manager/creator/index.yaml +66 -0
  49. package/templates/agents/manager/gitnerd/AGENT.md +91 -0
  50. package/templates/agents/manager/gitnerd/index.yaml +55 -0
  51. package/templates/agents/manager/sauron/AGENT.md +153 -0
  52. package/templates/agents/manager/sauron/index.yaml +52 -0
  53. package/templates/agents/manager/supplier/AGENT.md +142 -0
  54. package/templates/agents/manager/supplier/index.yaml +31 -0
  55. package/templates/agents/manager/sync-checker/AGENT.md +34 -0
  56. package/templates/agents/manager/sync-checker/index.yaml +32 -0
  57. package/templates/agents/manager/updater/AGENT.md +125 -0
  58. package/templates/agents/manager/updater/index.yaml +31 -0
  59. package/templates/agents/orchestrator/dev-lead/AGENT.md +116 -0
  60. package/templates/agents/orchestrator/dev-lead/index.yaml +73 -0
  61. package/templates/agents/orchestrator/planner/AGENT.md +102 -0
  62. package/templates/agents/orchestrator/planner/index.yaml +38 -0
  63. package/templates/agents/orchestrator/qa-lead/AGENT.md +92 -0
  64. package/templates/agents/orchestrator/qa-lead/index.yaml +40 -0
  65. package/templates/agents/orchestrator/secretary/AGENT.md +132 -0
  66. package/templates/agents/orchestrator/secretary/index.yaml +55 -0
  67. package/templates/agents/qa-team/qa-engineer/AGENT.md +98 -0
  68. package/templates/agents/qa-team/qa-engineer/index.yaml +59 -0
  69. package/templates/agents/qa-team/qa-planner/AGENT.md +75 -0
  70. package/templates/agents/qa-team/qa-planner/index.yaml +47 -0
  71. package/templates/agents/qa-team/qa-writer/AGENT.md +98 -0
  72. package/templates/agents/qa-team/qa-writer/index.yaml +44 -0
  73. package/templates/agents/sw-architect/documenter/AGENT.md +120 -0
  74. package/templates/agents/sw-architect/documenter/index.yaml +39 -0
  75. package/templates/agents/sw-architect/speckit-agent/AGENT.md +127 -0
  76. package/templates/agents/sw-architect/speckit-agent/index.yaml +78 -0
  77. package/templates/agents/sw-engineer/backend/express-expert/AGENT.md +132 -0
  78. package/templates/agents/sw-engineer/backend/express-expert/index.yaml +36 -0
  79. package/templates/agents/sw-engineer/backend/fastapi-expert/AGENT.md +47 -0
  80. package/templates/agents/sw-engineer/backend/fastapi-expert/index.yaml +27 -0
  81. package/templates/agents/sw-engineer/backend/go-backend-expert/AGENT.md +47 -0
  82. package/templates/agents/sw-engineer/backend/go-backend-expert/index.yaml +27 -0
  83. package/templates/agents/sw-engineer/backend/nestjs-expert/AGENT.md +107 -0
  84. package/templates/agents/sw-engineer/backend/nestjs-expert/index.yaml +43 -0
  85. package/templates/agents/sw-engineer/backend/springboot-expert/AGENT.md +103 -0
  86. package/templates/agents/sw-engineer/backend/springboot-expert/index.yaml +69 -0
  87. package/templates/agents/sw-engineer/frontend/svelte-agent/AGENT.md +71 -0
  88. package/templates/agents/sw-engineer/frontend/svelte-agent/index.yaml +41 -0
  89. package/templates/agents/sw-engineer/frontend/vercel-agent/AGENT.md +67 -0
  90. package/templates/agents/sw-engineer/frontend/vercel-agent/index.yaml +43 -0
  91. package/templates/agents/sw-engineer/frontend/vuejs-agent/AGENT.md +71 -0
  92. package/templates/agents/sw-engineer/frontend/vuejs-agent/index.yaml +48 -0
  93. package/templates/agents/sw-engineer/language/golang-expert/AGENT.md +47 -0
  94. package/templates/agents/sw-engineer/language/golang-expert/index.yaml +27 -0
  95. package/templates/agents/sw-engineer/language/java21-expert/AGENT.md +122 -0
  96. package/templates/agents/sw-engineer/language/java21-expert/index.yaml +51 -0
  97. package/templates/agents/sw-engineer/language/kotlin-expert/AGENT.md +47 -0
  98. package/templates/agents/sw-engineer/language/kotlin-expert/index.yaml +27 -0
  99. package/templates/agents/sw-engineer/language/python-expert/AGENT.md +47 -0
  100. package/templates/agents/sw-engineer/language/python-expert/index.yaml +27 -0
  101. package/templates/agents/sw-engineer/language/rust-expert/AGENT.md +47 -0
  102. package/templates/agents/sw-engineer/language/rust-expert/index.yaml +27 -0
  103. package/templates/agents/sw-engineer/language/typescript-expert/AGENT.md +47 -0
  104. package/templates/agents/sw-engineer/language/typescript-expert/index.yaml +27 -0
  105. package/templates/agents/sw-engineer/tooling/bun-expert/AGENT.md +73 -0
  106. package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml +46 -0
  107. package/templates/agents/sw-engineer/tooling/npm-expert/AGENT.md +160 -0
  108. package/templates/agents/sw-engineer/tooling/npm-expert/index.yaml +45 -0
  109. package/templates/agents/sw-engineer/tooling/optimizer/AGENT.md +170 -0
  110. package/templates/agents/sw-engineer/tooling/optimizer/index.yaml +45 -0
  111. package/templates/agents/system/memory-keeper/AGENT.md +126 -0
  112. package/templates/agents/system/memory-keeper/index.yaml +45 -0
  113. package/templates/agents/system/naggy/AGENT.md +72 -0
  114. package/templates/agents/system/naggy/index.yaml +35 -0
  115. package/templates/commands/COMMANDS.md +136 -0
  116. package/templates/commands/creator/agent.md +121 -0
  117. package/templates/commands/dev/refactor.md +126 -0
  118. package/templates/commands/dev/review.md +82 -0
  119. package/templates/commands/git/branch.yaml +8 -0
  120. package/templates/commands/git/commit.yaml +4 -0
  121. package/templates/commands/git/pr.yaml +4 -0
  122. package/templates/commands/git/status.yaml +4 -0
  123. package/templates/commands/git/sync.yaml +4 -0
  124. package/templates/commands/index.yaml +225 -0
  125. package/templates/commands/intent/explain.md +144 -0
  126. package/templates/commands/memory/recall.md +164 -0
  127. package/templates/commands/memory/save.md +128 -0
  128. package/templates/commands/naggy/add.yaml +8 -0
  129. package/templates/commands/naggy/done.yaml +8 -0
  130. package/templates/commands/naggy/list.yaml +4 -0
  131. package/templates/commands/naggy/priority.yaml +11 -0
  132. package/templates/commands/naggy/remind.yaml +4 -0
  133. package/templates/commands/npm/audit.yaml +62 -0
  134. package/templates/commands/npm/publish.yaml +52 -0
  135. package/templates/commands/npm/version.yaml +62 -0
  136. package/templates/commands/optimize/analyze.yaml +34 -0
  137. package/templates/commands/optimize/bundle.yaml +50 -0
  138. package/templates/commands/optimize/report.yaml +56 -0
  139. package/templates/commands/pipeline/list.md +81 -0
  140. package/templates/commands/pipeline/run.md +127 -0
  141. package/templates/commands/sauron/quick.yaml +4 -0
  142. package/templates/commands/sauron/report.yaml +4 -0
  143. package/templates/commands/sauron/watch.yaml +4 -0
  144. package/templates/commands/supplier/audit.md +133 -0
  145. package/templates/commands/supplier/fix.md +121 -0
  146. package/templates/commands/sync/agents.yaml +4 -0
  147. package/templates/commands/sync/check.yaml +4 -0
  148. package/templates/commands/sync/commands.yaml +4 -0
  149. package/templates/commands/sync/docs.yaml +4 -0
  150. package/templates/commands/sync/fix.yaml +4 -0
  151. package/templates/commands/system/help.md +137 -0
  152. package/templates/commands/system/lists.md +86 -0
  153. package/templates/commands/system/status.md +163 -0
  154. package/templates/commands/updater/docs.md +165 -0
  155. package/templates/commands/updater/external.md +214 -0
  156. package/templates/guides/aws/common-patterns.md +169 -0
  157. package/templates/guides/aws/index.yaml +26 -0
  158. package/templates/guides/aws/well-architected.md +143 -0
  159. package/templates/guides/claude-code/01-overview.md +42 -0
  160. package/templates/guides/claude-code/03-tools.md +107 -0
  161. package/templates/guides/claude-code/04-agent-skills.md +90 -0
  162. package/templates/guides/claude-code/05-agent-sdk.md +129 -0
  163. package/templates/guides/claude-code/06-mcp.md +165 -0
  164. package/templates/guides/claude-code/07-prompt-engineering.md +100 -0
  165. package/templates/guides/claude-code/08-testing.md +58 -0
  166. package/templates/guides/claude-code/09-guardrails.md +80 -0
  167. package/templates/guides/claude-code/10-monitoring.md +89 -0
  168. package/templates/guides/claude-code/index.yaml +51 -0
  169. package/templates/guides/docker/compose-best-practices.md +284 -0
  170. package/templates/guides/docker/dockerfile-best-practices.md +262 -0
  171. package/templates/guides/docker/index.yaml +26 -0
  172. package/templates/guides/fastapi/best-practices.md +232 -0
  173. package/templates/guides/fastapi/index.yaml +21 -0
  174. package/templates/guides/go-backend/index.yaml +26 -0
  175. package/templates/guides/go-backend/project-layout.md +243 -0
  176. package/templates/guides/go-backend/uber-style.md +212 -0
  177. package/templates/guides/golang/concurrency.md +282 -0
  178. package/templates/guides/golang/effective-go.md +309 -0
  179. package/templates/guides/golang/error-handling.md +250 -0
  180. package/templates/guides/golang/index.yaml +27 -0
  181. package/templates/guides/index.yaml +101 -0
  182. package/templates/guides/kotlin/coding-conventions.md +247 -0
  183. package/templates/guides/kotlin/idioms.md +234 -0
  184. package/templates/guides/kotlin/index.yaml +26 -0
  185. package/templates/guides/python/index.yaml +26 -0
  186. package/templates/guides/python/pep8-style-guide.md +202 -0
  187. package/templates/guides/python/zen-of-python.md +79 -0
  188. package/templates/guides/rust/error-handling.md +262 -0
  189. package/templates/guides/rust/index.yaml +26 -0
  190. package/templates/guides/rust/ownership.md +180 -0
  191. package/templates/guides/springboot/best-practices.md +361 -0
  192. package/templates/guides/springboot/index.yaml +22 -0
  193. package/templates/guides/typescript/advanced-types.md +225 -0
  194. package/templates/guides/typescript/index.yaml +26 -0
  195. package/templates/guides/typescript/type-system.md +219 -0
  196. package/templates/guides/web-design/accessibility.md +66 -0
  197. package/templates/guides/web-design/index.yaml +20 -0
  198. package/templates/guides/web-design/performance.md +102 -0
  199. package/templates/pipelines/examples/code-review.yaml +66 -0
  200. package/templates/pipelines/index.yaml +18 -0
  201. package/templates/pipelines/templates/pipeline-template.yaml +50 -0
  202. package/templates/skills/backend/fastapi-best-practices/SKILL.md +269 -0
  203. package/templates/skills/backend/fastapi-best-practices/index.yaml +25 -0
  204. package/templates/skills/backend/go-backend-best-practices/SKILL.md +337 -0
  205. package/templates/skills/backend/go-backend-best-practices/index.yaml +26 -0
  206. package/templates/skills/backend/springboot-best-practices/SKILL.md +356 -0
  207. package/templates/skills/backend/springboot-best-practices/index.yaml +27 -0
  208. package/templates/skills/development/go-best-practices/SKILL.md +202 -0
  209. package/templates/skills/development/go-best-practices/index.yaml +25 -0
  210. package/templates/skills/development/kotlin-best-practices/SKILL.md +255 -0
  211. package/templates/skills/development/kotlin-best-practices/index.yaml +27 -0
  212. package/templates/skills/development/python-best-practices/SKILL.md +221 -0
  213. package/templates/skills/development/python-best-practices/index.yaml +25 -0
  214. package/templates/skills/development/react-best-practices/SKILL.md +100 -0
  215. package/templates/skills/development/react-best-practices/index.yaml +39 -0
  216. package/templates/skills/development/rust-best-practices/SKILL.md +266 -0
  217. package/templates/skills/development/rust-best-practices/index.yaml +26 -0
  218. package/templates/skills/development/typescript-best-practices/SKILL.md +320 -0
  219. package/templates/skills/development/typescript-best-practices/index.yaml +28 -0
  220. package/templates/skills/development/vercel-deploy/SKILL.md +73 -0
  221. package/templates/skills/development/vercel-deploy/index.yaml +30 -0
  222. package/templates/skills/development/web-design-guidelines/SKILL.md +117 -0
  223. package/templates/skills/development/web-design-guidelines/index.yaml +34 -0
  224. package/templates/skills/index.yaml +129 -0
  225. package/templates/skills/infrastructure/aws-best-practices/SKILL.md +279 -0
  226. package/templates/skills/infrastructure/aws-best-practices/index.yaml +27 -0
  227. package/templates/skills/infrastructure/docker-best-practices/SKILL.md +274 -0
  228. package/templates/skills/infrastructure/docker-best-practices/index.yaml +26 -0
  229. package/templates/skills/orchestration/intent-detection/SKILL.md +214 -0
  230. package/templates/skills/orchestration/intent-detection/index.yaml +30 -0
  231. package/templates/skills/orchestration/intent-detection/patterns/agent-triggers.yaml +333 -0
  232. package/templates/skills/orchestration/pipeline-execution/SKILL.md +188 -0
  233. package/templates/skills/orchestration/pipeline-execution/index.yaml +27 -0
  234. package/templates/skills/system/memory-management/SKILL.md +194 -0
  235. package/templates/skills/system/memory-management/index.yaml +30 -0
  236. package/templates/skills/system/result-aggregation/SKILL.md +163 -0
  237. package/templates/skills/system/result-aggregation/index.yaml +36 -0
@@ -0,0 +1,194 @@
1
+ # Memory Management Skill
2
+
3
+ > **Category**: System
4
+ > **Source**: Internal (claude-mem integration)
5
+
6
+ ## Purpose
7
+
8
+ Provide memory persistence operations using claude-mem for session context survival across compactions.
9
+
10
+ ## Operations
11
+
12
+ ### 1. Save Context
13
+
14
+ ```yaml
15
+ operation: save
16
+ description: Store session context in claude-mem
17
+ steps:
18
+ 1. Collect session data:
19
+ - Tasks completed
20
+ - Decisions made
21
+ - Open items
22
+ - Key code changes
23
+ 2. Format document:
24
+ - Add project tag: "baekgom-agents"
25
+ - Add session ID: {date}-{uuid}
26
+ - Add relevant tags
27
+ 3. Store in claude-mem:
28
+ - Use chroma_add_documents
29
+ - Include metadata
30
+ ```
31
+
32
+ ### 2. Recall Context
33
+
34
+ ```yaml
35
+ operation: recall
36
+ description: Search and retrieve relevant memories
37
+ steps:
38
+ 1. Build query:
39
+ - Always prefix with "baekgom-agents"
40
+ - Add user-provided search terms
41
+ - Include date for temporal searches
42
+ 2. Search claude-mem:
43
+ - Use chroma_query_documents
44
+ - Request top N results
45
+ 3. Format results:
46
+ - Sort by relevance
47
+ - Present summary
48
+ - Provide access to full content
49
+ ```
50
+
51
+ ### 3. Get Specific Memory
52
+
53
+ ```yaml
54
+ operation: get
55
+ description: Retrieve specific memory by ID
56
+ steps:
57
+ 1. Use chroma_get_documents with ID
58
+ 2. Return full document content
59
+ ```
60
+
61
+ ## Query Patterns
62
+
63
+ ### Semantic Search (Primary)
64
+
65
+ ```python
66
+ # Always include project name
67
+ chroma_query_documents(["baekgom-agents {search_terms}"])
68
+
69
+ # Examples:
70
+ chroma_query_documents(["baekgom-agents authentication flow"])
71
+ chroma_query_documents(["baekgom-agents 2025-01-24 memory system"])
72
+ ```
73
+
74
+ ### Get by ID
75
+
76
+ ```python
77
+ # When you have a specific document ID
78
+ chroma_get_documents(ids=["document_id"])
79
+ ```
80
+
81
+ ## Document Format
82
+
83
+ ### Save Format
84
+
85
+ ```yaml
86
+ content: |
87
+ ## Session Summary
88
+ Date: {date}
89
+ Session: {session_id}
90
+
91
+ ### Tasks Completed
92
+ - Task 1: Description
93
+ - Task 2: Description
94
+
95
+ ### Decisions Made
96
+ - Decision 1: Rationale
97
+ - Decision 2: Rationale
98
+
99
+ ### Open Items
100
+ - Item 1: Status
101
+ - Item 2: Status
102
+
103
+ ### Notes
104
+ Additional context...
105
+
106
+ metadata:
107
+ project: baekgom-agents
108
+ session: {date}-{uuid}
109
+ tags: [session, task, decision, ...]
110
+ created_at: {timestamp}
111
+ ```
112
+
113
+ ### Recall Response Format
114
+
115
+ ```yaml
116
+ results:
117
+ - id: doc_1
118
+ score: 0.95
119
+ summary: "Authentication flow implementation"
120
+ date: 2025-01-20
121
+ tags: [authentication, oauth]
122
+ - id: doc_2
123
+ score: 0.87
124
+ summary: "JWT token decision"
125
+ date: 2025-01-18
126
+ tags: [authentication, decision]
127
+ ```
128
+
129
+ ## Best Practices
130
+
131
+ ### Query Tips
132
+
133
+ ```yaml
134
+ do:
135
+ - Always include "baekgom-agents" prefix
136
+ - Use semantic, intent-based queries
137
+ - Include dates for temporal searches
138
+ - Use multiple queries for better coverage
139
+
140
+ dont:
141
+ - Use complex where filters ($and, $or)
142
+ - Omit project name
143
+ - Use overly generic terms
144
+ - Expect exact string matching
145
+ ```
146
+
147
+ ### Save Tips
148
+
149
+ ```yaml
150
+ do:
151
+ - Include meaningful tags
152
+ - Write clear summaries
153
+ - Capture decisions with rationale
154
+ - Note open items for future reference
155
+
156
+ dont:
157
+ - Save trivial conversations
158
+ - Include sensitive data (API keys, etc.)
159
+ - Create duplicate entries
160
+ ```
161
+
162
+ ## Integration
163
+
164
+ ### With memory-keeper Agent
165
+
166
+ ```
167
+ memory-keeper agent uses this skill for:
168
+ - memory:save command
169
+ - memory:recall command
170
+ - PreCompact hook
171
+ - SessionStart hook
172
+ ```
173
+
174
+ ### With Other Agents
175
+
176
+ ```
177
+ Other agents can trigger memory operations via:
178
+ - Direct memory:save/recall commands
179
+ - Delegating to memory-keeper
180
+ ```
181
+
182
+ ## Error Handling
183
+
184
+ ```yaml
185
+ save_errors:
186
+ - Connection failure: Retry 3 times, then log and continue
187
+ - Invalid format: Validate before save, report issues
188
+ - Storage full: Archive old memories, then retry
189
+
190
+ recall_errors:
191
+ - No results: Suggest alternative queries
192
+ - Connection failure: Return empty with warning
193
+ - Invalid query: Help user reformulate
194
+ ```
@@ -0,0 +1,30 @@
1
+ # Memory Management Skill
2
+
3
+ metadata:
4
+ name: memory-management
5
+ category: system
6
+ description: Memory persistence operations using claude-mem
7
+
8
+ source:
9
+ type: internal
10
+ reference: claude-mem MCP integration
11
+
12
+ provides:
13
+ - Save session context to claude-mem
14
+ - Recall memories with semantic search
15
+ - Project-scoped memory isolation
16
+ - Metadata tagging for memories
17
+ - Query pattern guidelines
18
+
19
+ operations:
20
+ - save: Store session context with metadata
21
+ - recall: Search and retrieve relevant memories
22
+ - get: Retrieve specific memory by ID
23
+
24
+ storage:
25
+ provider: claude-mem
26
+ collection: claude_memories
27
+ project_tag: baekgom-agents
28
+
29
+ used_by:
30
+ - memory-keeper
@@ -0,0 +1,163 @@
1
+ # Result Aggregation Skill
2
+
3
+ > **Category**: System
4
+ > **Source**: Internal
5
+
6
+ ## Purpose
7
+
8
+ Aggregate and format results from multiple parallel agent executions into concise, scannable output.
9
+
10
+ ## When to Use
11
+
12
+ - After parallel agent execution completes
13
+ - When ecomode is active
14
+ - For batch operation summaries
15
+ - When reporting multi-agent task results
16
+
17
+ ## Aggregation Formats
18
+
19
+ ### Standard Batch Format
20
+
21
+ ```
22
+ [Batch Complete] {completed}/{total}
23
+ ├── {agent}: {icon} {summary}
24
+ ├── {agent}: {icon} {summary}
25
+ └── {agent}: {icon} {summary}
26
+ ```
27
+
28
+ ### Detailed Batch Format
29
+
30
+ ```
31
+ [Batch Complete] {completed}/{total}
32
+
33
+ [1] {agent-name}
34
+ Status: {success|failed|partial}
35
+ Target: {file/path}
36
+ Result: {summary}
37
+
38
+ [2] {agent-name}
39
+ Status: {success|failed|partial}
40
+ Target: {file/path}
41
+ Result: {summary}
42
+ ```
43
+
44
+ ### Error Summary Format
45
+
46
+ ```
47
+ [Batch Complete] {completed}/{total} ({failures} failed)
48
+
49
+ Failures:
50
+ ├── {agent}: {error summary}
51
+ └── {agent}: {error summary}
52
+
53
+ Successes:
54
+ ├── {agent}: ✓ {summary}
55
+ └── {agent}: ✓ {summary}
56
+ ```
57
+
58
+ ## Status Icons
59
+
60
+ | Icon | Status | Use When |
61
+ |------|--------|----------|
62
+ | ✓ | Success | Task completed successfully |
63
+ | ✗ | Failed | Task failed with error |
64
+ | ⚠ | Warning | Completed with warnings |
65
+ | ⏳ | Pending | Still in progress |
66
+ | ⊘ | Skipped | Task was skipped |
67
+
68
+ ## Aggregation Rules
69
+
70
+ ### 1. Ordering
71
+
72
+ ```yaml
73
+ order:
74
+ - Failed results first (need attention)
75
+ - Warnings second
76
+ - Successes last
77
+ - Within category: alphabetical by agent
78
+ ```
79
+
80
+ ### 2. Summary Length
81
+
82
+ ```yaml
83
+ ecomode_on:
84
+ max_length: 50 characters
85
+ truncate_with: "..."
86
+
87
+ ecomode_off:
88
+ max_length: 200 characters
89
+ allow_multiline: true
90
+ ```
91
+
92
+ ### 3. Grouping
93
+
94
+ ```yaml
95
+ group_by:
96
+ - status (success/failed/warning)
97
+ - agent_type (when mixed types)
98
+ - target_path (when same agent, different targets)
99
+ ```
100
+
101
+ ## Integration
102
+
103
+ ### With Secretary
104
+
105
+ ```
106
+ Secretary receives:
107
+ - List of agent results
108
+ - Ecomode status
109
+ - User display preferences
110
+
111
+ Secretary outputs:
112
+ - Aggregated summary using this skill
113
+ - Individual details if requested
114
+ ```
115
+
116
+ ### With Ecomode
117
+
118
+ ```
119
+ When ecomode active:
120
+ - Use compact format
121
+ - One line per agent
122
+ - Icons for status
123
+ - Truncate long summaries
124
+ ```
125
+
126
+ ## Examples
127
+
128
+ ### Code Review Batch
129
+
130
+ ```
131
+ [Batch Complete] 4/4
132
+
133
+ ├── golang-expert: ✓ src/main.go - 2 issues (1 naming, 1 error handling)
134
+ ├── python-expert: ✓ scripts/*.py - Clean
135
+ ├── rust-expert: ⚠ lib/core.rs - 1 unsafe block flagged
136
+ └── typescript-expert: ✓ web/app.tsx - 3 suggestions
137
+ ```
138
+
139
+ ### Agent Creation Batch
140
+
141
+ ```
142
+ [Batch Complete] 3/4 (1 failed)
143
+
144
+ ✗ kotlin-expert: Skill not found: kotlin-best-practices
145
+ ✓ golang-expert: Agent created at agents/sw-engineer/golang-expert/
146
+ ✓ python-expert: Agent created at agents/sw-engineer/python-expert/
147
+ ✓ rust-expert: Agent created at agents/sw-engineer/rust-expert/
148
+ ```
149
+
150
+ ### Audit Batch
151
+
152
+ ```
153
+ [Batch Complete] 5/5
154
+
155
+ Agents Audited:
156
+ ├── creator: ✓ All refs valid
157
+ ├── updater: ✓ All refs valid
158
+ ├── supplier: ⚠ 1 deprecated ref
159
+ ├── golang-expert: ✓ All refs valid
160
+ └── python-expert: ✓ All refs valid
161
+
162
+ Summary: 5 agents checked, 1 warning
163
+ ```
@@ -0,0 +1,36 @@
1
+ # Result Aggregation Skill
2
+
3
+ metadata:
4
+ name: result-aggregation
5
+ category: system
6
+ description: Aggregate parallel agent results into concise output
7
+
8
+ source:
9
+ type: internal
10
+
11
+ provides:
12
+ - Batch result formatting
13
+ - Status icon mapping
14
+ - Result ordering by priority
15
+ - Summary truncation
16
+ - Error grouping
17
+
18
+ formats:
19
+ standard: "[Batch Complete] {n}/{total}"
20
+ detailed: "Individual result blocks"
21
+ error_summary: "Failures first, then successes"
22
+
23
+ status_icons:
24
+ success: "✓"
25
+ failed: "✗"
26
+ warning: "⚠"
27
+ pending: "⏳"
28
+ skipped: "⊘"
29
+
30
+ used_by:
31
+ - secretary
32
+ - Any orchestrator
33
+
34
+ integration:
35
+ ecomode: true
36
+ ecomode_format: compact