@bcelep/capint 0.4.2 → 0.6.5

package/src/lib/scaffold/presets.js

@@ -2,8 +2,50 @@ const fs = require("fs");
 const path = require("path");
 const { applyFilePolicy } = require("./file-policy");
 
+const CORE_SKILL_NAMES = ["capability-router", "prismx-skill-gateway", "task-skill-router"];
+
+/** CI / lightweight init — matrix task types still resolve when skills present */
+const MINIMAL_BUNDLE_SKILLS = [
+  "capability-router",
+  "context-memory-bridge",
+  "localization-hub",
+  "refactor",
+  "systematic-debugging"
+];
+
+const MINIMAL_BUNDLE_WORKFLOWS = ["forge.md"];
+
+const BUNDLE_MODES = new Set(["full", "minimal"]);
+
+const TEXT_EXTENSIONS = new Set([
+  ".md",
+  ".json",
+  ".yaml",
+  ".yml",
+  ".txt",
+  ".js",
+  ".mjs",
+  ".cjs",
+  ".ts",
+  ".tsx",
+  ".jsx",
+  ".css",
+  ".html",
+  ".htm",
+  ".svg",
+  ".xml",
+  ".toml",
+  ".sh",
+  ".ps1",
+  ".csv"
+]);
+
+function pkgRoot() {
+  return path.join(__dirname, "..", "..", "..");
+}
+
 function loadTemplate(name) {
-  const tplDir = path.join(__dirname, "..", "..", "..", "templates", name);
+  const tplDir = path.join(pkgRoot(), "templates", name);
   const files = {};
   if (!fs.existsSync(tplDir)) return files;
   for (const rel of walk(tplDir)) {
@@ -31,38 +73,108 @@ function interpolate(content, vars) {
   return out;
 }
 
-function deriveRegistryFromMatrix(matrix) {
-  const core = new Set(["capability-router"]);
+function listPackageSkillNames(root = pkgRoot()) {
+  const skillsDir = path.join(root, "skills");
+  if (!fs.existsSync(skillsDir)) return [];
+  return fs
+    .readdirSync(skillsDir)
+    .filter((name) => fs.existsSync(path.join(skillsDir, name, "SKILL.md")))
+    .sort();
+}
+
+function isTextBundleFile(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return !ext || TEXT_EXTENSIONS.has(ext);
+}
+
+function copyBinaryBundleFile({ rootDir, relativePath, srcAbs, force }) {
+  const abs = path.join(rootDir, relativePath);
+  const dir = path.dirname(abs);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+  if (!fs.existsSync(abs)) {
+    fs.copyFileSync(srcAbs, abs);
+    return { path: relativePath, action: "created" };
+  }
+
+  if (force) {
+    fs.copyFileSync(srcAbs, abs);
+    return { path: relativePath, action: "updated", mode: "force" };
+  }
+
+  const existing = fs.readFileSync(abs);
+  const incoming = fs.readFileSync(srcAbs);
+  if (existing.equals(incoming)) {
+    return { path: relativePath, action: "skipped", reason: "identical" };
+  }
+
+  const sidecar = `${relativePath}.capint.new`;
+  fs.copyFileSync(srcAbs, path.join(rootDir, sidecar));
+  return { path: relativePath, action: "conflict", sidecar };
+}
+
+function listProjectSkillNames(rootDir) {
+  return listPackageSkillNames(rootDir);
+}
+
+function resolveBundleSkillNames(bundle, packageRoot = pkgRoot()) {
+  if (bundle === "minimal") {
+    return MINIMAL_BUNDLE_SKILLS.filter((name) =>
+      fs.existsSync(path.join(packageRoot, "skills", name, "SKILL.md"))
+    );
+  }
+  return listPackageSkillNames(packageRoot);
+}
+
+function normalizeBundleMode(mode) {
+  const m = (mode || "full").toLowerCase();
+  if (!BUNDLE_MODES.has(m)) return null;
+  return m;
+}
+
+function deriveRegistryFromMatrix(matrix, packageRoot = pkgRoot(), options = {}) {
+  const onDisk = new Set(options.skillNames || listPackageSkillNames(packageRoot));
+  const core = new Set();
   const recommended = new Set();
 
+  for (const name of CORE_SKILL_NAMES) {
+    if (onDisk.has(name)) core.add(name);
+  }
+  if (!core.size) core.add("capability-router");
+
   for (const tt of matrix?.task_types || []) {
     for (const s of tt.skills || []) {
-      if (s === "capability-router") core.add(s);
-      else recommended.add(s);
+      if (core.has(s)) continue;
+      if (onDisk.has(s)) recommended.add(s);
     }
   }
   for (const meta of Object.values(matrix?.rules_domain_map || {})) {
     for (const s of meta.skills || []) {
-      if (s === "capability-router") core.add(s);
-      else recommended.add(s);
+      if (core.has(s)) continue;
+      if (onDisk.has(s)) recommended.add(s);
     }
   }
-  recommended.delete("capability-router");
+
+  for (const name of core) recommended.delete(name);
+
+  const optional = [...onDisk].filter((name) => !core.has(name) && !recommended.has(name));
 
   return {
-    schema_version: "1.0",
+    schema_version: "1.1",
     core: [...core].sort(),
     recommended: [...recommended].sort(),
-    optional: [],
+    optional,
     project_added: []
   };
 }
 
-function getPresetFiles(preset, vars = {}) {
-  const pkgRoot = path.join(__dirname, "..", "..", "..");
-  const matrixRaw = fs.readFileSync(path.join(pkgRoot, "skill-routing-matrix.json"), "utf-8");
+function getPresetFiles(preset, vars = {}, options = {}) {
+  const root = pkgRoot();
+  const bundle = normalizeBundleMode(options.bundle) || "full";
+  const matrixRaw = fs.readFileSync(path.join(root, "skill-routing-matrix.json"), "utf-8");
   const matrix = JSON.parse(matrixRaw);
-  const registryJson = `${JSON.stringify(deriveRegistryFromMatrix(matrix), null, 2)}\n`;
+  const skillNames = resolveBundleSkillNames(bundle, root);
+  const registryJson = `${JSON.stringify(deriveRegistryFromMatrix(matrix, root, { skillNames }), null, 2)}\n`;
   const routingBundle = {
     "skill-routing-matrix.json": matrixRaw,
     "registry.json": registryJson
@@ -85,34 +197,77 @@ function getPresetFiles(preset, vars = {}) {
   return files;
 }
 
-function copyBundle({ rootDir, force = false }) {
-  const bundleDir = path.join(__dirname, "..", "..", "..", "templates", "bundle");
+function copyBundleTree({ rootDir, srcDir, prefix, force = false }) {
   const results = [];
-  if (!fs.existsSync(bundleDir)) return results;
-
-  for (const rel of walk(bundleDir)) {
-    const relNorm = rel.replace(/\\/g, "/");
-    const content = fs.readFileSync(path.join(bundleDir, rel), "utf-8");
-    results.push(
-      applyFilePolicy({
-        rootDir,
-        relativePath: relNorm,
-        content,
-        force
-      })
-    );
+  if (!fs.existsSync(srcDir)) return results;
+
+  for (const rel of walk(srcDir)) {
+    const relNorm = `${prefix}/${rel}`.replace(/\\/g, "/");
+    const srcAbs = path.join(srcDir, rel);
+    if (isTextBundleFile(srcAbs)) {
+      const content = fs.readFileSync(srcAbs, "utf-8");
+      results.push(
+        applyFilePolicy({
+          rootDir,
+          relativePath: relNorm,
+          content,
+          force
+        })
+      );
+    } else {
+      results.push(copyBinaryBundleFile({ rootDir, relativePath: relNorm, srcAbs, force }));
+    }
   }
   return results;
 }
 
+/** Copy skills/ + workflows/ into the target project (`full` default, `minimal` for CI). */
+function copyBundle({ rootDir, force = false, bundle = "full" }) {
+  const root = pkgRoot();
+  const mode = normalizeBundleMode(bundle) || "full";
+
+  if (mode === "minimal") {
+    const results = [];
+    for (const name of MINIMAL_BUNDLE_SKILLS) {
+      const srcDir = path.join(root, "skills", name);
+      if (!fs.existsSync(srcDir)) continue;
+      results.push(
+        ...copyBundleTree({ rootDir, srcDir, prefix: `skills/${name}`, force })
+      );
+    }
+    for (const wf of MINIMAL_BUNDLE_WORKFLOWS) {
+      const srcAbs = path.join(root, "workflows", wf);
+      if (!fs.existsSync(srcAbs)) continue;
+      results.push(
+        applyFilePolicy({
+          rootDir,
+          relativePath: `workflows/${wf}`,
+          content: fs.readFileSync(srcAbs, "utf-8"),
+          force
+        })
+      );
+    }
+    return results;
+  }
+
+  return [
+    ...copyBundleTree({ rootDir, srcDir: path.join(root, "skills"), prefix: "skills", force }),
+    ...copyBundleTree({ rootDir, srcDir: path.join(root, "workflows"), prefix: "workflows", force })
+  ];
+}
+
 const PRESET_MANIFEST = {
   minimal: {
     id: "minimal",
-    description: "AGENT.md, design.md, rules, matrix, registry, skill bundle",
+    description: "AGENT.md, design.md, rules, matrix, registry, skill bundle (full or --bundle minimal)",
     files: [
+      "GUNLUK.md",
       "AGENT.md",
       "AGENTS.md",
       "design.md",
+      "docs/kullanim-kilavuzu.md",
+      "docs/conventions/daily-use.md",
+      "docs/conventions/task-to-capability-cheatsheet.md",
       ".capint/rules/core.md",
       ".gitignore",
       "skill-routing-matrix.json",
@@ -129,4 +284,18 @@ const PRESET_MANIFEST = {
   }
 };
 
-module.exports = { getPresetFiles, PRESET_MANIFEST, interpolate, deriveRegistryFromMatrix, copyBundle };
+module.exports = {
+  getPresetFiles,
+  PRESET_MANIFEST,
+  interpolate,
+  deriveRegistryFromMatrix,
+  copyBundle,
+  listPackageSkillNames,
+  listProjectSkillNames,
+  resolveBundleSkillNames,
+  normalizeBundleMode,
+  MINIMAL_BUNDLE_SKILLS,
+  MINIMAL_BUNDLE_WORKFLOWS,
+  BUNDLE_MODES,
+  pkgRoot
+};

package/src/lib/ui-server.js

@@ -0,0 +1,139 @@
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { URL } = require("url");
+const { routeTask, formatTextReport } = require("./route-engine");
+const { runDoctor, runStatus } = require("./doctor");
+
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml"
+};
+
+function pkgUiDir() {
+  return path.join(__dirname, "..", "..", "ui");
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => {
+      try {
+        const raw = Buffer.concat(chunks).toString("utf-8");
+        resolve(raw ? JSON.parse(raw) : {});
+      } catch (e) {
+        reject(e);
+      }
+    });
+    req.on("error", reject);
+  });
+}
+
+function json(res, status, data) {
+  const body = JSON.stringify(data);
+  res.writeHead(status, {
+    "Content-Type": "application/json; charset=utf-8",
+    "Content-Length": Buffer.byteLength(body)
+  });
+  res.end(body);
+}
+
+function projectHealth(rootDir) {
+  const doctor = runDoctor(rootDir);
+  const status = runStatus(rootDir);
+  return {
+    ok: doctor.pass,
+    doctor,
+    status: {
+      skills_on_disk: status.skills_on_disk,
+      core_skills: status.core_skills,
+      matrix_version: status.matrix_version,
+      capint_package: status.capint_package
+    }
+  };
+}
+
+function buildChatCopy(result) {
+  if (result.error) return result.error;
+  const ei = result.execution_intent;
+  const lines = [
+    `Intent: ${ei.intent}`,
+    `Capability: ${ei.capability}`,
+    `Resolution: ${ei.resolution}`,
+    `Resolution status: ${ei.resolution_status || "installed"}`,
+    `Memory: ${ei.memory}`,
+    `Plan: ${ei.plan}`
+  ];
+  if (ei.confirm?.enabled) {
+    const opts = (ei.confirm_options || []).map((o) => o.id).join(" | ");
+    lines.push(`Confirm: ${opts} (default: ${ei.confirm_default_option})`);
+  }
+  if (ei.explanation?.files_to_read?.length) {
+    lines.push("Read first:");
+    for (const f of ei.explanation.files_to_read) lines.push(`- ${f}`);
+  }
+  return lines.join("\n");
+}
+
+function createUiServer({ rootDir, uiDir = pkgUiDir(), port = 3721, host = "127.0.0.1" }) {
+  const server = http.createServer(async (req, res) => {
+    const url = new URL(req.url, `http://${host}:${port}`);
+    const pathname = url.pathname;
+
+    if (req.method === "GET" && pathname === "/api/health") {
+      return json(res, 200, projectHealth(rootDir));
+    }
+
+    if (req.method === "POST" && pathname === "/api/route") {
+      try {
+        const body = await readBody(req);
+        const task = String(body.task || "").trim();
+        if (!task) return json(res, 400, { error: "task required" });
+        const result = routeTask(task, rootDir);
+        if (result.error) return json(res, 400, { error: result.error });
+        return json(res, 200, {
+          result,
+          text_report: formatTextReport(result),
+          chat_copy: buildChatCopy(result)
+        });
+      } catch (e) {
+        return json(res, 400, { error: e.message });
+      }
+    }
+
+    let filePath = pathname === "/" ? "/index.html" : pathname;
+    filePath = path.normalize(filePath).replace(/^(\.\.[/\\])+/, "");
+    const abs = path.join(uiDir, filePath);
+    if (!abs.startsWith(path.resolve(uiDir))) {
+      res.writeHead(403);
+      return res.end("Forbidden");
+    }
+    if (!fs.existsSync(abs) || fs.statSync(abs).isDirectory()) {
+      res.writeHead(404);
+      return res.end("Not found");
+    }
+    const ext = path.extname(abs);
+    const data = fs.readFileSync(abs);
+    res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
+    res.end(data);
+  });
+
+  return {
+    server,
+    listen: () =>
+      new Promise((resolve, reject) => {
+        server.listen(port, host, () => resolve({ host, port, url: `http://${host}:${port}/` }));
+        server.on("error", reject);
+      }),
+    close: () =>
+      new Promise((resolve) => {
+        server.close(() => resolve());
+      })
+  };
+}
+
+module.exports = { createUiServer, projectHealth, buildChatCopy, pkgUiDir };

package/src/lib/upgrade-matrix.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const path = require("path");
+const { deriveRegistryFromMatrix, copyBundle, listPackageSkillNames, pkgRoot } = require("./scaffold/presets");
 
 function loadJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, "utf-8"));
@@ -106,7 +107,7 @@ function planUpgrade(rootDir, packageRoot) {
   };
 }
 
-function applyUpgrade(rootDir, merged) {
+function applyUpgrade(rootDir, merged, packageRoot = pkgRoot()) {
   const projectPath = path.join(rootDir, "skill-routing-matrix.json");
   const backupDir = path.join(rootDir, ".capint", "backups");
   fs.mkdirSync(backupDir, { recursive: true });
@@ -114,6 +115,20 @@ function applyUpgrade(rootDir, merged) {
   const backupPath = path.join(backupDir, `skill-routing-matrix.${stamp}.json`);
   fs.copyFileSync(projectPath, backupPath);
   fs.writeFileSync(projectPath, `${JSON.stringify(merged, null, 2)}\n`, "utf-8");
+
+  const registryPath = path.join(rootDir, "registry.json");
+  if (fs.existsSync(registryPath)) {
+    const registryBackup = path.join(backupDir, `registry.${stamp}.json`);
+    fs.copyFileSync(registryPath, registryBackup);
+  }
+  fs.writeFileSync(
+    registryPath,
+    `${JSON.stringify(deriveRegistryFromMatrix(merged, packageRoot), null, 2)}\n`,
+    "utf-8"
+  );
+
+  copyBundle({ rootDir, force: false });
+
   return backupPath;
 }
 

package/src/lib/workspace-boundary.js

@@ -0,0 +1,60 @@
+function normalize(text) {
+  return text.toLowerCase().normalize("NFD").replace(/\p{M}/gu, "");
+}
+
+const OVERRIDE_PHRASES = [
+  "cross-repo override",
+  "capint:cross-repo",
+  "capint cross repo",
+  "başka repo override",
+  "workspace override"
+];
+
+const SIBLING_REPO_NAMES = ["prismx", "prismx-cli", "efesusstone"];
+
+const PATH_PATTERNS = [
+  /\.\.[\\/][^\s,;'"`]*/g,
+  /(?:^|[\s'"`])([a-z]:[\\/][^\s'"`,]+)/gi,
+  /(?:^|[\s'"`])\/(?:home|Users|var)\/[^\s'"`,]+/gi,
+  new RegExp(
+    `(?:^|[\\s'"\\\`])((?:${SIBLING_REPO_NAMES.join("|")})[\\\\/][^\\s'"\\\`,]+)`,
+    "gi"
+  )
+];
+
+function extractSuspiciousPaths(text) {
+  const found = [];
+  for (const re of PATH_PATTERNS) {
+    for (const m of text.matchAll(re)) {
+      const p = (m[1] || m[0]).trim().replace(/^[\s'"`]+|[\s'"`,]+$/g, "");
+      if (p && !found.includes(p)) found.push(p);
+    }
+  }
+  return found;
+}
+
+function hasCrossRepoOverride(text) {
+  const n = normalize(text);
+  return OVERRIDE_PHRASES.some((p) => n.includes(normalize(p)));
+}
+
+function detectWorkspaceBoundary(text) {
+  const suspicious_paths = extractSuspiciousPaths(text);
+  const has_override = hasCrossRepoOverride(text);
+  const violated = suspicious_paths.length > 0 && !has_override;
+  return {
+    violated,
+    has_override,
+    suspicious_paths,
+    override_hint: violated
+      ? 'Add explicit phrase "cross-repo override" to edit files outside this workspace'
+      : null
+  };
+}
+
+module.exports = {
+  detectWorkspaceBoundary,
+  extractSuspiciousPaths,
+  hasCrossRepoOverride,
+  OVERRIDE_PHRASES
+};

package/templates/minimal/AGENT.md

@@ -2,14 +2,23 @@
 
 CapInt capability-first orchestration contract for this project.
 
+> **Günlük kullanım:** [GUNLUK.md](GUNLUK.md) — chat yeterli, terminal zorunlu değil.
+
 <!-- capint:managed:start -->
 ## Task contract
 
 For every task:
 1. Build Execution Intent
-2. Ask confirm options (`apply_now | plan_first | analyze_only`)
+2. Adaptive confirm: light → apply after Intent; medium/heavy → short Turkish question (devam/plan/analiz — no token required)
 3. Route via capability + provider resolution
 
+## Activation model
+
+- **`installed`** = `skills/<name>/SKILL.md` exists on disk **and** skill is not disabled (`capint skill list`).
+- **Installed ≠ Cursor skill picker** — CapInt does not register 115 skills in IDE UI; the agent reads files per task.
+- Before medium+ code edits: read `skills/prismx-skill-gateway/SKILL.md`, then the routed skill from `explanation.files_to_read`.
+- Preview routing: `capint route "<task>"` — check **Explanation** block.
+
 ## Runtime chain
 
 `parseIntent -> routeCapability -> resolveMemoryStrategy -> buildExecutionPolicy -> formatOutput`

package/templates/minimal/GUNLUK.md

@@ -0,0 +1,12 @@
+# CapInt — Günlük kullanım
+
+> **Terminal zorunlu değil.** Kurulumdan sonra her şey chat’te.
+
+1. Chat'e görevi doğal dille yaz (+ screenshot varsa ekle).
+2. Agent kısa **Execution Intent** gösterir (`Intent` / `Capability` / `Resolution` / `Plan`).
+3. **Hafif iş:** soru yok, doğrudan uygular. **Orta/ağır:** `devam` / `plan` / `analiz` yeterli.
+4. Skill veya workflow adı **ezberlemezsin**; seçimi agent yapar.
+5. `/workflow` veya `/skill` sadece override içindir (nadiren gerekir).
+6. Terminal yalnızca: **ilk kurulum** (`init`), **sorun** (`doctor`), **IDE kuralı** (`ide sync`).
+
+**Tam kılavuz:** [docs/kullanim-kilavuzu.md](docs/kullanim-kilavuzu.md) · **Chat şablonları:** [docs/conventions/daily-use.md](docs/conventions/daily-use.md)

package/templates/minimal/docs/conventions/daily-use.md

@@ -0,0 +1,130 @@
+---
+description: "CapInt daily use — chat-first, no ceremony."
+---
+
+# Günlük kullanım — chat yeterli
+
+CapInt arka planda **kurallar + capability router + skill bundle** sağlar.  
+Günlük iş **Cursor (veya IDE) chat’i** — terminal prosedürü değil.
+
+---
+
+## Kim ne yapar?
+
+| Sen | Agent |
+|-----|--------|
+| Görevi normal dille yaz | `AGENT.md` + IDE kurallarını okur |
+| Screenshot / “beklenen vs mevcut” ekle | Kısa Execution Intent; orta/ağırda kısa soru |
+| “Önce plan, onaylayınca kod” de | Seçimine göre plan veya kod |
+| İstersen oturum sonu özet onayla | Değişiklik özeti sunar |
+
+**Yazmana gerek yok:** Skill adları, `capint route` çıktısı, matrix jargonu.
+
+---
+
+## Mesaj şablonu (kopyala-yapıştır)
+
+```
+[Sorun / istek — 2–4 cümle]
+
+[Varsa: ekte screenshot = hedef görünüm]
+
+Kısıt: Sadece [modül/sayfa]. Başka yere dokunma.
+
+Önce kısa Execution Intent göster; hafif işte doğrudan uygula, orta/ağırda kısa soru sor (devam/plan/analiz).
+```
+
+---
+
+## Senaryolar
+
+### Bug fix
+
+```
+Ödeme callback 500 veriyor. Log: [varsa yapıştır].
+Kök neden + regression test. Sadece ilgili service ve test.
+Önce plan.
+```
+
+Agent muhtemelen: `Capability: systematic-debugging` · mesajında “önce plan” varsa plan modu
+
+### Çeviri / i18n
+
+```
+Lang dosyaları uyumsuz. Tek kaynak lang/*.php olsun.
+Önce hangi key'ler drift etmiş listele, onaylayınca düzelt.
+```
+
+Agent muhtemelen: `Capability: localization-hub`
+
+### Refactor
+
+```
+Auth modülünde code smell var. Davranış değişmesin.
+Mevcut testler geçmeli. Önce kısa plan.
+```
+
+### “Olmuş gibi değil” (UI)
+
+```
+Ekteki görsel doğru örnek. Şu anki sayfa uymuyor.
+Farkları listele → onay → düzelt.
+```
+
+### Mimari / karar
+
+```
+İki yaklaşım var: [A] ve [B]. Tek kaynak [A] olsun.
+Önce mimari plan — kod yok.
+```
+
+Confirm’de **`analiz`** veya “kod yazma” diyebilirsin.
+
+---
+
+## Confirm (adaptive)
+
+Confirm, agent’ın kontrolsüz kod yazmasını önlemek içindi. Günlük kullanımda:
+
+| Ağırlık | Sen |
+|---------|-----|
+| 🟢 Light | Ek adım yok — agent Intent sonrası uygular |
+| 🟡🔴 Medium/heavy | `devam` / `plan` / `analiz` yeterli — `apply_now` yazmana gerek yok |
+
+| Doğal dil | Anlam |
+|-----------|--------|
+| devam, yap, evet, tamam | Hemen uygula |
+| plan, planla, önce plan | Önce kısa plan |
+| analiz, incele, kod yazma | Sadece analiz |
+
+---
+
+## Terminal — sadece gerekirse
+
+| Ne zaman | Komut |
+|----------|--------|
+| Projeye **ilk kez** CapInt | `npx @bcelep/capint init` |
+| Agent kuralları gelmiyor | `capint ide sync` |
+| Bir şey eksik mi? | `capint doctor` |
+| Route kararını **görmek** istiyorsan (opsiyonel) | `capint route --verbose "..."` |
+
+Global kurulum varsa: `capint` (`npx` olmadan).
+
+---
+
+## Sık karışanlar
+
+| Yanlış algı | Gerçek |
+|-------------|--------|
+| Her görevde `capint route` | Hayır — chat yeterli |
+| Skill adını bilmem lazım | Hayır — agent seçer |
+| CapInt = terminal aracı | Hayır — IDE agent davranışı |
+| Init sonrası hâlâ zor | Yeni sohbet aç; IDE sync kontrol et |
+
+---
+
+## İlgili
+
+- [GUNLUK.md](../../GUNLUK.md) — tek sayfa özet
+- [kullanim-kilavuzu.md](../kullanim-kilavuzu.md) — tam kılavuz
+- [task-to-capability-cheatsheet.md](task-to-capability-cheatsheet.md) — görev → capability