@bcelep/capint 0.6.5 → 0.7.0

package/AGENT.md

@@ -2,7 +2,7 @@
 
 CapInt is an IDE-native, capability-first orchestration engine.
 
-> **Maintainer repo:** read [HANDOFF.md](HANDOFF.md) first · dogfood: [docs/maintainer-dogfood.md](docs/maintainer-dogfood.md)
+> **Maintainer repo:** read [HANDOFF.md](HANDOFF.md) first · completed: [DONE.md](DONE.md) · dogfood: [docs/maintainer-dogfood.md](docs/maintainer-dogfood.md)
 
 ## Task contract
 

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.7.0 — 2026-05-30
+
+### Added
+- **Schema hub:** `execution-intent.v1.json`, `explanation.v2.json`, `ui-api.v1.json` + `scripts/generate-schema-docs.mjs`
+- **`capint skill audit`** — orphan/ghost/unreferenced/stale backup findings
+- **`capint feedback --summary`** — local `.capint/feedback/` aggregate
+- **i18n:** `locales/tr.json`, `locales/en.json`, `CAPINT_LOCALE`, `reason_plain` + tooltip on explanation
+- **Doctor actions** — structured recover/enable suggestions; UI `/api/recover` + one-click fix
+- **UI:** FAQ link, plain/technical plan card, micro-survey on step 4
+- **Tests:** `cli-ui-parity`, `skill-audit`, expanded Playwright recover flow
+- **Docs:** skill-audit runbook, beginner test protocol, survey template, community.md, **`docs/capint-rehber.md`**, **`docs/capint-stack.md`**, memory-graph pairing recipe
+- **`capint stack`** — unified 4-layer doctor/setup + `graph paths` / `graph sync` (workflows + routing + graphify + agentmemory)
+- **`capint providers doctor`** — tier 0–2 sidecar diagnostics (graphify, agentmemory, local context)
+- **`capint init --stack`** — post-init stack wiring + `.capint/stack.json` manifest
+- **Providers lib** — local memory/graph adapter stubs + activation policy
+
+### Changed
+- Init/scaffold copies `.capint/schemas/` from package
+- `validate-explanation` uses v2 schema (backward compatible)
+- Release-check: 38 steps (was 28)
+- Audit command merges skill audit findings
+- `GUNLUK.md` template — 4-layer stack summary; providers recipe points to capint-stack
+
 ## 0.6.5 — 2026-05-30
 
 ### Added

package/bin/capint.js

