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.
- package/LICENSE +21 -0
- package/README.md +287 -0
- package/dist/cli/index.js +13299 -0
- package/dist/index.js +927 -0
- package/package.json +74 -0
- package/templates/.claude/contexts/dev.md +20 -0
- package/templates/.claude/contexts/ecomode.md +63 -0
- package/templates/.claude/contexts/index.yaml +41 -0
- package/templates/.claude/contexts/research.md +28 -0
- package/templates/.claude/contexts/review.md +23 -0
- package/templates/.claude/hooks/hooks.json +185 -0
- package/templates/.claude/hooks/hud/index.yaml +27 -0
- package/templates/.claude/hooks/hud/update-status.sh +32 -0
- package/templates/.claude/hooks/index.yaml +46 -0
- package/templates/.claude/hooks/memory-persistence/pre-compact.sh +37 -0
- package/templates/.claude/hooks/memory-persistence/session-end.sh +64 -0
- package/templates/.claude/hooks/memory-persistence/session-start.sh +41 -0
- package/templates/.claude/hooks/strategic-compact/suggest-compact.sh +50 -0
- package/templates/.claude/install-hooks.sh +100 -0
- package/templates/.claude/rules/MAY-optimization.md +93 -0
- package/templates/.claude/rules/MUST-agent-design.md +107 -0
- package/templates/.claude/rules/MUST-agent-identification.md +108 -0
- package/templates/.claude/rules/MUST-continuous-improvement.md +132 -0
- package/templates/.claude/rules/MUST-intent-transparency.md +199 -0
- package/templates/.claude/rules/MUST-language-policy.md +62 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +266 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +341 -0
- package/templates/.claude/rules/MUST-permissions.md +84 -0
- package/templates/.claude/rules/MUST-safety.md +69 -0
- package/templates/.claude/rules/MUST-sync-verification.md +219 -0
- package/templates/.claude/rules/MUST-tool-identification.md +112 -0
- package/templates/.claude/rules/SHOULD-ecomode.md +145 -0
- package/templates/.claude/rules/SHOULD-error-handling.md +102 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +89 -0
- package/templates/.claude/rules/SHOULD-interaction.md +103 -0
- package/templates/.claude/rules/SHOULD-memory-integration.md +114 -0
- package/templates/.claude/rules/SHOULD-pipeline-mode.md +165 -0
- package/templates/.claude/rules/index.yaml +125 -0
- package/templates/.claude/uninstall-hooks.sh +52 -0
- package/templates/CLAUDE.md.en +259 -0
- package/templates/CLAUDE.md.ko +259 -0
- package/templates/agents/index.yaml +237 -0
- package/templates/agents/infra-engineer/aws-expert/AGENT.md +47 -0
- package/templates/agents/infra-engineer/aws-expert/index.yaml +27 -0
- package/templates/agents/infra-engineer/docker-expert/AGENT.md +47 -0
- package/templates/agents/infra-engineer/docker-expert/index.yaml +27 -0
- package/templates/agents/manager/creator/AGENT.md +274 -0
- package/templates/agents/manager/creator/index.yaml +66 -0
- package/templates/agents/manager/gitnerd/AGENT.md +91 -0
- package/templates/agents/manager/gitnerd/index.yaml +55 -0
- package/templates/agents/manager/sauron/AGENT.md +153 -0
- package/templates/agents/manager/sauron/index.yaml +52 -0
- package/templates/agents/manager/supplier/AGENT.md +142 -0
- package/templates/agents/manager/supplier/index.yaml +31 -0
- package/templates/agents/manager/sync-checker/AGENT.md +34 -0
- package/templates/agents/manager/sync-checker/index.yaml +32 -0
- package/templates/agents/manager/updater/AGENT.md +125 -0
- package/templates/agents/manager/updater/index.yaml +31 -0
- package/templates/agents/orchestrator/dev-lead/AGENT.md +116 -0
- package/templates/agents/orchestrator/dev-lead/index.yaml +73 -0
- package/templates/agents/orchestrator/planner/AGENT.md +102 -0
- package/templates/agents/orchestrator/planner/index.yaml +38 -0
- package/templates/agents/orchestrator/qa-lead/AGENT.md +92 -0
- package/templates/agents/orchestrator/qa-lead/index.yaml +40 -0
- package/templates/agents/orchestrator/secretary/AGENT.md +132 -0
- package/templates/agents/orchestrator/secretary/index.yaml +55 -0
- package/templates/agents/qa-team/qa-engineer/AGENT.md +98 -0
- package/templates/agents/qa-team/qa-engineer/index.yaml +59 -0
- package/templates/agents/qa-team/qa-planner/AGENT.md +75 -0
- package/templates/agents/qa-team/qa-planner/index.yaml +47 -0
- package/templates/agents/qa-team/qa-writer/AGENT.md +98 -0
- package/templates/agents/qa-team/qa-writer/index.yaml +44 -0
- package/templates/agents/sw-architect/documenter/AGENT.md +120 -0
- package/templates/agents/sw-architect/documenter/index.yaml +39 -0
- package/templates/agents/sw-architect/speckit-agent/AGENT.md +127 -0
- package/templates/agents/sw-architect/speckit-agent/index.yaml +78 -0
- package/templates/agents/sw-engineer/backend/express-expert/AGENT.md +132 -0
- package/templates/agents/sw-engineer/backend/express-expert/index.yaml +36 -0
- package/templates/agents/sw-engineer/backend/fastapi-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/backend/fastapi-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/backend/go-backend-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/backend/go-backend-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/backend/nestjs-expert/AGENT.md +107 -0
- package/templates/agents/sw-engineer/backend/nestjs-expert/index.yaml +43 -0
- package/templates/agents/sw-engineer/backend/springboot-expert/AGENT.md +103 -0
- package/templates/agents/sw-engineer/backend/springboot-expert/index.yaml +69 -0
- package/templates/agents/sw-engineer/frontend/svelte-agent/AGENT.md +71 -0
- package/templates/agents/sw-engineer/frontend/svelte-agent/index.yaml +41 -0
- package/templates/agents/sw-engineer/frontend/vercel-agent/AGENT.md +67 -0
- package/templates/agents/sw-engineer/frontend/vercel-agent/index.yaml +43 -0
- package/templates/agents/sw-engineer/frontend/vuejs-agent/AGENT.md +71 -0
- package/templates/agents/sw-engineer/frontend/vuejs-agent/index.yaml +48 -0
- package/templates/agents/sw-engineer/language/golang-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/golang-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/java21-expert/AGENT.md +122 -0
- package/templates/agents/sw-engineer/language/java21-expert/index.yaml +51 -0
- package/templates/agents/sw-engineer/language/kotlin-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/kotlin-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/python-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/python-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/rust-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/rust-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/typescript-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/typescript-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/tooling/bun-expert/AGENT.md +73 -0
- package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml +46 -0
- package/templates/agents/sw-engineer/tooling/npm-expert/AGENT.md +160 -0
- package/templates/agents/sw-engineer/tooling/npm-expert/index.yaml +45 -0
- package/templates/agents/sw-engineer/tooling/optimizer/AGENT.md +170 -0
- package/templates/agents/sw-engineer/tooling/optimizer/index.yaml +45 -0
- package/templates/agents/system/memory-keeper/AGENT.md +126 -0
- package/templates/agents/system/memory-keeper/index.yaml +45 -0
- package/templates/agents/system/naggy/AGENT.md +72 -0
- package/templates/agents/system/naggy/index.yaml +35 -0
- package/templates/commands/COMMANDS.md +136 -0
- package/templates/commands/creator/agent.md +121 -0
- package/templates/commands/dev/refactor.md +126 -0
- package/templates/commands/dev/review.md +82 -0
- package/templates/commands/git/branch.yaml +8 -0
- package/templates/commands/git/commit.yaml +4 -0
- package/templates/commands/git/pr.yaml +4 -0
- package/templates/commands/git/status.yaml +4 -0
- package/templates/commands/git/sync.yaml +4 -0
- package/templates/commands/index.yaml +225 -0
- package/templates/commands/intent/explain.md +144 -0
- package/templates/commands/memory/recall.md +164 -0
- package/templates/commands/memory/save.md +128 -0
- package/templates/commands/naggy/add.yaml +8 -0
- package/templates/commands/naggy/done.yaml +8 -0
- package/templates/commands/naggy/list.yaml +4 -0
- package/templates/commands/naggy/priority.yaml +11 -0
- package/templates/commands/naggy/remind.yaml +4 -0
- package/templates/commands/npm/audit.yaml +62 -0
- package/templates/commands/npm/publish.yaml +52 -0
- package/templates/commands/npm/version.yaml +62 -0
- package/templates/commands/optimize/analyze.yaml +34 -0
- package/templates/commands/optimize/bundle.yaml +50 -0
- package/templates/commands/optimize/report.yaml +56 -0
- package/templates/commands/pipeline/list.md +81 -0
- package/templates/commands/pipeline/run.md +127 -0
- package/templates/commands/sauron/quick.yaml +4 -0
- package/templates/commands/sauron/report.yaml +4 -0
- package/templates/commands/sauron/watch.yaml +4 -0
- package/templates/commands/supplier/audit.md +133 -0
- package/templates/commands/supplier/fix.md +121 -0
- package/templates/commands/sync/agents.yaml +4 -0
- package/templates/commands/sync/check.yaml +4 -0
- package/templates/commands/sync/commands.yaml +4 -0
- package/templates/commands/sync/docs.yaml +4 -0
- package/templates/commands/sync/fix.yaml +4 -0
- package/templates/commands/system/help.md +137 -0
- package/templates/commands/system/lists.md +86 -0
- package/templates/commands/system/status.md +163 -0
- package/templates/commands/updater/docs.md +165 -0
- package/templates/commands/updater/external.md +214 -0
- package/templates/guides/aws/common-patterns.md +169 -0
- package/templates/guides/aws/index.yaml +26 -0
- package/templates/guides/aws/well-architected.md +143 -0
- package/templates/guides/claude-code/01-overview.md +42 -0
- package/templates/guides/claude-code/03-tools.md +107 -0
- package/templates/guides/claude-code/04-agent-skills.md +90 -0
- package/templates/guides/claude-code/05-agent-sdk.md +129 -0
- package/templates/guides/claude-code/06-mcp.md +165 -0
- package/templates/guides/claude-code/07-prompt-engineering.md +100 -0
- package/templates/guides/claude-code/08-testing.md +58 -0
- package/templates/guides/claude-code/09-guardrails.md +80 -0
- package/templates/guides/claude-code/10-monitoring.md +89 -0
- package/templates/guides/claude-code/index.yaml +51 -0
- package/templates/guides/docker/compose-best-practices.md +284 -0
- package/templates/guides/docker/dockerfile-best-practices.md +262 -0
- package/templates/guides/docker/index.yaml +26 -0
- package/templates/guides/fastapi/best-practices.md +232 -0
- package/templates/guides/fastapi/index.yaml +21 -0
- package/templates/guides/go-backend/index.yaml +26 -0
- package/templates/guides/go-backend/project-layout.md +243 -0
- package/templates/guides/go-backend/uber-style.md +212 -0
- package/templates/guides/golang/concurrency.md +282 -0
- package/templates/guides/golang/effective-go.md +309 -0
- package/templates/guides/golang/error-handling.md +250 -0
- package/templates/guides/golang/index.yaml +27 -0
- package/templates/guides/index.yaml +101 -0
- package/templates/guides/kotlin/coding-conventions.md +247 -0
- package/templates/guides/kotlin/idioms.md +234 -0
- package/templates/guides/kotlin/index.yaml +26 -0
- package/templates/guides/python/index.yaml +26 -0
- package/templates/guides/python/pep8-style-guide.md +202 -0
- package/templates/guides/python/zen-of-python.md +79 -0
- package/templates/guides/rust/error-handling.md +262 -0
- package/templates/guides/rust/index.yaml +26 -0
- package/templates/guides/rust/ownership.md +180 -0
- package/templates/guides/springboot/best-practices.md +361 -0
- package/templates/guides/springboot/index.yaml +22 -0
- package/templates/guides/typescript/advanced-types.md +225 -0
- package/templates/guides/typescript/index.yaml +26 -0
- package/templates/guides/typescript/type-system.md +219 -0
- package/templates/guides/web-design/accessibility.md +66 -0
- package/templates/guides/web-design/index.yaml +20 -0
- package/templates/guides/web-design/performance.md +102 -0
- package/templates/pipelines/examples/code-review.yaml +66 -0
- package/templates/pipelines/index.yaml +18 -0
- package/templates/pipelines/templates/pipeline-template.yaml +50 -0
- package/templates/skills/backend/fastapi-best-practices/SKILL.md +269 -0
- package/templates/skills/backend/fastapi-best-practices/index.yaml +25 -0
- package/templates/skills/backend/go-backend-best-practices/SKILL.md +337 -0
- package/templates/skills/backend/go-backend-best-practices/index.yaml +26 -0
- package/templates/skills/backend/springboot-best-practices/SKILL.md +356 -0
- package/templates/skills/backend/springboot-best-practices/index.yaml +27 -0
- package/templates/skills/development/go-best-practices/SKILL.md +202 -0
- package/templates/skills/development/go-best-practices/index.yaml +25 -0
- package/templates/skills/development/kotlin-best-practices/SKILL.md +255 -0
- package/templates/skills/development/kotlin-best-practices/index.yaml +27 -0
- package/templates/skills/development/python-best-practices/SKILL.md +221 -0
- package/templates/skills/development/python-best-practices/index.yaml +25 -0
- package/templates/skills/development/react-best-practices/SKILL.md +100 -0
- package/templates/skills/development/react-best-practices/index.yaml +39 -0
- package/templates/skills/development/rust-best-practices/SKILL.md +266 -0
- package/templates/skills/development/rust-best-practices/index.yaml +26 -0
- package/templates/skills/development/typescript-best-practices/SKILL.md +320 -0
- package/templates/skills/development/typescript-best-practices/index.yaml +28 -0
- package/templates/skills/development/vercel-deploy/SKILL.md +73 -0
- package/templates/skills/development/vercel-deploy/index.yaml +30 -0
- package/templates/skills/development/web-design-guidelines/SKILL.md +117 -0
- package/templates/skills/development/web-design-guidelines/index.yaml +34 -0
- package/templates/skills/index.yaml +129 -0
- package/templates/skills/infrastructure/aws-best-practices/SKILL.md +279 -0
- package/templates/skills/infrastructure/aws-best-practices/index.yaml +27 -0
- package/templates/skills/infrastructure/docker-best-practices/SKILL.md +274 -0
- package/templates/skills/infrastructure/docker-best-practices/index.yaml +26 -0
- package/templates/skills/orchestration/intent-detection/SKILL.md +214 -0
- package/templates/skills/orchestration/intent-detection/index.yaml +30 -0
- package/templates/skills/orchestration/intent-detection/patterns/agent-triggers.yaml +333 -0
- package/templates/skills/orchestration/pipeline-execution/SKILL.md +188 -0
- package/templates/skills/orchestration/pipeline-execution/index.yaml +27 -0
- package/templates/skills/system/memory-management/SKILL.md +194 -0
- package/templates/skills/system/memory-management/index.yaml +30 -0
- package/templates/skills/system/result-aggregation/SKILL.md +163 -0
- 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의 포괄적인 지식을 웹 전체의 현재 실제 데이터로 보강 |
|