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,214 @@
1
+ # Command: updater:external
2
+
3
+ > Update agents from external sources
4
+
5
+ ## Purpose
6
+
7
+ Updates agents, skills, and guides that have external sources (GitHub, official docs, etc.) to their latest versions.
8
+
9
+ ## Usage
10
+
11
+ ```
12
+ updater:external
13
+ updater:external --check
14
+ updater:external <agent-name>
15
+ ```
16
+
17
+ ## Parameters
18
+
19
+ | Name | Type | Required | Description |
20
+ |------|------|----------|-------------|
21
+ | target | string | no | Specific agent/skill/guide to update |
22
+
23
+ ## Options
24
+
25
+ ```
26
+ --check, -c Check for updates without applying
27
+ --force, -f Force update even if current
28
+ --verbose, -v Show detailed changes
29
+ ```
30
+
31
+ ## External Sources
32
+
33
+ ### Agents
34
+ ```yaml
35
+ vercel-agent:
36
+ source: https://github.com/vercel-labs/agent-skills
37
+ type: github
38
+ ```
39
+
40
+ ### Skills (from external agents)
41
+ ```yaml
42
+ react-best-practices:
43
+ source: https://github.com/vercel-labs/agent-skills
44
+ type: github
45
+
46
+ web-design-guidelines:
47
+ source: https://github.com/vercel-labs/agent-skills
48
+ type: github
49
+ ```
50
+
51
+ ### Guides (reference documentation)
52
+ ```yaml
53
+ golang:
54
+ source: https://go.dev/doc/effective_go
55
+ type: documentation
56
+
57
+ python:
58
+ source: https://peps.python.org/pep-0008/
59
+ type: documentation
60
+
61
+ # ... and others
62
+ ```
63
+
64
+ ## Workflow
65
+
66
+ ```
67
+ 1. Identify external resources
68
+ ├── Scan index.yaml files
69
+ ├── Find source.type = "external"
70
+ └── Collect URLs and versions
71
+
72
+ 2. Check for updates
73
+ ├── GitHub: Check releases/commits
74
+ ├── Documentation: Check last-modified
75
+ └── Compare with current version
76
+
77
+ 3. Fetch updates
78
+ ├── Download new content
79
+ ├── Parse and extract relevant parts
80
+ └── Validate content
81
+
82
+ 4. Apply updates
83
+ ├── Update content files
84
+ ├── Update version in index.yaml
85
+ ├── Update last_updated timestamp
86
+ └── Run supplier:audit to validate
87
+ ```
88
+
89
+ ## Output
90
+
91
+ ### Check Mode
92
+
93
+ ```
94
+ [updater:external --check]
95
+
96
+ Checking for external updates...
97
+
98
+ Agents:
99
+ vercel-agent
100
+ Current: v1.0.0
101
+ Latest: v1.2.0
102
+ Status: UPDATE AVAILABLE
103
+
104
+ Skills:
105
+ react-best-practices
106
+ Source: github.com/vercel-labs/agent-skills
107
+ Status: UPDATE AVAILABLE (linked to agent)
108
+
109
+ Guides:
110
+ golang
111
+ Source: go.dev/doc/effective_go
112
+ Last fetched: 2026-01-22
113
+ Status: UP TO DATE
114
+
115
+ python
116
+ Source: peps.python.org/pep-0008
117
+ Last fetched: 2026-01-22
118
+ Status: UP TO DATE
119
+
120
+ Summary:
121
+ Updates available: 1 agent, 1 skill
122
+ Up to date: 11 guides
123
+
124
+ Run "updater:external" to apply updates.
125
+ ```
126
+
127
+ ### Update Mode
128
+
129
+ ```
130
+ [updater:external]
131
+
132
+ Updating external resources...
133
+
134
+ [1/2] Updating vercel-agent
135
+ Fetching from github.com/vercel-labs/agent-skills...
136
+ ✓ Downloaded v1.2.0
137
+ ✓ Updated AGENT.md
138
+ ✓ Updated index.yaml (version: 1.0.0 → 1.2.0)
139
+ ✓ Updated related skills
140
+
141
+ [2/2] Validating updates
142
+ Running supplier:audit...
143
+ ✓ All dependencies valid
144
+
145
+ Summary:
146
+ Updated: 1 agent
147
+ Synced: 3 skills
148
+ Validated: ✓
149
+
150
+ All external resources updated successfully.
151
+ ```
152
+
153
+ ### Single Target Update
154
+
155
+ ```
156
+ [updater:external vercel-agent]
157
+
158
+ Updating vercel-agent...
159
+
160
+ Source: https://github.com/vercel-labs/agent-skills
161
+ Current version: v1.0.0
162
+
163
+ Fetching latest...
164
+ ✓ Found v1.2.0
165
+
166
+ Changes:
167
+ - New skill: nextjs-optimization
168
+ - Updated: react-best-practices (40 → 45 rules)
169
+ - Updated: web-design-guidelines (100 → 110 rules)
170
+
171
+ Apply update? [y/n]: y
172
+
173
+ Applying...
174
+ ✓ Updated AGENT.md
175
+ ✓ Updated skills (3 files)
176
+ ✓ Updated index.yaml
177
+ ✓ Version: v1.0.0 → v1.2.0
178
+
179
+ Update complete.
180
+ ```
181
+
182
+ ## Version Tracking
183
+
184
+ Updates are tracked in each resource's index.yaml:
185
+
186
+ ```yaml
187
+ source:
188
+ type: external
189
+ origin: github
190
+ url: https://github.com/vercel-labs/agent-skills
191
+ version: "1.2.0"
192
+ last_updated: "2026-01-22"
193
+ update_history:
194
+ - version: "1.0.0"
195
+ date: "2026-01-20"
196
+ - version: "1.2.0"
197
+ date: "2026-01-22"
198
+ ```
199
+
200
+ ## Error Handling
201
+
202
+ ```yaml
203
+ network_error:
204
+ action: Retry with backoff
205
+ fallback: Skip with warning
206
+
207
+ parse_error:
208
+ action: Log and skip
209
+ fallback: Keep current version
210
+
211
+ validation_error:
212
+ action: Rollback changes
213
+ fallback: Alert user
214
+ ```
@@ -0,0 +1,169 @@
1
+ # AWS Common Architecture Patterns
2
+
3
+ > Source: https://aws.amazon.com/architecture/
4
+
5
+ ## Web Application (Three-Tier)
6
+
7
+ ```
8
+ ┌─────────────────────────────────────────────────────────────┐
9
+ │ Internet │
10
+ └────────────────────────────┬────────────────────────────────┘
11
+
12
+ ┌────────────────────────────┴────────────────────────────────┐
13
+ │ CloudFront (CDN) │
14
+ │ + WAF │
15
+ └────────────────────────────┬────────────────────────────────┘
16
+
17
+ ┌────────────────────────────┴────────────────────────────────┐
18
+ │ Application Load Balancer │
19
+ │ (Public Subnets) │
20
+ └────────────────────────────┬────────────────────────────────┘
21
+
22
+ ┌────────────────────────────┴────────────────────────────────┐
23
+ │ ECS Fargate / EC2 Auto Scaling │
24
+ │ (Private Subnets) │
25
+ │ + ElastiCache (Redis) │
26
+ └────────────────────────────┬────────────────────────────────┘
27
+
28
+ ┌────────────────────────────┴────────────────────────────────┐
29
+ │ RDS Aurora (Multi-AZ) │
30
+ │ (Private Subnets) │
31
+ └─────────────────────────────────────────────────────────────┘
32
+ ```
33
+
34
+ ## Serverless API
35
+
36
+ ```
37
+ ┌─────────────────────────────────────────────────────────────┐
38
+ │ Client │
39
+ └────────────────────────────┬────────────────────────────────┘
40
+
41
+ ┌────────────────────────────┴────────────────────────────────┐
42
+ │ API Gateway │
43
+ │ (REST/HTTP API) │
44
+ └────────────────────────────┬────────────────────────────────┘
45
+
46
+ ┌───────────────────┼───────────────────┐
47
+ │ │ │
48
+ ┌────────┴────────┐ ┌───────┴────────┐ ┌───────┴────────┐
49
+ │ Lambda │ │ Lambda │ │ Lambda │
50
+ │ (Get User) │ │ (Create User) │ │ (List Users) │
51
+ └────────┬────────┘ └───────┬────────┘ └───────┬────────┘
52
+ │ │ │
53
+ └───────────────────┼───────────────────┘
54
+
55
+ ┌────────────────────────────┴────────────────────────────────┐
56
+ │ DynamoDB │
57
+ └─────────────────────────────────────────────────────────────┘
58
+ ```
59
+
60
+ ## Event-Driven Architecture
61
+
62
+ ```
63
+ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
64
+ │ Producer │───▶│ EventBridge│───▶│ Consumer │
65
+ │ (Lambda) │ │ (Events) │ │ (Lambda) │
66
+ └──────────────┘ └──────┬───────┘ └──────────────┘
67
+
68
+ ┌─────────────────┼─────────────────┐
69
+ │ │ │
70
+ ▼ ▼ ▼
71
+ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
72
+ │ SQS Queue │ │ SNS Topic │ │ Step Function│
73
+ └──────────────┘ └──────────────┘ └──────────────┘
74
+ ```
75
+
76
+ ## Microservices
77
+
78
+ ```
79
+ ┌─────────────────────────────────────────────────────────────┐
80
+ │ API Gateway / ALB │
81
+ └────────────────────────────┬────────────────────────────────┘
82
+
83
+ ┌────────────────────────┼────────────────────────┐
84
+ │ │ │
85
+ ┌───┴───┐ ┌────┴────┐ ┌────┴────┐
86
+ │Service│ │ Service │ │ Service │
87
+ │ A │ │ B │ │ C │
88
+ │(ECS) │ │ (Lambda)│ │ (EKS) │
89
+ └───┬───┘ └────┬────┘ └────┬────┘
90
+ │ │ │
91
+ └────────────────────────┼────────────────────────┘
92
+
93
+ ┌────────┴────────┐
94
+ │ Service Mesh │
95
+ │ (App Mesh) │
96
+ └─────────────────┘
97
+ ```
98
+
99
+ ## Data Lake
100
+
101
+ ```
102
+ ┌──────────────────────────────────────────────────────────────┐
103
+ │ Data Sources │
104
+ │ (Databases, APIs, IoT, Logs, Streams) │
105
+ └────────────────────────────┬─────────────────────────────────┘
106
+
107
+ ┌────────────────────────────┴─────────────────────────────────┐
108
+ │ Ingestion Layer │
109
+ │ (Kinesis, DMS, AppFlow, Transfer Family) │
110
+ └────────────────────────────┬─────────────────────────────────┘
111
+
112
+ ┌────────────────────────────┴─────────────────────────────────┐
113
+ │ Storage Layer │
114
+ │ S3 (Raw → Processed → Curated) │
115
+ │ + Lake Formation │
116
+ └────────────────────────────┬─────────────────────────────────┘
117
+
118
+ ┌────────────────────────────┴─────────────────────────────────┐
119
+ │ Processing Layer │
120
+ │ (Glue, EMR, Athena, Redshift Spectrum) │
121
+ └────────────────────────────┬─────────────────────────────────┘
122
+
123
+ ┌────────────────────────────┴─────────────────────────────────┐
124
+ │ Consumption Layer │
125
+ │ (QuickSight, SageMaker, APIs) │
126
+ └──────────────────────────────────────────────────────────────┘
127
+ ```
128
+
129
+ ## CI/CD Pipeline
130
+
131
+ ```
132
+ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
133
+ │ GitHub / │───▶│ CodePipeline│───▶│ CodeBuild │
134
+ │ CodeCommit │ │ (Source) │ │ (Build) │
135
+ └──────────────┘ └──────────────┘ └──────┬───────┘
136
+
137
+ ┌─────────────────────┴─────────────────────┐
138
+ │ │
139
+ ▼ ▼
140
+ ┌──────────────┐ ┌──────────────┐
141
+ │ ECR │ │ S3 │
142
+ │ (Container) │ │ (Artifact) │
143
+ └──────┬───────┘ └──────┬───────┘
144
+ │ │
145
+ └─────────────────┬─────────────────────────┘
146
+
147
+
148
+ ┌──────────────────┐
149
+ │ CodeDeploy │
150
+ │ (Blue/Green) │
151
+ └────────┬─────────┘
152
+
153
+ ┌────────────────────────┼────────────────────────┐
154
+ │ │ │
155
+ ▼ ▼ ▼
156
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
157
+ │ Dev │ │ Stage │ │ Prod │
158
+ │ ECS │ │ ECS │ │ ECS │
159
+ └──────────┘ └──────────┘ └──────────┘
160
+ ```
161
+
162
+ ## Disaster Recovery
163
+
164
+ | Strategy | RTO | RPO | Cost |
165
+ |----------|-----|-----|------|
166
+ | Backup & Restore | Hours | Hours | $ |
167
+ | Pilot Light | Minutes-Hours | Minutes | $$ |
168
+ | Warm Standby | Minutes | Seconds | $$$ |
169
+ | Multi-Site Active | Near Zero | Near Zero | $$$$ |
@@ -0,0 +1,26 @@
1
+ # AWS Guide
2
+
3
+ metadata:
4
+ name: aws
5
+ description: AWS cloud reference documentation
6
+
7
+ source:
8
+ type: external
9
+ origin: aws.amazon.com
10
+ urls:
11
+ - https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html
12
+ - https://docs.aws.amazon.com/
13
+ - https://aws.amazon.com/architecture/
14
+ last_fetched: "2026-01-22"
15
+
16
+ documents:
17
+ - name: well-architected
18
+ path: ./well-architected.md
19
+ description: AWS Well-Architected Framework summary
20
+
21
+ - name: common-patterns
22
+ path: ./common-patterns.md
23
+ description: Common AWS architecture patterns
24
+
25
+ used_by:
26
+ - aws-expert
@@ -0,0 +1,143 @@
1
+ # AWS Well-Architected Framework
2
+
3
+ > Source: https://docs.aws.amazon.com/wellarchitected/
4
+
5
+ ## Overview
6
+
7
+ The AWS Well-Architected Framework helps you understand the pros and cons of decisions you make while building systems on AWS.
8
+
9
+ ## Six Pillars
10
+
11
+ ### 1. Operational Excellence
12
+
13
+ Focus on running and monitoring systems to deliver business value.
14
+
15
+ **Design Principles:**
16
+ - Perform operations as code
17
+ - Make frequent, small, reversible changes
18
+ - Refine operations procedures frequently
19
+ - Anticipate failure
20
+ - Learn from operational failures
21
+
22
+ **Key Services:**
23
+ - AWS CloudFormation
24
+ - AWS Config
25
+ - Amazon CloudWatch
26
+ - AWS Systems Manager
27
+
28
+ ### 2. Security
29
+
30
+ Protect information, systems, and assets.
31
+
32
+ **Design Principles:**
33
+ - Implement strong identity foundation
34
+ - Enable traceability
35
+ - Apply security at all layers
36
+ - Automate security best practices
37
+ - Protect data in transit and at rest
38
+ - Keep people away from data
39
+ - Prepare for security events
40
+
41
+ **Key Services:**
42
+ - AWS IAM
43
+ - AWS KMS
44
+ - AWS WAF
45
+ - Amazon GuardDuty
46
+ - AWS Security Hub
47
+
48
+ ### 3. Reliability
49
+
50
+ Ensure workload performs correctly and consistently.
51
+
52
+ **Design Principles:**
53
+ - Automatically recover from failure
54
+ - Test recovery procedures
55
+ - Scale horizontally
56
+ - Stop guessing capacity
57
+ - Manage change through automation
58
+
59
+ **Key Services:**
60
+ - Amazon Route 53
61
+ - Elastic Load Balancing
62
+ - Auto Scaling
63
+ - AWS Backup
64
+
65
+ ### 4. Performance Efficiency
66
+
67
+ Use computing resources efficiently.
68
+
69
+ **Design Principles:**
70
+ - Democratize advanced technologies
71
+ - Go global in minutes
72
+ - Use serverless architectures
73
+ - Experiment more often
74
+ - Consider mechanical sympathy
75
+
76
+ **Key Services:**
77
+ - Amazon EC2 Auto Scaling
78
+ - AWS Lambda
79
+ - Amazon ElastiCache
80
+ - Amazon CloudFront
81
+
82
+ ### 5. Cost Optimization
83
+
84
+ Avoid unnecessary costs.
85
+
86
+ **Design Principles:**
87
+ - Implement cloud financial management
88
+ - Adopt consumption model
89
+ - Measure overall efficiency
90
+ - Stop spending money on undifferentiated heavy lifting
91
+ - Analyze and attribute expenditure
92
+
93
+ **Key Services:**
94
+ - AWS Cost Explorer
95
+ - AWS Budgets
96
+ - AWS Trusted Advisor
97
+ - Savings Plans
98
+
99
+ ### 6. Sustainability
100
+
101
+ Minimize environmental impacts.
102
+
103
+ **Design Principles:**
104
+ - Understand your impact
105
+ - Establish sustainability goals
106
+ - Maximize utilization
107
+ - Anticipate and adopt efficient offerings
108
+ - Use managed services
109
+ - Reduce downstream impact
110
+
111
+ ## Well-Architected Review
112
+
113
+ ### Questions to Ask
114
+
115
+ **Operational Excellence:**
116
+ - How do you manage and automate changes?
117
+ - How do you respond to unplanned events?
118
+ - How do you evolve operations?
119
+
120
+ **Security:**
121
+ - How do you manage identities?
122
+ - How do you detect security events?
123
+ - How do you protect your network?
124
+
125
+ **Reliability:**
126
+ - How do you manage service quotas?
127
+ - How does your system adapt to demand?
128
+ - How do you back up data?
129
+
130
+ **Performance Efficiency:**
131
+ - How do you select compute resources?
132
+ - How do you select storage solutions?
133
+ - How do you configure networking?
134
+
135
+ **Cost Optimization:**
136
+ - How do you manage usage?
137
+ - How do you monitor cost?
138
+ - How do you decommission resources?
139
+
140
+ **Sustainability:**
141
+ - How do you select efficient hardware?
142
+ - How do you reduce software impact?
143
+ - How do you reduce data movement?
@@ -0,0 +1,42 @@
1
+ # 기능 개요
2
+
3
+ Claude의 고급 기능 및 역량을 살펴보세요.
4
+
5
+ ## 핵심 기능
6
+
7
+ 이러한 기능들은 다양한 형식과 사용 사례에 걸쳐 콘텐츠를 처리, 분석 및 생성하기 위한 Claude의 기본 능력을 향상시킵니다.
8
+
9
+ | 기능 | 설명 |
10
+ |------|------|
11
+ | 1M token context window | 더 큰 문서를 처리하고, 더 긴 대화를 유지하며, 더 광범위한 코드베이스로 작업할 수 있게 해주는 확장된 컨텍스트 윈도우 |
12
+ | Agent Skills | Skills로 Claude의 기능을 확장. 사전 구축된 Skills(PowerPoint, Excel, Word, PDF) 또는 사용자 정의 Skills 생성 가능 |
13
+ | Batch processing | 비용 절감을 위해 대량의 요청을 비동기적으로 처리. 표준 API 호출보다 50% 저렴 |
14
+ | Citations | Claude의 응답을 소스 문서에 기반하게 함. 정확한 문장과 구절에 대한 자세한 참조 제공 |
15
+ | Context editing | 구성 가능한 전략으로 대화 컨텍스트를 자동으로 관리 |
16
+ | Effort | effort 매개변수를 사용하여 Claude가 응답할 때 사용하는 토큰 수를 제어 |
17
+ | Extended thinking | 복잡한 작업을 위한 향상된 추론 기능. Claude의 단계별 사고 과정에 대한 투명성 제공 |
18
+ | Files API | Claude와 함께 사용할 파일을 업로드하고 관리 |
19
+ | PDF support | PDF 문서에서 텍스트 및 시각적 콘텐츠를 처리하고 분석 |
20
+ | Prompt caching | Claude에 더 많은 배경 지식과 예제 출력을 제공하여 비용과 지연 시간을 줄임 |
21
+ | Search results | RAG 애플리케이션에 대한 자연스러운 인용을 활성화 |
22
+ | Structured outputs | JSON 출력 및 엄격한 도구 사용을 통한 스키마 준수 보장 |
23
+ | Token counting | 메시지를 보내기 전에 토큰 수를 결정 |
24
+ | Tool use | Claude가 외부 도구 및 API와 상호 작용할 수 있게 함 |
25
+
26
+ ## 도구
27
+
28
+ 이러한 기능들은 Claude가 외부 시스템과 상호 작용하고, 코드를 실행하며, 다양한 도구 인터페이스를 통해 자동화된 작업을 수행할 수 있게 합니다.
29
+
30
+ | 도구 | 설명 |
31
+ |------|------|
32
+ | Bash | bash 명령 및 스크립트를 실행하여 시스템 셸과 상호 작용 |
33
+ | Code execution | 샌드박스 환경에서 Python 코드를 실행 |
34
+ | Programmatic tool calling | 코드 실행 컨테이너 내에서 프로그래밍 방식으로 도구 호출 |
35
+ | Computer use | 스크린샷을 찍고 마우스 및 키보드 명령을 실행하여 컴퓨터 인터페이스 제어 |
36
+ | Fine-grained tool streaming | 버퍼링/JSON 검증 없이 도구 사용 매개변수를 스트리밍 |
37
+ | MCP connector | Messages API에서 직접 원격 MCP 서버에 연결 |
38
+ | Memory | Claude가 대화 간에 정보를 저장하고 검색 |
39
+ | Text editor | 기본 제공 텍스트 편집기 인터페이스를 사용하여 텍스트 파일을 만들고 편집 |
40
+ | Tool search | 정규식 기반 검색을 사용하여 동적으로 도구를 발견 |
41
+ | Web fetch | 지정된 웹 페이지 및 PDF 문서에서 전체 콘텐츠를 검색 |
42
+ | Web search | Claude의 포괄적인 지식을 웹 전체의 현재 실제 데이터로 보강 |