@@ -39,6 +39,10 @@ async function main() {
       return require("../src/commands/upgrade")(args.slice(1), flags);
     case "memory":
       return require("../src/commands/memory")(args.slice(1), flags);
+    case "providers":
+      return require("../src/commands/providers")(args.slice(1), flags);
+    case "stack":
+      return require("../src/commands/stack")(args.slice(1), flags);
     case "skill":
       return require("../src/commands/skill")(args.slice(1), flags);
     case "recover":
@@ -47,6 +51,8 @@ async function main() {
       return require("../src/commands/ui")(args.slice(1), flags);
     case "pipeline":
       return require("../src/commands/pipeline")(args.slice(1), flags);
+    case "feedback":
+      return require("../src/commands/feedback")(args.slice(1), flags);
     case "version":
     case "--version":
     case "-v":
@@ -80,17 +86,20 @@ Usage:
   capint doctor [--json]               diagnose drift (no auto-fix)
   capint audit [--json]                project + contract audit (read-only)
 
-  capint init [--preset minimal] [--bundle full|minimal] [--name Project] [--no-ide-sync] [--json]
+  capint init [--preset minimal] [--bundle full|minimal] [--name Project] [--no-ide-sync] [--stack] [--json]
+  capint stack doctor|setup|graph paths|graph sync [--json]   unified stack (docs/capint-stack.md)
   capint scaffold [--preset minimal|prismx-compatible] [--list] [--json]
 
   capint ide sync|check [--dry-run] [--json] [--targets cursor,claude,...]
   capint uninstall [--dry-run] [--yes] [--keep-agent] [--keep-ide] [--include-sidecars]
   capint upgrade [--dry-run] [--apply]
   capint recover [--list] [--latest] [--stamp <id>] [--apply]
-  capint skill list|disable|enable|pin [--json]
+  capint skill list|disable|enable|pin|audit [--json]
   capint ui [--port 3721] [--open] [--json]
   capint pipeline ["<task>"] [--json] [--skip-ide] [--force]
+  capint feedback --summary [--json]
   capint memory status [--json]
+  capint providers doctor [--json]   tier detail (prefer: capint stack doctor)
 
   capint version
 `);

package/docs/PRD-capint.md

@@ -0,0 +1,94 @@
+# PRD — CapInt (`@bcelep/capint`)
+
+**Status:** Active · **Baseline:** 0.7.0 · **Date:** 2026-05-30
+
+---
+
+## 1. Executive Summary
+
+**Problem:** IDE agentları skill adlarını ezberletmeden doğru capability seçemiyor; kurulum, routing, explainability ve recovery dağınık.
+
+**Solution:** CapInt — chat-first capability router: natural language → Execution Intent → `skills/*/SKILL.md` okuma → apply gate. CLI kaynak; `capint init` ile projeye bundle; `capint ui` ile terminal-siz onboarding.
+
+**Success (KPI):**
+
+| KPI | Target |
+|-----|--------|
+| `npm test` (release-check) | 34/34 |
+| Medium+ görevde skill okuma | Agent contract |
+| Workspace dışı yazma | 0 (override hariç) |
+| Beginner wizard tamamlama | ≥80% (protocol: n=3) |
+| Explainability clarity | ≥4/5 survey |
+| Broken config → green doctor | ≤2 dk (`capint recover`) |
+
+---
+
+## 2. Product Scope
+
+### In scope
+
+- `capint route` / `consult` — Execution Intent + `explanation` (plain + technical)
+- Init scaffold: matrix, registry, skills, `.capint/schemas/`
+- Adaptive confirm (`devam` / `plan` / `analiz`)
+- Skill health: `disable|enable|pin`, `skill audit`, `recover`
+- IDE sync: Cursor, Claude, Gemini, Antigravity
+- `capint ui` wizard + `/api/recover` + local feedback
+- i18n: `CAPINT_LOCALE`, TR/EN UI strings + `reason_plain`
+
+### Out of scope
+
+- Vector DB, autonomous agent swarm
+- Cursor global skill picker’a 115 skill kaydı
+- Hosted SaaS dashboard / external survey SaaS
+- PrismX meta-repo (ayrı hatt)
+
+---
+
+## 3. User Stories (özet)
+
+| ID | Story | Durum |
+|----|-------|-------|
+| US-1–10 | Core routing, boundary, bundle, explain, recover | ✅ 0.6.x |
+| US-11 | CLI/UI parity via shared contract + harness | ✅ 0.7.0 |
+| US-12 | Skill audit / orphan detection | ✅ 0.7.0 |
+| US-13 | Plain + technical explanation + i18n | ✅ 0.7.0 |
+| US-14 | Beginner doctor one-click recover (UI) | ✅ 0.7.0 |
+| US-15 | Local micro-survey + n=3 protocol | ✅ docs + API |
+
+---
+
+## 4. Technical Architecture
+
+```
+User chat / capint ui
+        ↓
+capint route (shared route-engine)
+        ↓
+schemas/ · skill-routing-matrix.json · registry.json
+        ↓
+doctor · skill audit · recover · feedback (local)
+```
+
+**Canonical artifacts:** `schemas/*.json`, `docs/generated/`, `locales/tr|en.json`
+
+---
+
+## 5. Roadmap
+
+**Shipped (0.7.0):** schema hub, cli-ui-parity tests, explanation v2, skill audit, doctor actions, UI recover, feedback API, i18n
+
+**Backlog (0.7.1+):**
+
+- `skill audit --archive` (apply moves)
+- Beginner n=3 moderated sessions (manual KPI)
+- CI GitHub Actions template
+- Maintainer `dogfood-setup` script
+
+---
+
+## 6. References
+
+- Detay spec: [PRD-v0.5-agent-capability-activation.md](PRD-v0.5-agent-capability-activation.md)
+- Contract: [execution-intent-contract.md](execution-intent-contract.md)
+- Skill audit: [skill-audit-runbook.md](skill-audit-runbook.md)
+- Eval: [eval/beginner-test-protocol.md](eval/beginner-test-protocol.md)

package/docs/PRD-v0.5-agent-capability-activation.md

@@ -3,7 +3,7 @@
 **Status:** Draft v2 (review incorporated)  
 **Author:** CapInt route → `spec-authoring` / `prd`  
 **Date:** 2026-05-30  
-**Package baseline:** `@bcelep/capint@0.6.5`  
+**Package baseline:** `@bcelep/capint@0.7.0`  
 **Changelog:** v2 — dual-segment UX, explainability, skill lifecycle, CLI power-user, capint-ui prototype spec
 
 ---
@@ -383,6 +383,15 @@ capint route --json "prd hazırla" | ConvertFrom-Json | Select-Object -ExpandPro
 - [x] Registry validator + consult/status smokes  
 - [ ] Beginner moderated test (n=3) — manual KPI backlog  
 
+**v0.7.0 — UX & contract parity**  
+- [x] Schema hub (`execution-intent`, `explanation.v2`, `ui-api`) + generated docs  
+- [x] CLI/UI parity harness + expanded release-check (34 steps)  
+- [x] `reason_plain` + tooltip + `CAPINT_LOCALE` (TR/EN)  
+- [x] `capint skill audit` + runbook  
+- [x] Doctor `actions[]` + UI `/api/recover` one-click fix  
+- [x] Local `/api/feedback` + `capint feedback --summary`  
+- [ ] Beginner moderated test (n=3) — execute per [eval/beginner-test-protocol.md](eval/beginner-test-protocol.md)
+
 ### Technical Risks (extended)
 
 | Risk | Mitigation |

package/docs/architecture-decisions.md

@@ -91,5 +91,7 @@ Default: off. Does not block route hot-path when disabled.
 | obra/superpowers | evidence-before-claims | full subagent army on light tasks |
 | msitarzewski/agency-agents | convert/install UX | 144 persona default bundle |
 | MemPalace / agentmemory / graphify | adapter contracts | core embedding, hooks, MCP surfaces |
+
+Pairing recipe: [docs/recipes/memory-graph-pairing.md](recipes/memory-graph-pairing.md) · Diagnostic: `capint providers doctor`
 | giancarloerra/SocratiCode | provider boundary | AGPL docker stack in core |
 | revfactory/harness | orchestration patterns reference | team factory in router core |

package/docs/capint-rehber.md

@@ -0,0 +1,439 @@
+# CapInt ve Yan Eklentiler — Nedir, Ne İşe Yarar, Nasıl Kurulur
+
+> Bu rehber teknik olmayan bir geliştirici için yazıldı.  
+> Amaç: **CapInt**, **agentmemory** (hafıza) ve **graphify** (harita) ne, neden var, nasıl takılır — net cevap.
+
+**İlgili:** [capint-stack.md](capint-stack.md) · [kullanim-kilavuzu.md](kullanim-kilavuzu.md)
+
+---
+
+## İçindekiler
+
+1. [Büyük resim](#1-büyük-resim)
+2. [CapInt nedir?](#2-capint-nedir)
+3. [CapInt ne işe yarar?](#3-capint-ne-işe-yarar)
+4. [CapInt nasıl kurulur?](#4-capint-nasıl-kurulur)
+5. [CapInt günlük nasıl kullanılır?](#5-capint-günlük-nasıl-kullanılır)
+6. [agentmemory — hafıza eklentisi](#6-agentmemory--hafıza-eklentisi)
+7. [graphify — kod haritası eklentisi](#7-graphify--kod-haritası-eklentisi)
+8. [Üçü birlikte nasıl çalışır?](#8-üçü-birlikte-nasıl-çalışır)
+9. [Yeni proje kontrol listesi](#9-yeni-proje-kontrol-listesi)
+10. [Ne zaman neyi yenilersin?](#10-ne-zaman-neyi-yenilersin)
+11. [Sık sorulan sorular](#11-sık-sorulan-sorular)
+12. [Basit sorun giderme](#12-basit-sorun-giderme)
+
+---
+
+## 1. Büyük resim
+
+Cursor'daki yapay zekâ güçlü ama **her oturumda sıfırdan başlıyormuş gibi** davranabilir. CapInt bunu düzeltmeye çalışır.
+
+Üç parça var:
+
+| Parça | Tek cümle | Kurulum |
+|-------|-----------|---------|
+| **CapInt** | Projeye "AI nasıl çalışsın" kurallarını koyar | **Her proje** için bir kez |
+| **agentmemory** | Geçmiş konuşmaları hatırlatır | **Bilgisayarda** bir kez |
+| **graphify** | Projenin dosya haritasını çıkarır | Program bir kez, **harita her proje** için bir kez |
+
+**CapInt tek başına yeterli mi?**  
+Evet — günlük geliştirme için CapInt + proje notları (`HANDOFF`, `DONE`) çoğu işi görür.
+
+**agentmemory + graphify şart mı?**  
+Hayır. Ama eklediğinde AI daha az "unutkan" olur ve projeyi daha iyi tanır.
+
+---
+
+## 2. CapInt nedir?
+
+CapInt bir **uygulama değil**. npm paketi olarak gelen, projene kopyalanan **kural ve rehber seti**.
+
+Kurduğunda projene şunlar gelir:
+
+| Dosya / klasör | Ne işe yarar |
+|----------------|--------------|
+| `GUNLUK.md` | "Bugün chat'te nasıl konuşurum" — günlük giriş noktan |
+| `HANDOFF.md` | "Dün ne yapıyorduk, sırada ne var" |
+| `DONE.md` | "Ne bitti" — tekrar yapılmasın diye |
+| `design.md` | Projenin amacı, sınırları, kararlar |
+| `AGENT.md` | AI'ya genel davranış kuralları |
+| `workflows/` | Büyük işler için hazır sohbet akışları |
+| `skills/` | Belirli iş türleri için uzman modları |
+| `skill-routing-matrix.json` | "Bu iş hangi uzman moduna gitsin" tablosu |
+
+**CapInt kod yazmaz.** Cursor'daki AI'ya *nasıl davranacağını* söyler.
+
+---
+
+## 3. CapInt ne işe yarar?
+
+### 3.1 Oturumlar arası devamlılık
+
+AI her seferinde "projeyi ilk kez görüyorum" moduna girmesin diye `HANDOFF.md` ve `DONE.md` kullanırsın. Oturum kapanırken agent bunları günceller; yeni oturumda okur.
+
+### 3.2 İş büyüklüğüne göre davranış
+
+- Küçük iş (renk, typo, tek dosya) → direkt yap
+- Orta/büyük iş (yeni özellik, refactor) → önce kısa plan, onay, sonra kod
+
+Bunu her seferinde sen söylemek zorunda kalmazsın; CapInt kuralları bunu AI'ya öğretir.
+
+### 3.3 Büyük işlerde dağılmama
+
+Büyük işler için chat'te kullanılan hazır akışlar:
+
+| Kısayol | Ne zaman | Ne yapar |
+|---------|----------|----------|
+| `/genesis` | Sıfırdan veya büyük yeniden tasarım | Önce ne istediğini netleştirir, doküman çıkarır |
+| `/blueprint` | Tasarım belli, iş listesi lazım | Görevleri parçalar |
+| `/challenge` | Kodlamadan önce | Planı sorgular, riskleri sorar |
+| `/forge` | Uygulama | Dikkatli kodlar; bozulan şeyleri geri almaya odaklanır |
+
+Bunlar terminal komutu değil — **Cursor chat'e yazdığın kelimeler**.
+
+### 3.4 Doğru "uzman modu" seçimi
+
+"SEO audit", "güvenlik", "PR yaz" gibi işler farklı beceriler ister. CapInt hangi skill'in devreye gireceğini seçer; sen isim ezberlemezsin.
+
+---
+
+## 4. CapInt nasıl kurulur?
+
+### 4.1 Gereksinim
+
+- Node.js 18+ (bilgisayarda bir kez)
+- Cursor IDE
+- Proje klasörün (ör. `efesusstone`)
+
+### 4.2 Proje klasöründe kurulum
+
+Terminali proje kökünde aç:
+
+```powershell
+cd C:\bc-proje\senin-projen
+npx @bcelep/capint init --bundle full --stack
+```
+
+**Ne olur?**
+
+- CapInt dosyaları projene kopyalanır
+- `--stack` ile graphify için proje kuralı da hazırlanmaya çalışılır
+- Mevcut dosyaların üzerine körlemesine yazılmaz (çakışma varsa atlar)
+
+### 4.3 Kurulumdan sonra
+
+1. `GUNLUK.md` dosyasını aç — günlük kullanım buradan
+2. Cursor chat'e geç — artık asıl iş chat'te
+3. İsteğe bağlı: `capint stack doctor` ile "her şey tamam mı" bak (tek satır özet)
+
+**CapInt'i her proje için ayrı kurarsın** — çünkü kurallar ve notlar o projeye özel.
+
+---
+
+## 5. CapInt günlük nasıl kullanılır?
+
+### 5.1 Tipik bir gün
+
+1. Cursor'u aç, projeyi aç
+2. Chat'e Türkçe yaz: *"Dünkü ödeme sayfasına devam edelim"* veya *"header'daki logoyu büyüt"*
+3. Agent kısa bir özet gösterir (Intent / ne yapacağı / onay gerekip gerekmediği)
+4. Hafif işse direkt yapar; büyük işse `devam` / `plan` / `analiz` dersin
+5. Bitince: *"kapan"* veya *"HANDOFF güncelle"* — agent `DONE.md` ve `HANDOFF.md` yazar
+
+### 5.2 Terminal ne zaman?
+
+| Durum | Terminal |
+|-------|----------|
+| Günlük geliştirme | **Gerek yok** — chat yeter |
+| Yeni proje | Bir kez `capint init` |
+| "Her şey tamam mı?" | `capint stack doctor` |
+| Sorun var | `capint doctor` |
+
+### 5.3 Senin yapman gereken alışkanlıklar
+
+- Oturum sonunda HANDOFF'u güncel tut (agent'a bırakabilirsin)
+- Büyük işe `/blueprint` veya `/forge` ile gir
+- Küçük işte gereksiz süreç açma — normal konuş
+
+---
+
+## 6. agentmemory — hafıza eklentisi
+
+### 6.1 Nedir?
+
+**agentmemory**, AI'nın **geçmiş konuşmaları** hatırlamasına yardım eden ayrı bir program. CapInt'in içinde değil; bilgisayarında arka planda çalışan bir **hafıza servisi**.
+
+### 6.2 Ne işe yarar?
+
+| CapInt notları (`HANDOFF`) | agentmemory |
+|----------------------------|-------------|
+| Senin yazdığın / agent'ın özetlediği **proje notları** | **Chat geçmişi** ve oturumlar arası bağlam |
+| "Sırada ne var?" | "Geçen hafta ne konuştuk?" |
+
+İkisi birbirinin yerine geçmez; **birlikte** daha iyi olur.
+
+### 6.3 Nasıl eklenir? (bilgisayarda bir kez)
+
+**Adım 1 — Programı kur**
+
+```powershell
+npm install -g @agentmemory/agentmemory
+```
+
+Windows'ta ayrıca `iii-engine` gerekir (agentmemory'nin arka plan motoru). Kurulu değilse [agentmemory dokümantasyonuna](https://github.com/rohitg00/agentmemory) bak.
+
+**Adım 2 — Cursor'a bağla**
+
+Cursor'un MCP ayarına agentmemory eklenir. Windows'ta bazen otomatik bağlantı çalışmaz; o zaman `~/.cursor/mcp.json` içine agentmemory bloğu elle eklenir.
+
+**Adım 3 — Çalıştır**
+
+Ayrı bir terminal penceresinde (bilgisayar açıkken):
+
+```powershell
+agentmemory
+```
+
+Bu pencere açık kalsın veya arka planda servis olarak çalışsın.
+
+### 6.4 Her proje için ayrı mı?
+
+**Hayır.**
+
+- Program: bilgisayarda **bir kez**
+- Cursor bağlantısı: **bir kez**
+- Her yeni proje: agentmemory'yi **tekrar kurmazsın**
+
+Tüm projeler aynı hafıza servisini kullanır.
+
+### 6.5 Kurduktan sonra proje başına ne yaparsın?
+
+**Pratikte hiçbir şey.**  
+Cursor açık + agentmemory çalışıyorsa hafıza devreye girer. CapInt init vs. tekrar gerekmez.
+
+### 6.6 Çalışıyor mu nasıl anlarsın?
+
+- Cursor'da agent geçmişe daha iyi atıf yapıyorsa
+- veya `capint stack doctor` içinde memory satırı `ok` ise
+
+Kapalıysa: `agentmemory` terminalini tekrar aç.
+
+---
+
+## 7. graphify — kod haritası eklentisi
+
+### 7.1 Nedir?
+
+**graphify**, projenin **kod haritasını** çıkaran ayrı bir araç. "Hangi klasör ne işe yarıyor, dosyalar nasıl bağlı" sorusuna cevap üretir. CapInt'in içinde değil.
+
+### 7.2 Ne işe yarar?
+
+AI büyük projede kaybolmasın diye:
+
+- `GRAPH_REPORT.md` — okunabilir özet rapor
+- `graph.json` — yapısal harita (CapInt `.capint/graph/` altında okur)
+
+Özellikle Next.js gibi `app/`, `lib/`, `components/` yapısında "`/src` yok" projelerde faydalı.
+
+### 7.3 Nasıl eklenir?
+
+#### Bilgisayarda bir kez (program)
+
+```powershell
+uv tool install graphifyy
+graphify install cursor
+```
+
+`uv` yoksa önce Python/uv kurulumu gerekir — graphify dokümantasyonuna bak.
+
+#### Her proje için bir kez (harita)
+
+**Adım 1 — CapInt zaten kurulu olsun**
+
+```powershell
+capint init --bundle full --stack
+```
+
+(`--stack` proje içinde graphify Cursor kuralını eklemeye çalışır.)
+
+**Adım 2 — Cursor chat'te haritayı çıkar**
+
+Proje yapına göre. Örnekler:
+
+- Klasik proje (`src/` var):
+
+  ```
+  /graphify ./src
+  ```
+
+- Next.js (src yok):
+
+  ```
+  /graphify ./app ./lib ./components
+  ```
+
+Hangi klasörler? Terminalde:
+
+```powershell
+capint stack graph paths
+```
+
+**Adım 3 — Haritayı CapInt yoluna kopyala**
+
+graphify çıktıyı `graphify-out/` klasörüne yazar. CapInt'in okuması için:
+
+```powershell
+capint stack graph sync
+```
+
+Bu komut şunları oluşturur/günceller:
+
+- `GRAPH_REPORT.md` (proje kökü)
+- `.capint/graph/graph.json`
+
+### 7.4 Her proje için ayrı mı?
+
+| Ne | Sıklık |
+|----|--------|
+| graphify programı | Bilgisayarda **bir kez** |
+| Cursor genel kuralı | **Bir kez** |
+| Proje içi graphify kuralı | **Her proje** (`init --stack` veya `graphify install cursor --project`) |
+| **Haritanın kendisi** | **Her proje bir kez** (+ büyük değişiklikte yenile) |
+
+### 7.5 Ne zaman haritayı yenilersin?
+
+- Yeni büyük modül ekledin
+- Klasör yapısını değiştirdin
+- AI sürekli yanlış dosyaya gidiyorsa
+
+Her gün değil — **proje şekli değişince**.
+
+Chat'te güncelleme:
+
+```
+/graphify ./app ./lib ./components --update
+```
+
+Sonra yine:
+
+```powershell
+capint stack graph sync
+```
+
+---
+
+## 8. Üçü birlikte nasıl çalışır?
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  SEN — Cursor chat (Türkçe, doğal dil)                  │
+└───────────────────────────┬─────────────────────────────┘
+                            │
+        ┌───────────────────┼───────────────────┐
+        ▼                   ▼                   ▼
+   ┌─────────┐        ┌───────────┐       ┌────────────┐
+   │ CapInt  │        │ graphify  │       │ agentmemory│
+   │ kurallar│        │ kod haritas│      │ chat hafızası│
+   │ HANDOFF │        │ graph.json │      │ (arka plan) │
+   │ workflows│       └───────────┘       └────────────┘
+   └─────────┘
+        │
+        ▼
+   AI: doğru mod, plan, devamlılık, proje bilgisi
+```
+
+| Soru | Cevap veren |
+|------|-------------|
+| Nasıl davranayım? | CapInt (`AGENT`, `GUNLUK`, workflows) |
+| Sırada ne var? | `HANDOFF.md`, `DONE.md` |
+| Proje dosyaları nerede? | graphify haritası |
+| Geçen konuşmada ne dedik? | agentmemory |
+
+---
+
+## 9. Yeni proje kontrol listesi
+
+### Bilgisayarda (bir kez — zaten yaptıysan atla)
+
+- [ ] Node.js kurulu
+- [ ] `npm install -g @agentmemory/agentmemory` + Cursor MCP
+- [ ] `uv tool install graphifyy` + `graphify install cursor`
+- [ ] agentmemory arka planda çalışıyor
+
+### Her yeni proje
+
+- [ ] `cd proje-klasörü`
+- [ ] `npx @bcelep/capint init --bundle full --stack`
+- [ ] `GUNLUK.md` oku
+- [ ] Cursor chat: `/graphify …` (doğru klasörlerle)
+- [ ] `capint stack graph sync`
+- [ ] `capint stack doctor` — dört katman yeşil mi bak
+- [ ] Normal geliştirmeye chat ile devam
+
+---
+
+## 10. Ne zaman neyi yenilersin?
+
+| Parça | Ne zaman |
+|-------|----------|
+| CapInt paketi | Yeni sürüm çıktığında (`capint upgrade` — nadiren) |
+| HANDOFF / DONE | **Her oturum sonu** |
+| agentmemory | Bilgisayar restart sonrası servisi tekrar aç |
+| graphify haritası | Proje yapısı ciddi değişince |
+| CapInt init | **Sadece yeni proje** — mevcut projede tekrar init genelde gerekmez |
+
+---
+
+## 11. Sık sorulan sorular
+
+### CapInt olmadan Cursor kullanamaz mıyım?
+
+Kullanırsın. CapInt sadece **düzen ve devamlılık** ekler.
+
+### agentmemory olmadan CapInt işe yarar mı?
+
+Evet. HANDOFF/DONE ile devam edersin; agentmemory ekstra chat hafızası.
+
+### graphify olmadan?
+
+Evet. Küçük projelerde AI dosyaları kendisi bulur; büyük projede harita çok işe yarar.
+
+### Her gün terminal açmam gerekir mi?
+
+Hayır. Günlük iş **chat**. Terminal: init, harita sync, doctor.
+
+### efesusstone için ne durumda?
+
+CapInt init + harita daha önce yapıldıysa **ekstra kurulum yok**. agentmemory kapalıysa sadece servisi aç. Proje çok değiştiyse haritayı yenile.
+
+### `.prismx/` klasörü lazım mı?
+
+**Hayır.** CapInt kök dosyaları kullanır: `HANDOFF.md`, `design.md`, `.capint/graph/`. `.prismx/` senin akışında yok.
+
+---
+
+## 12. Basit sorun giderme
+
+| Belirti | Muhtemel sebep | Ne yap |
+|---------|----------------|--------|
+| AI her seferinde sıfırdan | HANDOFF güncel değil | Oturum sonu "HANDOFF güncelle" |
+| `/graphify` hiçbir şey yapmıyor | Yanlış klasör veya kural yok | `capint stack graph paths` · `init --stack` |
+| Harita var ama CapInt görmüyor | Sync yapılmamış | `capint stack graph sync` |
+| Hafıza yok gibi | agentmemory kapalı | `agentmemory` terminalini aç |
+| Büyük iş dağıldı | Direkt kod yazdırıldı | `/blueprint` → `/challenge` → `/forge` |
+
+---
+
+## Özet tablo
+
+| | CapInt | agentmemory | graphify |
+|---|--------|-------------|----------|
+| **Nedir** | AI kural seti | Chat hafıza servisi | Kod haritası aracı |
+| **Kurulum** | Her proje | Bilgisayar 1× | Program 1×, harita proje 1× |
+| **Günlük** | Chat + HANDOFF | Arka planda açık | Nadiren yenile |
+| **CapInt'e dahil mi?** | Evet | Hayır | Hayır |
+| **Şart mı?** | Ana sistem | İsteğe bağlı | İsteğe bağlı |
+
+---
+
+*CapInt paketi: `@bcelep/capint` · Stack özeti: [capint-stack.md](capint-stack.md)*