@azerogluemin/ai-bootstrap 0.4.0 → 0.4.2
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/CHANGELOG.md +34 -0
- package/README.md +305 -84
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,40 @@ All notable changes to `@azerogluemin/ai-bootstrap` are documented here.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [0.4.2] — 2026-06-21
|
|
9
|
+
|
|
10
|
+
README quick-start fixed — global install upfront.
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- README quick-start was inconsistent: step 1 used `npx` (one-shot, no install),
|
|
15
|
+
step 2 used `ai-bootstrap new` (requires global install). Users hit
|
|
16
|
+
`zsh: command not found: ai-bootstrap` after the wizard.
|
|
17
|
+
- Quick-start is now 3 steps: `npm install -g` → `ai-bootstrap` (wizard) →
|
|
18
|
+
`ai-bootstrap new` (per project)
|
|
19
|
+
- Explanation added: why global install (so `new` / `add` / `doctor` are
|
|
20
|
+
available everywhere) + alternative (always-`npx`)
|
|
21
|
+
- No functional code changes vs. 0.4.1.
|
|
22
|
+
|
|
23
|
+
[0.4.2]: https://github.com/eminazeroglu/ai-bootstrap/releases/tag/v0.4.2
|
|
24
|
+
|
|
25
|
+
## [0.4.1] — 2026-06-21
|
|
26
|
+
|
|
27
|
+
README rewrite — published so npm.com lands on the new usage guide.
|
|
28
|
+
|
|
29
|
+
### Changed
|
|
30
|
+
|
|
31
|
+
- packages/cli/README.md — full rewrite (AZ):
|
|
32
|
+
- 2-step TL;DR quick start
|
|
33
|
+
- User scope vs. project scope explained with table
|
|
34
|
+
- 5 real workflow scenarios (Creator/IG, SaaS, SMM, add bundle, remove)
|
|
35
|
+
- All commands grouped by purpose (setup, mgmt, MCP, backup, telemetry)
|
|
36
|
+
- 63 MCP server categorized list
|
|
37
|
+
- Troubleshooting section (5 common issues)
|
|
38
|
+
- No functional code changes vs. 0.4.0.
|
|
39
|
+
|
|
40
|
+
[0.4.1]: https://github.com/eminazeroglu/ai-bootstrap/releases/tag/v0.4.1
|
|
41
|
+
|
|
8
42
|
## [0.4.0] — 2026-06-21
|
|
9
43
|
|
|
10
44
|
Incremental skill + agent management — add / remove / list.
|
package/README.md
CHANGED
|
@@ -1,139 +1,359 @@
|
|
|
1
1
|
# @azerogluemin/ai-bootstrap
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> **Bir komanda. Hər layihə. Hər maşın. Claude Code hər şeyi yadda saxlayır.**
|
|
4
4
|
|
|
5
|
+
[](https://www.npmjs.com/package/@azerogluemin/ai-bootstrap)
|
|
5
6
|
[](https://opensource.org/licenses/MIT)
|
|
6
|
-
[](https://www.typescriptlang.org/)
|
|
7
7
|
[](https://nodejs.org/)
|
|
8
|
-
[](https://github.com/eminazeroglu/ai-bootstrap)
|
|
9
8
|
|
|
10
|
-
##
|
|
9
|
+
## TL;DR — 3 addım
|
|
11
10
|
|
|
12
11
|
```bash
|
|
13
|
-
|
|
12
|
+
# 1) Bir dəfə qlobal install (ai-bootstrap komandasını maşına əlavə edir)
|
|
13
|
+
npm install -g @azerogluemin/ai-bootstrap
|
|
14
|
+
|
|
15
|
+
# 2) Bir dəfə user-scope wizard (foundation: 10 universal skill)
|
|
16
|
+
ai-bootstrap
|
|
17
|
+
|
|
18
|
+
# 3) Hər yeni layihədə (bundle: layihənin növünə uyğun skill-lər)
|
|
19
|
+
cd ~/Projects/yeni-layihə
|
|
20
|
+
ai-bootstrap new
|
|
14
21
|
```
|
|
15
22
|
|
|
16
|
-
|
|
23
|
+
Bitdi. Hər layihədə sadəcə `claude` yaz — uyğun skill + agent dəstləri özü yüklənir.
|
|
24
|
+
|
|
25
|
+
> **Niyə qlobal install?** `npx @azerogluemin/ai-bootstrap` paketi bir dəfə işlədir,
|
|
26
|
+
> sonra `ai-bootstrap new` komandası tapılmır. Qlobal install ilə komanda hər yerdə əlçatandır.
|
|
27
|
+
> Alternativ: hər dəfə `npx @azerogluemin/ai-bootstrap@latest <command>` yazmaq (uzun).
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Necə işləyir — 2 səviyyəli skill sistemi
|
|
32
|
+
|
|
33
|
+
Claude Code skill-ləri **2 səviyyəlidir**:
|
|
17
34
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
- `developer` — 21 skills, 18 agents (engineering focus)
|
|
23
|
-
- `marketer` — 24 skills, 29 agents (SEO + social + growth)
|
|
24
|
-
- `creator` — 26 skills, 13 agents (video, music, storyboard)
|
|
25
|
-
- `founder` — 35 skills, 38 agents (C-Level + business + product)
|
|
26
|
-
- `full-stack` — 52+ skills, 75+ agents (everything)
|
|
27
|
-
4. **MCPs** — pick from 63 Model Context Protocol servers (github, postgres, supabase, notion, slack, atlassian, gmail, twilio, sendgrid, spotify, kubernetes, …)
|
|
28
|
-
5. **Memory** — markdown + git knowledge architecture (25-50× faster than vector DB at <100K entries)
|
|
29
|
-
6. **GitHub** — optional `~/.claude/` backup repo
|
|
35
|
+
| Səviyyə | Yer | Nə vaxt yüklənir |
|
|
36
|
+
|---|---|---|
|
|
37
|
+
| **User scope** (qlobal) | `~/.claude/skills/` | Hər layihədə, hər session-da |
|
|
38
|
+
| **Project scope** (lokal) | `<layihə>/.claude/skills/` | YALNIZ o qovluqda |
|
|
30
39
|
|
|
31
|
-
|
|
40
|
+
ai-bootstrap bunun ikisini də idarə edir:
|
|
41
|
+
- **`npx @azerogluemin/ai-bootstrap`** → user scope (foundation: 10 əsas skill, universal lazımdır)
|
|
42
|
+
- **`ai-bootstrap new`** → project scope (layihə növünə uyğun bundle)
|
|
32
43
|
|
|
33
|
-
|
|
44
|
+
Beləliklə **AI Creator** layihən və **SaaS** layihən fərqli skill dəstləri görür. Token israfı yoxdur.
|
|
34
45
|
|
|
35
|
-
|
|
36
|
-
- **75+ specialized agents** including SEO suite (18), C-Level mirrors (10), Engineering (14), Social orchestrators (5), Marketing (6), Vertical specialists (8), Product team (5)
|
|
37
|
-
- **63 MCP servers** in catalog with real install commands + OAuth/credential helpers (stdio + HTTP transports)
|
|
38
|
-
- **Universal CLAUDE.md** with 8 foundation rules (docs-first, learning-keeper auto-promotion, dürüst dialoq, etc.)
|
|
39
|
-
- **Knowledge skeleton**: `user-profile`, `mistakes-log`, `verified-facts`, `user-rules`, `patterns`, `handoff-log`, language guides, projects manifest
|
|
40
|
-
- **Interactive permission gates** via Claude Code's settings.json
|
|
46
|
+
---
|
|
41
47
|
|
|
42
|
-
##
|
|
48
|
+
## İlk dəfə qurulum (bir dəfə maşına)
|
|
43
49
|
|
|
44
50
|
```bash
|
|
45
|
-
#
|
|
46
|
-
|
|
51
|
+
# Qlobal install — ai-bootstrap komandasını maşına əlavə edir
|
|
52
|
+
npm install -g @azerogluemin/ai-bootstrap
|
|
47
53
|
|
|
48
|
-
#
|
|
49
|
-
ai-bootstrap
|
|
50
|
-
|
|
54
|
+
# Sonra wizard:
|
|
55
|
+
ai-bootstrap
|
|
56
|
+
```
|
|
51
57
|
|
|
52
|
-
|
|
53
|
-
ai-bootstrap mcp list # List all 63 MCP servers available
|
|
54
|
-
ai-bootstrap mcp installed # List MCPs configured on this machine
|
|
55
|
-
ai-bootstrap mcp credentials # Interactively fill MCP credentials
|
|
58
|
+
Wizard 6 addım soruşur:
|
|
56
59
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
60
|
+
1. **Profile** — adın, rolun, dillərin, 6/12/24 ay məqsədlərin
|
|
61
|
+
2. **Projects** — mövcud layihələri scan etmək istəyirsən? (boş burax — sonra qurarsan)
|
|
62
|
+
3. **Bundle** — **`foundation`** seç (qlobal yalnız əsas 10 skill lazımdır; qalanlar project scope-da)
|
|
63
|
+
4. **MCPs** — istədiyin MCP server-ləri seç (məs. github, instagram, brave-search)
|
|
64
|
+
5. **Memory** — `markdown-only` (default tövsiyə)
|
|
65
|
+
6. **GitHub backup** — istərsən qur, istəməsən boş burax (sonra `ai-bootstrap backup init`)
|
|
62
66
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
ai-bootstrap
|
|
66
|
-
|
|
67
|
+
Yoxla:
|
|
68
|
+
```bash
|
|
69
|
+
ai-bootstrap doctor
|
|
70
|
+
```
|
|
71
|
+
Hər şey ✓ olmalıdır.
|
|
67
72
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
ai-bootstrap
|
|
73
|
+
MCP credential əlavə et (məs. github, instagram tokenları):
|
|
74
|
+
```bash
|
|
75
|
+
ai-bootstrap mcp credentials
|
|
71
76
|
```
|
|
72
77
|
|
|
73
|
-
|
|
78
|
+
`~/.zshrc`-ə (yaxud `~/.bashrc`) bir dəfə əlavə et:
|
|
79
|
+
```bash
|
|
80
|
+
echo 'set -a; [ -f ~/.ai-bootstrap.env ] && source ~/.ai-bootstrap.env; set +a' >> ~/.zshrc
|
|
81
|
+
source ~/.zshrc
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Hər yeni layihədə (1 komanda)
|
|
74
87
|
|
|
88
|
+
```bash
|
|
89
|
+
cd ~/Projects/yeni-layihə
|
|
90
|
+
ai-bootstrap new
|
|
75
91
|
```
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
92
|
+
|
|
93
|
+
Wizard soruşur: **"Bu qovluqda nə etmək istəyirsən?"**
|
|
94
|
+
|
|
95
|
+
| Sənin cavab | Bundle | Skill | Agent |
|
|
96
|
+
|---|---|---|---|
|
|
97
|
+
| SaaS / Fullstack web app | `developer` | 21 | 18 |
|
|
98
|
+
| AI Creator content | `creator` | 26 | 13 |
|
|
99
|
+
| Marketing / SMM | `marketer` | 24 | 29 |
|
|
100
|
+
| Mobile app | `developer` | 21 | 18 |
|
|
101
|
+
| Data analysis / dashboard | `developer` | 21 | 18 |
|
|
102
|
+
| Client agency work | `full-stack` | 52+ | 75+ |
|
|
103
|
+
| Startup / founder | `founder` | 35 | 38 |
|
|
104
|
+
| Open source library | `developer` | 21 | 18 |
|
|
105
|
+
| Just basics | `foundation` | 10 | 2 |
|
|
106
|
+
|
|
107
|
+
Yazır:
|
|
108
|
+
- `<layihə>/.claude/skills/` — layihəyə xas skill-lər
|
|
109
|
+
- `<layihə>/.claude/agents/` — layihəyə xas agent-lər
|
|
110
|
+
- `<layihə>/CLAUDE.md` — layihə qaydaları + təsvir
|
|
111
|
+
|
|
112
|
+
İndi:
|
|
113
|
+
```bash
|
|
114
|
+
claude
|
|
80
115
|
```
|
|
116
|
+
Yalnız bu layihənin skill dəsti yüklənir.
|
|
81
117
|
|
|
82
|
-
|
|
118
|
+
---
|
|
83
119
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
| `~/.claude/settings.json` | Permissions, model preference, hooks |
|
|
88
|
-
| `~/.claude/knowledge/*.md` | Cross-project knowledge |
|
|
89
|
-
| `~/.claude/skills/<name>/` | Installed skill (copied from template) |
|
|
90
|
-
| `~/.claude/agents/<name>/` | Installed agent (copied from template) |
|
|
91
|
-
| `~/.claude.json` | MCP server configs (Claude Code reads this) |
|
|
92
|
-
| `~/.claude/mcp-tracking.json` | ai-bootstrap metadata: which MCPs, what creds needed |
|
|
93
|
-
| `~/.claude/ai-bootstrap-state.json` | Saved bundle selection (for `update`) |
|
|
94
|
-
| `~/.ai-bootstrap.env` | MCP credentials (chmod 600, source in shell) |
|
|
120
|
+
## Real istifadə nümunələri
|
|
121
|
+
|
|
122
|
+
### Senaryo 1: AI Creator layihəsi (məs. Instagram brand)
|
|
95
123
|
|
|
96
|
-
|
|
124
|
+
```bash
|
|
125
|
+
mkdir -p ~/Projects/azerogluemin-content && cd ~/Projects/azerogluemin-content
|
|
126
|
+
ai-bootstrap new
|
|
127
|
+
# Soruşur → "AI Creator content" seç → creator bundle
|
|
128
|
+
# 26 skill: showrunner, character-designer, image-prompt-engineer,
|
|
129
|
+
# video-prompt-engineer, youtube-thumbnail-designer,
|
|
130
|
+
# brand-identity-designer, instagram-expert, ...
|
|
131
|
+
# 13 agent: video-pipeline, storyboard-orchestrator, sound-designer, ...
|
|
132
|
+
|
|
133
|
+
claude
|
|
134
|
+
> "10 günlük IG content calendar yarat — AZ-də, mövzu AI-creator workflow"
|
|
135
|
+
> "Reel hook yaz: developer → AI creator pivot"
|
|
136
|
+
> "YouTube thumbnail dizayn et: AI bootstrap launch"
|
|
137
|
+
```
|
|
97
138
|
|
|
98
|
-
|
|
139
|
+
### Senaryo 2: SaaS layihə
|
|
99
140
|
|
|
100
141
|
```bash
|
|
101
|
-
|
|
142
|
+
mkdir -p ~/Projects/restoran-crm && cd ~/Projects/restoran-crm
|
|
143
|
+
ai-bootstrap new
|
|
144
|
+
# → "SaaS / Fullstack web app" → developer bundle
|
|
145
|
+
# 21 skill: architect, backend, frontend, devops, security-auditor, ...
|
|
146
|
+
# 18 agent: code-reviewer, backend-engineer, frontend-engineer, db-migrator, ...
|
|
147
|
+
|
|
148
|
+
claude
|
|
149
|
+
> "Multi-tenant restoran CRM arxitekturası dizayn et"
|
|
150
|
+
> "Postgres RLS policy yaz hər tenant üçün"
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Senaryo 3: Müştəri SMM işi
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
mkdir -p ~/Clients/restoran-smm && cd ~/Clients/restoran-smm
|
|
157
|
+
ai-bootstrap new
|
|
158
|
+
# → "Marketing / SMM" → marketer bundle
|
|
159
|
+
# 24 skill: seo-optimizer, copywriter-pro, social-strategist,
|
|
160
|
+
# paid-ads-strategist, content-strategist, ...
|
|
161
|
+
# 29 agent: 18 SEO agent + social orchestrators + marketing agents
|
|
162
|
+
|
|
163
|
+
claude
|
|
164
|
+
> "Restoran üçün 30 günlük IG content plan + Reel hook-lar"
|
|
165
|
+
> "SEO audit et müştərinin saytında"
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### Senaryo 4: Bundle əskik gəlir, əlavə skill lazımdır
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
cd ~/Projects/restoran-crm # developer bundle qurulub
|
|
172
|
+
# İndi müştəri marketing landing page istəyir, creator skill-ləri lazımdır:
|
|
173
|
+
ai-bootstrap add showrunner image-prompt-engineer brand-identity-designer
|
|
174
|
+
|
|
175
|
+
# Yaxud bütün creator bundle əlavə et:
|
|
176
|
+
ai-bootstrap add --bundle creator
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Senaryo 5: İstifadə etmədiyini sil
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
ai-bootstrap list # bu layihənin skill-ləri
|
|
183
|
+
ai-bootstrap list --all # user + bu layihə yan-yana
|
|
184
|
+
ai-bootstrap remove security-auditor # silmək
|
|
102
185
|
```
|
|
103
186
|
|
|
104
|
-
|
|
187
|
+
---
|
|
105
188
|
|
|
189
|
+
## Bütün komandalar
|
|
190
|
+
|
|
191
|
+
### Setup + sync
|
|
106
192
|
```bash
|
|
107
|
-
#
|
|
108
|
-
|
|
193
|
+
npm install -g @azerogluemin/ai-bootstrap # bir dəfə qlobal install
|
|
194
|
+
ai-bootstrap # ilk wizard (user scope foundation)
|
|
195
|
+
ai-bootstrap new # bu qovluğa layihə bundle (hər layihə)
|
|
196
|
+
ai-bootstrap update # yeni versiyada skill-ləri yenilə
|
|
197
|
+
ai-bootstrap doctor # sağlamlıq yoxlaması
|
|
109
198
|
```
|
|
110
199
|
|
|
111
|
-
|
|
200
|
+
### Skill management
|
|
201
|
+
```bash
|
|
202
|
+
ai-bootstrap add <name1> <name2> # konkret skill/agent əlavə
|
|
203
|
+
ai-bootstrap add --bundle <name> # bütün bundle əlavə
|
|
204
|
+
ai-bootstrap remove <name> # sil (alias: rm)
|
|
205
|
+
ai-bootstrap list # bu scope-da quraşdırılanlar
|
|
206
|
+
ai-bootstrap list --all # user + project hamısı (alias: ls)
|
|
207
|
+
ai-bootstrap list --user # yalnız user scope
|
|
208
|
+
ai-bootstrap list --project # yalnız bu layihə
|
|
209
|
+
```
|
|
112
210
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
-
|
|
211
|
+
### MCP servers (Instagram, GitHub, Supabase və s.)
|
|
212
|
+
```bash
|
|
213
|
+
ai-bootstrap mcp list # 63 mövcud MCP göstər
|
|
214
|
+
ai-bootstrap mcp installed # quraşdırılan MCP-lər
|
|
215
|
+
ai-bootstrap mcp credentials # token-ləri əlavə et
|
|
216
|
+
```
|
|
116
217
|
|
|
117
|
-
|
|
218
|
+
### Backup (xeyrli)
|
|
219
|
+
```bash
|
|
220
|
+
ai-bootstrap backup init # private GitHub repo-ya bağla
|
|
221
|
+
ai-bootstrap backup sync # dəyişikliyi push et
|
|
222
|
+
ai-bootstrap backup pull # yeni maşında bərpa
|
|
223
|
+
ai-bootstrap backup status # son sinx + remote
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
### Telemetry (default OFF, opt-in)
|
|
227
|
+
```bash
|
|
228
|
+
ai-bootstrap telemetry on/off/status
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## Bundle siyahısı
|
|
234
|
+
|
|
235
|
+
| Bundle | Skill | Agent | Nə üçün |
|
|
236
|
+
|---|---|---|---|
|
|
237
|
+
| `foundation` | 10 | 2 | Universal əsas — user scope-a tövsiyə |
|
|
238
|
+
| `developer` | 21 | 18 | SaaS, fullstack, mobile, data, open source |
|
|
239
|
+
| `creator` | 26 | 13 | Video, Reel, sosial content, brand |
|
|
240
|
+
| `marketer` | 24 | 29 | SEO, SMM, copywriting, ads (18 SEO agent) |
|
|
241
|
+
| `founder` | 35 | 38 | C-Level advisory + product + marketing |
|
|
242
|
+
| `full-stack` | 52+ | 75+ | Hamısı — multi-rol agency işi |
|
|
243
|
+
|
|
244
|
+
Tam siyahı: `npx @azerogluemin/ai-bootstrap mcp list` (MCP-lər) yaxud GitHub repo-da [packages/templates/](https://github.com/eminazeroglu/ai-bootstrap/tree/main/packages/templates).
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## 63 MCP server (real install komanda-ları ilə)
|
|
249
|
+
|
|
250
|
+
**Dev**: github, gitlab, filesystem, git, fetch, puppeteer, playwright, vercel, cloudflare, aws, netlify, brave-search, firecrawl, tavily, exa, kubernetes, browserbase, apify, time
|
|
251
|
+
|
|
252
|
+
**Data**: postgres, supabase, mongodb, sqlite, redis, airtable
|
|
253
|
+
|
|
254
|
+
**Productivity**: notion, linear, obsidian, slack, discord, memory, atlassian (Jira + Confluence), trello, asana, clickup
|
|
255
|
+
|
|
256
|
+
**Social**: instagram, twitter, meta, youtube, linkedin, tiktok, telegram
|
|
257
|
+
|
|
258
|
+
**AI**: openai, anthropic, elevenlabs, replicate, perplexity
|
|
259
|
+
|
|
260
|
+
**Creator**: figma, spotify, youtube-transcript
|
|
261
|
+
|
|
262
|
+
**Business**: stripe, hubspot, salesforce, twilio, sendgrid
|
|
263
|
+
|
|
264
|
+
**Analytics**: ga4, sentry, posthog
|
|
265
|
+
|
|
266
|
+
**Research**: arxiv
|
|
267
|
+
|
|
268
|
+
**Google Workspace** (HTTP/OAuth): gmail, google-drive, google-calendar, google-chat
|
|
269
|
+
|
|
270
|
+
---
|
|
271
|
+
|
|
272
|
+
## 3 səviyyəli yaddaş
|
|
273
|
+
|
|
274
|
+
```
|
|
275
|
+
~/.claude/CLAUDE.md ← universal qaydalar (hər session)
|
|
276
|
+
~/.claude/knowledge/ ← cross-layihə yaddaş (markdown + git)
|
|
277
|
+
learning-keeper skill ← səhvləri yadda saxlayır, qaydaya çevirir
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
learning-keeper skill xüsusi: söhbətdə düzəliş edirsənsə ("yox elə yox, belə"), bu skill o düzəlişi `~/.claude/knowledge/mistakes-log.md`-ə yazır. Növbəti dəfə həmin səhvi etməyəcək.
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Files written
|
|
285
|
+
|
|
286
|
+
| Yer | Nə üçün |
|
|
287
|
+
|---|---|
|
|
288
|
+
| `~/.claude/CLAUDE.md` | Universal foundation qaydalar |
|
|
289
|
+
| `~/.claude/settings.json` | Permission, model, hook |
|
|
290
|
+
| `~/.claude/knowledge/*.md` | Cross-layihə yaddaş |
|
|
291
|
+
| `~/.claude/skills/<name>/` | User-scope skill (qlobal) |
|
|
292
|
+
| `~/.claude/agents/<name>/` | User-scope agent (qlobal) |
|
|
293
|
+
| `~/.claude.json` | MCP server konfiqurasiyaları |
|
|
294
|
+
| `~/.claude/mcp-tracking.json` | ai-bootstrap metadata |
|
|
295
|
+
| `~/.ai-bootstrap.env` | MCP credential-lar (chmod 600) |
|
|
296
|
+
| `<layihə>/CLAUDE.md` | Layihə qaydaları |
|
|
297
|
+
| `<layihə>/.claude/skills/` | Project-scope skill (yalnız bu qovluqda) |
|
|
298
|
+
| `<layihə>/.claude/agents/` | Project-scope agent |
|
|
299
|
+
| `<layihə>/.claude/ai-bootstrap-project.json` | Layihə bundle state |
|
|
300
|
+
|
|
301
|
+
---
|
|
302
|
+
|
|
303
|
+
## Tələblər
|
|
304
|
+
|
|
305
|
+
- **Node.js ≥ 22**
|
|
306
|
+
- **macOS / Linux / WSL2** — primary; Windows native best-effort
|
|
307
|
+
- **Disk**: ~3 MB templates + sənin yaratdığın yaddaş
|
|
308
|
+
|
|
309
|
+
---
|
|
310
|
+
|
|
311
|
+
## Problem həlli
|
|
312
|
+
|
|
313
|
+
### `ai-bootstrap: command not found`
|
|
314
|
+
`npx @azerogluemin/ai-bootstrap` ilə qaçırılırsa global yox. Düzəliş: ya `npm i -g @azerogluemin/ai-bootstrap`, yaxud həmişə `npx @azerogluemin/ai-bootstrap@latest <command>`.
|
|
315
|
+
|
|
316
|
+
### `npm publish` 404
|
|
317
|
+
Scope səhvdir. Paket adı `@<sənin npm username>/...` ilə başlamalıdır.
|
|
318
|
+
|
|
319
|
+
### `ai-bootstrap doctor` failure göstərir
|
|
320
|
+
- Symlink qırılıbsa → `ai-bootstrap update` qaçır
|
|
321
|
+
- MCP creds yoxdursa → `ai-bootstrap mcp credentials`
|
|
322
|
+
- CLAUDE.md yoxdursa → `npx @azerogluemin/ai-bootstrap` yenidən qaçır
|
|
323
|
+
|
|
324
|
+
### Skill aktivləşmir Claude-da
|
|
325
|
+
- Doğru qovluqda olduğunu yoxla (`pwd`)
|
|
326
|
+
- Project scope qurulubsa → `<layihə>/.claude/skills/` mövcuddur?
|
|
327
|
+
- `ai-bootstrap list` ilə təsdiq et
|
|
328
|
+
|
|
329
|
+
### MCP server connect olmur
|
|
330
|
+
- `~/.ai-bootstrap.env`-də credential-lar var?
|
|
331
|
+
- Shell yenidən load et: `source ~/.zshrc`
|
|
332
|
+
- `ai-bootstrap doctor` yoxla
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
## Development (contribute etmək üçün)
|
|
118
337
|
|
|
119
338
|
```bash
|
|
120
339
|
git clone https://github.com/eminazeroglu/ai-bootstrap.git
|
|
121
340
|
cd ai-bootstrap
|
|
122
341
|
|
|
123
|
-
pnpm install
|
|
342
|
+
pnpm install
|
|
124
343
|
pnpm --filter @azerogluemin/ai-bootstrap build
|
|
125
|
-
pnpm --filter @azerogluemin/ai-bootstrap test #
|
|
126
|
-
|
|
127
|
-
# Run locally without npx
|
|
128
|
-
node packages/cli/bin/init.js
|
|
344
|
+
pnpm --filter @azerogluemin/ai-bootstrap test # 134+ test (smoke + e2e)
|
|
129
345
|
|
|
130
|
-
#
|
|
346
|
+
# Lokal test isolated HOME-da:
|
|
131
347
|
HOME=/tmp/ab-sandbox node packages/cli/bin/init.js
|
|
132
348
|
```
|
|
133
349
|
|
|
350
|
+
Detallı [CONTRIBUTING.md](https://github.com/eminazeroglu/ai-bootstrap/blob/main/CONTRIBUTING.md).
|
|
351
|
+
|
|
352
|
+
---
|
|
353
|
+
|
|
134
354
|
## License
|
|
135
355
|
|
|
136
|
-
MIT — fork, modify, distribute
|
|
356
|
+
[MIT](./LICENSE) — fork, modify, distribute.
|
|
137
357
|
|
|
138
358
|
## Author
|
|
139
359
|
|
|
@@ -143,4 +363,5 @@ Built by [Emin Azəroğlu](https://github.com/eminazeroglu) ([@azerogluemin_ai](
|
|
|
143
363
|
|
|
144
364
|
- [GitHub repo](https://github.com/eminazeroglu/ai-bootstrap)
|
|
145
365
|
- [Issues](https://github.com/eminazeroglu/ai-bootstrap/issues)
|
|
146
|
-
- [
|
|
366
|
+
- [Changelog](./CHANGELOG.md)
|
|
367
|
+
- [Security policy](https://github.com/eminazeroglu/ai-bootstrap/blob/main/SECURITY.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azerogluemin/ai-bootstrap",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.2",
|
|
4
4
|
"description": "Personal AI infrastructure bootstrap for Claude Code — interactive setup wizard with skills, agents, MCPs, and cross-project memory",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|