@rely-ai/caliber 1.36.0 → 1.37.0-dev.1774891449

package/README.md

@@ -1,3 +1,7 @@
+# Caliber
+
+**Hand-written `CLAUDE.md` files go stale the moment you refactor.** Your AI agent hallucinates paths that no longer exist, misses new dependencies, and gives advice based on yesterday's architecture. Caliber generates and maintains your AI context files (`CLAUDE.md`, `.cursor/rules/`, `AGENTS.md`) so they stay accurate as your code evolves — and keeps every agent on your team in sync, whether they use Claude Code, Cursor, Codex, or OpenCode.
+
 <p align="center">
   <img src="assets/demo-header.gif" alt="Caliber product demo" width="900">
 </p>
@@ -10,30 +14,15 @@
   <img src="https://img.shields.io/badge/Claude_Code-supported-blue" alt="Claude Code">
   <img src="https://img.shields.io/badge/Cursor-supported-blue" alt="Cursor">
   <img src="https://img.shields.io/badge/Codex-supported-blue" alt="Codex">
+  <img src="https://img.shields.io/badge/OpenCode-supported-blue" alt="OpenCode">
 </p>
 
----
-
-### Try it — zero install, zero commitment
-
-```bash
-npx @rely-ai/caliber score
-```
-
-Score your AI agent config in 3 seconds. No API key. No changes to your code. Just a score.
-
-> **Your code stays on your machine.** Scoring is 100% local — no LLM calls, no code sent anywhere. Generation uses your own AI subscription (Claude Code, Cursor) or your own API key (Anthropic, OpenAI, Vertex AI). Caliber never sees your code.
-
----
-
-Caliber scores, generates, and keeps your AI agent configs in sync with your codebase. It fingerprints your project — languages, frameworks, dependencies, architecture — and produces tailored configs for **Claude Code**, **Cursor**, and **OpenAI Codex**. When your code evolves, Caliber detects the drift and updates your configs to match.
-
 ## Before / After
 
 Most repos start with a hand-written `CLAUDE.md` and nothing else. Here's what Caliber finds — and fixes:
 
 ```
-  Before                                    After caliber init
+  Before                                    After /setup-caliber
   ──────────────────────────────            ──────────────────────────────
 
   Agent Config Score    35 / 100            Agent Config Score    94 / 100
@@ -53,6 +42,24 @@ Scoring is deterministic — no LLM, no API calls. It cross-references your conf
 caliber score --compare main    # See how your branch changed the score
 ```
 
+## Get Started
+
+Requires **Node.js >= 20**.
+
+```bash
+npx @rely-ai/caliber bootstrap
+```
+
+Then, in your next Claude Code or Cursor chat session, type:
+
+> **/setup-caliber**
+
+Your agent detects your stack, generates tailored configs for every platform your team uses, sets up pre-commit hooks, and enables continuous sync — all from inside your normal workflow.
+
+**Don't use Claude Code or Cursor?** Run `caliber init` instead — it's the same setup as a CLI wizard. Works with any LLM provider: bring your own Anthropic, OpenAI, or Vertex AI key.
+
+> **Your code stays on your machine.** Bootstrap is 100% local — no LLM calls, no code sent anywhere. Generation uses your own AI subscription or API key. Caliber never sees your code.
+
 ## Audits first, writes second
 
 Caliber never overwrites your existing configs without asking. The workflow mirrors code review:
@@ -67,26 +74,28 @@ If your existing config scores **95+**, Caliber skips full regeneration and appl
 
 ## How It Works
 
-Caliber is not a one-time setup tool. It's a loop:
+Bootstrap gives your agent the `/setup-caliber` skill. Your agent analyzes your project — languages, frameworks, dependencies, architecture — generates configs, and installs hooks. From there, it's a loop:
 
 ```
-          caliber score
+  npx @rely-ai/caliber bootstrap       ← one-time, 2 seconds
               │
               ▼
-  ┌──── caliber init ◄────────────────┐
-  │     (generate / fix)              │
-  │           │                       │
-  │           ▼                       │
-  │     your code evolves             │
-  │     (new deps, renamed files,     │
-  │      changed architecture)        │
-  │           │                       │
-  │           ▼                       │
-  └──► caliber refresh ──────────────►┘
-       (detect drift, update configs)
+  agent runs /setup-caliber             ← agent handles everything
+              │
+              ▼
+  ┌──── configs generated ◄────────────┐
+  │           │                        │
+  │           ▼                        │
+  │     your code evolves              │
+  │     (new deps, renamed files,      │
+  │      changed architecture)         │
+  │           │                        │
+  │           ▼                        │
+  └──► caliber refresh ──────────────►─┘
+       (auto, on every commit)
 ```
 
-Auto-refresh hooks run this loop automatically — on every commit or at the end of each AI coding session.
+Pre-commit hooks run the refresh loop automatically. New team members get nudged to bootstrap on their first session.
 
 ### What It Generates
 
@@ -106,6 +115,10 @@ Auto-refresh hooks run this loop automatically — on every commit or at the end
 - `AGENTS.md` — Project context for Codex
 - `.agents/skills/*/SKILL.md` — Skills for Codex
 
+**OpenCode**
+- `AGENTS.md` — Project context (shared with Codex when both are targeted)
+- `.opencode/skills/*/SKILL.md` — Skills for OpenCode
+
 ## Key Features
 
 <details>
@@ -118,12 +131,13 @@ TypeScript, Python, Go, Rust, Java, Ruby, Terraform, and more. Language and fram
 <details>
 <summary><strong>Any AI Tool</strong></summary>
 
-Target a single platform or all three at once:
+`caliber bootstrap` auto-detects which agents you have installed. For manual control:
 ```bash
 caliber init --agent claude        # Claude Code only
 caliber init --agent cursor        # Cursor only
 caliber init --agent codex         # Codex only
-caliber init --agent all           # All three
+caliber init --agent opencode      # OpenCode only
+caliber init --agent all           # All platforms
 caliber init --agent claude,cursor # Comma-separated
 ```
 
@@ -197,12 +211,20 @@ The `refresh` command analyzes your git diff (committed, staged, and unstaged ch
 
 </details>
 
+<details>
+<summary><strong>Team Onboarding</strong></summary>
+
+When Caliber is set up in a repo, it automatically nudges new team members to configure it on their machine. A lightweight session hook checks whether the pre-commit hook is installed and prompts setup if not — no manual coordination needed.
+
+</details>
+
 <details>
 <summary><strong>Fully Reversible</strong></summary>
 
 - **Automatic backups** — originals saved to `.caliber/backups/` before every write
 - **Score regression guard** — if a regeneration produces a lower score, changes are auto-reverted
 - **Full undo** — `caliber undo` restores everything to its previous state
+- **Clean uninstall** — `caliber uninstall` removes everything Caliber added (hooks, generated sections, skills, learnings) while preserving your own content
 - **Dry run** — preview changes with `--dry-run` before applying
 
 </details>
@@ -211,9 +233,10 @@ The `refresh` command analyzes your git diff (committed, staged, and unstaged ch
 
 | Command | Description |
 |---|---|
+| `caliber bootstrap` | Install agent skills — the fastest way to get started |
+| `caliber init` | Full setup wizard — analyze, generate, review, install hooks |
 | `caliber score` | Score config quality (deterministic, no LLM) |
 | `caliber score --compare <ref>` | Compare current score against a git ref |
-| `caliber init` | Full setup wizard — analyze, generate, review, install hooks |
 | `caliber regenerate` | Re-analyze and regenerate configs (aliases: `regen`, `re`) |
 | `caliber refresh` | Update docs based on recent code changes |
 | `caliber skills` | Discover and install community skills |
@@ -221,6 +244,7 @@ The `refresh` command analyzes your git diff (committed, staged, and unstaged ch
 | `caliber hooks` | Manage auto-refresh hooks |
 | `caliber config` | Configure LLM provider, API key, and model |
 | `caliber status` | Show current setup status |
+| `caliber uninstall` | Remove all Caliber resources from a project |
 | `caliber undo` | Revert all changes made by Caliber |
 
 ## FAQ
@@ -235,9 +259,16 @@ No. Caliber shows you a diff of every proposed change. You accept, refine, or de
 <details>
 <summary><strong>Does it need an API key?</strong></summary>
 
-**Scoring:** No. `caliber score` runs 100% locally with no LLM.
+**Bootstrap & scoring:** No. Both run 100% locally with no LLM.
+
+**Generation** (via `/setup-caliber` or `caliber init`): Uses your existing Claude Code or Cursor subscription (no API key needed), or bring your own key for Anthropic, OpenAI, or Vertex AI.
+
+</details>
+
+<details>
+<summary><strong>What's the difference between bootstrap and init?</strong></summary>
 
-**Generation:** Uses your existing Claude Code or Cursor subscription (no API key needed), or bring your own key for Anthropic, OpenAI, or Vertex AI.
+`caliber bootstrap` installs agent skills in 2 seconds — your agent then runs `/setup-caliber` to handle the rest from inside your session. `caliber init` is the full interactive wizard for users who prefer a CLI-driven setup. Both end up in the same place.
 
 </details>
 
@@ -258,24 +289,10 @@ Yes. Run `caliber init` from any directory. `caliber refresh` can update configs
 <details>
 <summary><strong>Does it send my code anywhere?</strong></summary>
 
-Scoring is fully local. Generation sends your project fingerprint (not source code) to whatever LLM provider you configure — the same provider your AI editor already uses. Anonymous usage analytics (no code, no file contents) can be disabled via `caliber config`.
+Scoring is fully local. Generation sends a project summary (languages, structure, dependencies — not source code) to whatever LLM provider you configure — the same provider your AI editor already uses. Anonymous usage analytics (no code, no file contents) can be disabled via `caliber config`.
 
 </details>
 
-## Add a Caliber badge to your repo
-
-After scoring your project, add a badge to your README:
-
-![Caliber Score](https://img.shields.io/badge/caliber-94%2F100-brightgreen)
-
-Copy this markdown and replace `94` with your actual score:
-
-```
-![Caliber Score](https://img.shields.io/badge/caliber-SCORE%2F100-COLOR)
-```
-
-Color guide: `brightgreen` (90+), `green` (70-89), `yellow` (40-69), `red` (<40).
-
 ## LLM Providers
 
 No API key? No problem. Caliber works with your existing AI tool subscription:
@@ -333,11 +350,6 @@ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
 
 </details>
 
-## Requirements
-
-- **Node.js** >= 20
-- **One LLM provider:** your **Claude Code** or **Cursor** subscription (no API key), or an API key for Anthropic / OpenAI / Vertex AI
-
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
@@ -353,6 +365,20 @@ npm run build    # Compile
 
 Uses [conventional commits](https://www.conventionalcommits.org/) — `feat:` for features, `fix:` for bug fixes.
 
+## Add a Caliber badge to your repo
+
+After scoring your project, add a badge to your README:
+
+![Caliber Score](https://img.shields.io/badge/caliber-94%2F100-brightgreen)
+
+Copy this markdown and replace `94` with your actual score:
+
+```
+![Caliber Score](https://img.shields.io/badge/caliber-SCORE%2F100-COLOR)
+```
+
+Color guide: `brightgreen` (90+), `green` (70-89), `yellow` (40-69), `red` (<40).
+
 ## License
 
 MIT

package/dist/bin.js

@@ -3101,6 +3101,7 @@ var SKILL_FORMAT_RULES = `All skills follow the OpenSkills standard (agentskills
 
 Skill field requirements:
 - "name": kebab-case (lowercase letters, numbers, hyphens only). Becomes the directory name.
+- "name" MUST NOT be any of these reserved names (they are managed by Caliber automatically): "setup-caliber", "find-skills", "save-learning". Do NOT generate skills with these names.
 - "description": MUST include WHAT it does + WHEN to use it with specific trigger phrases. Example: "Manages database migrations. Use when user says 'run migration', 'create migration', 'db schema change', or modifies files in db/migrations/."
 - "content": markdown body only \u2014 do NOT include YAML frontmatter, it is generated from name+description.
 
@@ -3144,7 +3145,7 @@ PRIORITY WHEN CONSTRAINTS CONFLICT: Grounding and reference density matter more
 Note: Permissions, hooks, freshness tracking, and OpenSkills frontmatter are scored automatically by caliber \u2014 do not optimize for them.
 README.md is provided for context only \u2014 do NOT include a readmeMd field in your output.`;
 var OUTPUT_SIZE_CONSTRAINTS = `OUTPUT SIZE CONSTRAINTS \u2014 these are critical:
-- CLAUDE.md / AGENTS.md: MUST be under 150 lines for maximum score. Aim for 100-140 lines. Be concise \u2014 commands, architecture overview, and key conventions. Use bullet points and tables, not prose.
+- CLAUDE.md / AGENTS.md: MUST be under 400 lines for maximum score. Aim for 200-350 lines. Be thorough \u2014 commands, architecture overview, key conventions, data flow, and important patterns. Use bullet points and tables, not prose.
 
 Pack project references densely in architecture sections \u2014 use inline paths, not prose paragraphs:
 GOOD: **Entry**: \`src/bin.ts\` \u2192 \`src/cli.ts\` \xB7 **LLM** (\`src/llm/\`): \`anthropic.ts\` \xB7 \`vertex.ts\` \xB7 \`openai-compat.ts\`
@@ -3282,7 +3283,7 @@ Structure:
 5. "## Common Issues" (required) \u2014 specific error messages and their fixes. Not "check your config" but "If you see 'Connection refused on port 5432': 1. Verify postgres is running: docker ps | grep postgres 2. Check .env has correct DATABASE_URL"
 
 Rules:
-- Max 150 lines. Focus on actionable instructions, not documentation prose.
+- Max 400 lines. Focus on actionable instructions, not documentation prose.
 - Study existing code in the project context to extract the real patterns being used. A skill for "create API route" should show the exact file structure, imports, error handling, and naming that existing routes use.
 - Be specific and actionable. GOOD: "Run \`pnpm test -- --filter=api\` to verify". BAD: "Validate the data before proceeding."
 - Never use ambiguous language. Instead of "handle errors properly", write "Wrap the DB call in try/catch. On failure, return { error: string, code: number } matching the ErrorResponse type in \`src/types.ts\`."
@@ -3340,7 +3341,7 @@ Rules:
 - Update the "fileDescriptions" to reflect any changes you make.
 
 Quality constraints \u2014 your changes are scored, so do not break these:
-- CLAUDE.md / AGENTS.md: MUST stay under 150 lines. If adding content, remove less important lines to stay within budget. Do not refuse the user's request \u2014 make the change and trim elsewhere.
+- CLAUDE.md / AGENTS.md: MUST stay under 400 lines. If adding content, remove less important lines to stay within budget. Do not refuse the user's request \u2014 make the change and trim elsewhere.
 - Avoid vague instructions ("follow best practices", "write clean code", "ensure quality").
 - Do NOT add directory tree listings in code blocks.
 - Do NOT remove existing code blocks \u2014 they contribute to the executable content score.
@@ -3364,7 +3365,7 @@ CONSERVATIVE UPDATE means:
 - NEVER replace specific paths/commands with generic prose
 
 Quality constraints (the output is scored deterministically):
-- CLAUDE.md / AGENTS.md: MUST stay under 150 lines. If the diff adds content, trim the least important lines elsewhere.
+- CLAUDE.md / AGENTS.md: MUST stay under 400 lines. If the diff adds content, trim the least important lines elsewhere.
 - Keep 3+ code blocks with executable commands \u2014 do not remove code blocks
 - Every file path, command, and identifier must be in backticks
 - ONLY reference file paths that exist in the provided file tree \u2014 do NOT invent paths
@@ -3377,6 +3378,7 @@ Cross-agent sync:
 
 Managed content:
 - Keep managed blocks (<!-- caliber:managed --> ... <!-- /caliber:managed -->) intact
+- Keep context sync blocks (<!-- caliber:managed:sync --> ... <!-- /caliber:managed:sync -->) intact
 - Do NOT modify CALIBER_LEARNINGS.md \u2014 it is managed separately
 - Preserve any references to CALIBER_LEARNINGS.md in CLAUDE.md
 
@@ -3392,9 +3394,12 @@ Return a JSON object with this exact shape:
     "copilotInstructionFiles": [{"filename": "name.instructions.md", "content": "..."}] or null
   },
   "changesSummary": "<1-2 sentence summary of what was updated and why>",
+  "fileChanges": [{"file": "CLAUDE.md", "description": "added new API routes, updated build commands"}],
   "docsUpdated": ["CLAUDE.md", "README.md"]
 }
 
+The "fileChanges" array MUST include one entry per file that was updated (non-null in updatedDocs). Each entry describes what specifically changed in that file \u2014 be concrete (e.g. "added auth middleware section" not "updated docs").
+
 Respond with ONLY the JSON object, no markdown fences or extra text.`;
 var LEARN_SYSTEM_PROMPT = `You are an expert developer experience engineer. You analyze raw tool call events from AI coding sessions to extract reusable operational lessons that will help future LLM sessions work more effectively in this project.
 
@@ -5254,7 +5259,7 @@ import fs12 from "fs";
 import path12 from "path";
 function writeClaudeConfig(config) {
   const written = [];
-  fs12.writeFileSync("CLAUDE.md", appendLearningsBlock(appendPreCommitBlock(config.claudeMd)));
+  fs12.writeFileSync("CLAUDE.md", appendSyncBlock(appendLearningsBlock(appendPreCommitBlock(config.claudeMd))));
   written.push("CLAUDE.md");
   if (config.skills?.length) {
     for (const skill of config.skills) {
@@ -5300,7 +5305,8 @@ function writeCursorConfig(config) {
   }
   const preCommitRule = getCursorPreCommitRule();
   const learningsRule = getCursorLearningsRule();
-  const allRules = [...config.rules || [], preCommitRule, learningsRule];
+  const syncRule = getCursorSyncRule();
+  const allRules = [...config.rules || [], preCommitRule, learningsRule, syncRule];
   const rulesDir = path13.join(".cursor", "rules");
   if (!fs13.existsSync(rulesDir)) fs13.mkdirSync(rulesDir, { recursive: true });
   for (const rule of allRules) {
@@ -5383,7 +5389,7 @@ function writeGithubCopilotConfig(config) {
     fs15.mkdirSync(".github", { recursive: true });
     fs15.writeFileSync(
       path15.join(".github", "copilot-instructions.md"),
-      appendLearningsBlock(appendPreCommitBlock(config.instructions, "copilot"))
+      appendSyncBlock(appendLearningsBlock(appendPreCommitBlock(config.instructions, "copilot")))
     );
     written.push(".github/copilot-instructions.md");
   }
@@ -6116,11 +6122,11 @@ var POINTS_LEARNED_CONTENT = 2;
 var POINTS_SOURCES_CONFIGURED = 3;
 var POINTS_SOURCES_REFERENCED = 3;
 var TOKEN_BUDGET_THRESHOLDS = [
-  { maxTokens: 2e3, points: 6 },
-  { maxTokens: 3500, points: 5 },
-  { maxTokens: 5e3, points: 4 },
-  { maxTokens: 8e3, points: 2 },
-  { maxTokens: 12e3, points: 1 }
+  { maxTokens: 5e3, points: 6 },
+  { maxTokens: 8e3, points: 5 },
+  { maxTokens: 12e3, points: 4 },
+  { maxTokens: 16e3, points: 2 },
+  { maxTokens: 24e3, points: 1 }
 ];
 var CODE_BLOCK_THRESHOLDS = [
   { minBlocks: 3, points: 8 },
@@ -9750,27 +9756,36 @@ async function initCommand(options) {
   const bin = resolveCaliber();
   const firstRun = isFirstRun(process.cwd());
   if (firstRun) {
-    console.log(brand.bold(`
+    console.log(
+      brand.bold(`
    \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557
   \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
   \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D
   \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557
   \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551
    \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
-  `));
+  `)
+    );
     console.log(chalk14.dim("  Keep your AI agent configs in sync \u2014 automatically."));
     console.log(chalk14.dim("  Works across Claude Code, Cursor, Codex, and GitHub Copilot.\n"));
     console.log(title.bold("  How it works:\n"));
-    console.log(chalk14.dim("  1. Connect    Auto-detect your LLM provider and agents"));
-    console.log(chalk14.dim("  2. Build      Install sync, scan your project, generate configs"));
-    console.log(chalk14.dim("  3. Done       Review score and start syncing\n"));
+    console.log(chalk14.dim("  1. Connect    Link your LLM provider and select your agents"));
+    console.log(chalk14.dim("  2. Setup      Detect stack, install sync hooks & skills"));
+    console.log(chalk14.dim("  3. Generate   Audit existing config or generate from scratch"));
+    console.log(chalk14.dim("  4. Finalize   Review changes and score your setup\n"));
   } else {
     console.log(brand.bold("\n  CALIBER") + chalk14.dim("  \u2014 setting up continuous sync\n"));
   }
   const platforms = detectPlatforms();
   if (!platforms.claude && !platforms.cursor && !platforms.codex && !platforms.opencode) {
-    console.log(chalk14.yellow("  \u26A0 No supported AI platforms detected (Claude, Cursor, Codex, OpenCode)."));
-    console.log(chalk14.yellow("    Caliber will still generate config files, but they won't be auto-installed.\n"));
+    console.log(
+      chalk14.yellow("  \u26A0 No supported AI platforms detected (Claude, Cursor, Codex, OpenCode).")
+    );
+    console.log(
+      chalk14.yellow(
+        "    Caliber will still generate config files, but they won't be auto-installed.\n"
+      )
+    );
   }
   const report = options.debugReport ? new DebugReport() : null;
   console.log(title.bold("  Step 1/3 \u2014 Connect\n"));
@@ -9825,9 +9840,12 @@ async function initCommand(options) {
   console.log(chalk14.dim(modelLine + "\n"));
   if (report) {
     report.markStep("Provider connection");
-    report.addSection("LLM Provider", `- **Provider**: ${config.provider}
+    report.addSection(
+      "LLM Provider",
+      `- **Provider**: ${config.provider}
 - **Model**: ${displayModel}
-- **Fast model**: ${fastModel || "none"}`);
+- **Fast model**: ${fastModel || "none"}`
+    );
   }
   await validateModel({ fast: true });
   let targetAgent;
@@ -9852,10 +9870,11 @@ async function initCommand(options) {
   console.log(chalk14.dim(`  Target: ${targetAgent.join(", ")}
 `));
   trackInitAgentSelected(targetAgent, agentAutoDetected);
-  console.log(title.bold("  Step 2/3 \u2014 Build\n"));
+  console.log(title.bold("  Step 2/4 \u2014 Setup\n"));
+  console.log(chalk14.dim("  Installing sync infrastructure...\n"));
   const hookResult = installPreCommitHook();
   if (hookResult.installed) {
-    console.log(`  ${chalk14.green("\u2713")} Pre-commit hook installed`);
+    console.log(`  ${chalk14.green("\u2713")} Pre-commit hook installed \u2014 configs sync on every commit`);
   } else if (hookResult.alreadyInstalled) {
     console.log(`  ${chalk14.green("\u2713")} Pre-commit hook \u2014 active`);
   }
@@ -9863,13 +9882,20 @@ async function initCommand(options) {
   console.log(`  ${chalk14.green("\u2713")} Onboarding hook \u2014 nudges new team members to set up`);
   const { ensureBuiltinSkills: ensureBuiltinSkills2 } = await Promise.resolve().then(() => (init_builtin_skills(), builtin_skills_exports));
   for (const agent of targetAgent) {
-    if (agent === "claude" && !fs34.existsSync(".claude")) fs34.mkdirSync(".claude", { recursive: true });
-    if (agent === "cursor" && !fs34.existsSync(".cursor")) fs34.mkdirSync(".cursor", { recursive: true });
-    if (agent === "codex" && !fs34.existsSync(".agents")) fs34.mkdirSync(".agents", { recursive: true });
+    if (agent === "claude" && !fs34.existsSync(".claude"))
+      fs34.mkdirSync(".claude", { recursive: true });
+    if (agent === "cursor" && !fs34.existsSync(".cursor"))
+      fs34.mkdirSync(".cursor", { recursive: true });
+    if (agent === "codex" && !fs34.existsSync(".agents"))
+      fs34.mkdirSync(".agents", { recursive: true });
   }
   const skillsWritten = ensureBuiltinSkills2();
   if (skillsWritten.length > 0) {
-    console.log(`  ${chalk14.green("\u2713")} Agent skills installed`);
+    console.log(
+      `  ${chalk14.green("\u2713")} Agent skills installed \u2014 /setup-caliber, /find-skills, /save-learning`
+    );
+  } else {
+    console.log(`  ${chalk14.green("\u2713")} Agent skills \u2014 already installed`);
   }
   const hasLearnableAgent = targetAgent.includes("claude") || targetAgent.includes("cursor");
   if (hasLearnableAgent) {
@@ -9879,15 +9905,31 @@ async function initCommand(options) {
     trackInitLearnEnabled(true);
   }
   console.log("");
+  console.log(chalk14.dim("  New team members can run /setup-caliber inside their coding agent"));
+  console.log(chalk14.dim("  (Claude Code or Cursor) to get set up automatically.\n"));
   const baselineScore = computeLocalScore(process.cwd(), targetAgent);
-  log(options.verbose, `Baseline score: ${baselineScore.score}/100`);
+  console.log(chalk14.dim("  Current config score:"));
+  displayScoreSummary(baselineScore);
+  if (options.verbose) {
+    for (const c of baselineScore.checks) {
+      log(
+        options.verbose,
+        `  ${c.passed ? "\u2713" : "\u2717"} ${c.name}: ${c.earnedPoints}/${c.maxPoints}${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`
+      );
+    }
+  }
   if (report) {
     report.markStep("Baseline scoring");
-    report.addSection("Scoring: Baseline", `**Score**: ${baselineScore.score}/100
+    report.addSection(
+      "Scoring: Baseline",
+      `**Score**: ${baselineScore.score}/100
 
 | Check | Passed | Points | Max |
 |-------|--------|--------|-----|
-` + baselineScore.checks.map((c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`).join("\n"));
+` + baselineScore.checks.map(
+        (c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`
+      ).join("\n")
+    );
     report.addSection("Generation: Target Agents", targetAgent.join(", "));
   }
   const hasExistingConfig = !!(baselineScore.checks.some((c) => c.id === "claude_md_exists" && c.passed) || baselineScore.checks.some((c) => c.id === "cursorrules_exists" && c.passed));
@@ -9901,15 +9943,27 @@ async function initCommand(options) {
   ]);
   const passingCount = baselineScore.checks.filter((c) => c.passed).length;
   const failingCount = baselineScore.checks.filter((c) => !c.passed).length;
-  trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
   let skipGeneration = false;
-  if (hasExistingConfig && baselineScore.score === 100 && !options.force) {
-    skipGeneration = true;
+  if (hasExistingConfig && baselineScore.score === 100) {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, true);
+    console.log(chalk14.bold.green("\n  Your config is already optimal.\n"));
+    skipGeneration = !options.force;
   } else if (hasExistingConfig && !options.force && !options.autoApprove) {
-    console.log(chalk14.dim(`  Config score: ${baselineScore.score}/100 \u2014 Caliber can improve this.
-`));
-    const improveAnswer = await confirm2({ message: "Improve your existing configs?" });
-    skipGeneration = !improveAnswer;
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
+    console.log(
+      chalk14.dim("\n  Sync infrastructure is ready. Caliber can also audit your existing")
+    );
+    console.log(chalk14.dim("  configs and improve them using AI.\n"));
+    const auditAnswer = await promptInput("  Audit and improve your existing config? (Y/n) ");
+    skipGeneration = auditAnswer.toLowerCase() === "n";
+  } else if (!hasExistingConfig && !options.force && !options.autoApprove) {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
+    console.log(chalk14.dim("\n  Sync infrastructure is ready. Caliber can also generate tailored"));
+    console.log(chalk14.dim("  CLAUDE.md, Cursor rules, and Codex configs for your project.\n"));
+    const generateAnswer = await promptInput("  Generate agent configs? (Y/n) ");
+    skipGeneration = generateAnswer.toLowerCase() === "n";
+  } else {
+    trackInitScoreComputed(baselineScore.score, passingCount, failingCount, false);
   }
   if (skipGeneration) {
     const {
@@ -9937,7 +9991,12 @@ async function initCommand(options) {
     if (targetAgent.includes("cursor")) {
       const rulesDir = path28.join(".cursor", "rules");
       if (!fs34.existsSync(rulesDir)) fs34.mkdirSync(rulesDir, { recursive: true });
-      for (const rule of [getCursorPreCommitRule2(), getCursorLearningsRule2(), getCursorSyncRule2(), getCursorSetupRule2()]) {
+      for (const rule of [
+        getCursorPreCommitRule2(),
+        getCursorLearningsRule2(),
+        getCursorSyncRule2(),
+        getCursorSetupRule2()
+      ]) {
         fs34.writeFileSync(path28.join(rulesDir, rule.filename), rule.content);
       }
       console.log(`  ${chalk14.green("\u2713")} Cursor rules \u2014 added Caliber sync rules`);
@@ -9969,9 +10028,12 @@ async function initCommand(options) {
     trackInitCompleted("sync-only", baselineScore.score);
     console.log(chalk14.bold.green("\n  Caliber sync is set up!\n"));
     console.log(chalk14.dim("  Your agent configs will sync automatically on every commit."));
-    console.log(chalk14.dim("  Run ") + title(`${bin} init --force`) + chalk14.dim(" anytime to generate or improve configs.\n"));
+    console.log(
+      chalk14.dim("  Run ") + title(`${bin} init --force`) + chalk14.dim(" anytime to generate or improve configs.\n")
+    );
     return;
   }
+  console.log(title.bold("\n  Step 3/4 \u2014 Generate\n"));
   const genModelInfo = fastModel ? `  Using ${displayModel} for docs, ${fastModel} for skills` : `  Using ${displayModel}`;
   console.log(chalk14.dim(genModelInfo + "\n"));
   if (report) report.markStep("Generation");
@@ -9987,8 +10049,14 @@ async function initCommand(options) {
   const TASK_STACK = display.add("Detecting project stack", { pipelineLabel: "Scan" });
   const TASK_CONFIG = display.add("Generating configs", { depth: 1, pipelineLabel: "Generate" });
   const TASK_SKILLS_GEN = display.add("Generating skills", { depth: 2, pipelineLabel: "Skills" });
-  const TASK_SKILLS_SEARCH = display.add("Searching community skills", { depth: 1, pipelineLabel: "Search", pipelineRow: 1 });
-  const TASK_SCORE_REFINE = display.add("Validating & refining config", { pipelineLabel: "Validate" });
+  const TASK_SKILLS_SEARCH = display.add("Searching community skills", {
+    depth: 1,
+    pipelineLabel: "Search",
+    pipelineRow: 1
+  });
+  const TASK_SCORE_REFINE = display.add("Validating & refining config", {
+    pipelineLabel: "Validate"
+  });
   display.start();
   display.enableWaitingContent();
   try {
@@ -9998,21 +10066,39 @@ async function initCommand(options) {
     const stackSummary = stackParts.join(", ") || "no languages";
     const largeRepoNote = fingerprint.fileTree.length > 5e3 ? ` (${fingerprint.fileTree.length.toLocaleString()} files, smart sampling active)` : "";
     display.update(TASK_STACK, "done", stackSummary + largeRepoNote);
-    trackInitProjectDiscovered(fingerprint.languages.length, fingerprint.frameworks.length, fingerprint.fileTree.length);
-    log(options.verbose, `Fingerprint: ${fingerprint.languages.length} languages, ${fingerprint.frameworks.length} frameworks, ${fingerprint.fileTree.length} files`);
+    trackInitProjectDiscovered(
+      fingerprint.languages.length,
+      fingerprint.frameworks.length,
+      fingerprint.fileTree.length
+    );
+    log(
+      options.verbose,
+      `Fingerprint: ${fingerprint.languages.length} languages, ${fingerprint.frameworks.length} frameworks, ${fingerprint.fileTree.length} files`
+    );
     const cliSources = options.source || [];
     const workspaces = getDetectedWorkspaces(process.cwd());
     const sources2 = resolveAllSources(process.cwd(), cliSources, workspaces);
     if (sources2.length > 0) {
       fingerprint.sources = sources2;
-      log(options.verbose, `Sources: ${sources2.length} resolved (${sources2.map((s) => s.name).join(", ")})`);
+      log(
+        options.verbose,
+        `Sources: ${sources2.length} resolved (${sources2.map((s) => s.name).join(", ")})`
+      );
     }
     if (report) {
-      report.addJson("Fingerprint: Git", { remote: fingerprint.gitRemoteUrl, packageName: fingerprint.packageName });
+      report.addJson("Fingerprint: Git", {
+        remote: fingerprint.gitRemoteUrl,
+        packageName: fingerprint.packageName
+      });
       report.addCodeBlock("Fingerprint: File Tree", fingerprint.fileTree.join("\n"));
-      report.addJson("Fingerprint: Detected Stack", { languages: fingerprint.languages, frameworks: fingerprint.frameworks, tools: fingerprint.tools });
+      report.addJson("Fingerprint: Detected Stack", {
+        languages: fingerprint.languages,
+        frameworks: fingerprint.frameworks,
+        tools: fingerprint.tools
+      });
       report.addJson("Fingerprint: Existing Configs", fingerprint.existingConfigs);
-      if (fingerprint.codeAnalysis) report.addJson("Fingerprint: Code Analysis", fingerprint.codeAnalysis);
+      if (fingerprint.codeAnalysis)
+        report.addJson("Fingerprint: Code Analysis", fingerprint.codeAnalysis);
     }
     const isEmpty = fingerprint.fileTree.length < 3;
     if (isEmpty) {
@@ -10043,13 +10129,26 @@ async function initCommand(options) {
       let passingChecks;
       let currentScore;
       if (hasExistingConfig && localBaseline.score >= 95 && !options.force) {
-        const currentLlmFixable = localBaseline.checks.filter((c) => !c.passed && c.maxPoints > 0 && !NON_LLM_CHECKS.has(c.id));
-        failingChecks = currentLlmFixable.map((c) => ({ name: c.name, suggestion: c.suggestion, fix: c.fix }));
+        const currentLlmFixable = localBaseline.checks.filter(
+          (c) => !c.passed && c.maxPoints > 0 && !NON_LLM_CHECKS.has(c.id)
+        );
+        failingChecks = currentLlmFixable.map((c) => ({
+          name: c.name,
+          suggestion: c.suggestion,
+          fix: c.fix
+        }));
         passingChecks = localBaseline.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
         currentScore = localBaseline.score;
       }
       if (report) {
-        const fullPrompt = buildGeneratePrompt(fingerprint, targetAgent, fingerprint.description, failingChecks, currentScore, passingChecks);
+        const fullPrompt = buildGeneratePrompt(
+          fingerprint,
+          targetAgent,
+          fingerprint.description,
+          failingChecks,
+          currentScore,
+          passingChecks
+        );
         report.addCodeBlock("Generation: Full LLM Prompt", fullPrompt);
       }
       const result = await generateSetup(
@@ -10169,8 +10268,11 @@ async function initCommand(options) {
     if (rawOutput) report.addCodeBlock("Generation: Raw LLM Response", rawOutput);
     report.addJson("Generation: Parsed Config", generatedSetup);
   }
-  log(options.verbose, `Generation completed: ${elapsedMs}ms, stopReason: ${genStopReason || "end_turn"}`);
-  console.log(title.bold("  Step 3/3 \u2014 Done\n"));
+  log(
+    options.verbose,
+    `Generation completed: ${elapsedMs}ms, stopReason: ${genStopReason || "end_turn"}`
+  );
+  console.log(title.bold("  Step 4/4 \u2014 Finalize\n"));
   const setupFiles = collectSetupFiles(generatedSetup, targetAgent);
   const staged = stageFiles(setupFiles, process.cwd());
   const totalChanges = staged.newFiles + staged.modifiedFiles;
@@ -10181,10 +10283,18 @@ async function initCommand(options) {
     }
     console.log("");
   }
-  console.log(chalk14.dim(`  ${chalk14.green(`${staged.newFiles} new`)} / ${chalk14.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}`));
+  console.log(
+    chalk14.dim(
+      `  ${chalk14.green(`${staged.newFiles} new`)} / ${chalk14.yellow(`${staged.modifiedFiles} modified`)} file${totalChanges !== 1 ? "s" : ""}`
+    )
+  );
   if (skillSearchResult.results.length > 0) {
-    console.log(chalk14.dim(`  ${chalk14.cyan(`${skillSearchResult.results.length}`)} community skills available to install
-`));
+    console.log(
+      chalk14.dim(
+        `  ${chalk14.cyan(`${skillSearchResult.results.length}`)} community skills available to install
+`
+      )
+    );
   } else {
     console.log("");
   }
@@ -10220,8 +10330,12 @@ async function initCommand(options) {
     }
     const updatedFiles = collectSetupFiles(generatedSetup, targetAgent);
     const restaged = stageFiles(updatedFiles, process.cwd());
-    console.log(chalk14.dim(`  ${chalk14.green(`${restaged.newFiles} new`)} / ${chalk14.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
-`));
+    console.log(
+      chalk14.dim(
+        `  ${chalk14.green(`${restaged.newFiles} new`)} / ${chalk14.yellow(`${restaged.modifiedFiles} modified`)} file${restaged.newFiles + restaged.modifiedFiles !== 1 ? "s" : ""}
+`
+      )
+    );
     printSetupSummary(generatedSetup);
     const { openReview: openRev } = await Promise.resolve().then(() => (init_review(), review_exports));
     await openRev("terminal", restaged.stagedFiles);
@@ -10247,7 +10361,8 @@ async function initCommand(options) {
       const agentRefs = [];
       if (claude) agentRefs.push("See `CLAUDE.md` for Claude Code configuration.");
       if (cursor) agentRefs.push("See `.cursor/rules/` for Cursor rules.");
-      if (agentRefs.length === 0) agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
+      if (agentRefs.length === 0)
+        agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
       const stubContent = `# AGENTS.md
 
 This project uses AI coding agents configured by [Caliber](https://github.com/caliber-ai-org/ai-setup).
@@ -10294,24 +10409,39 @@ ${agentRefs.join(" ")}
   if (afterScore.score < baselineScore.score) {
     trackInitScoreRegression(baselineScore.score, afterScore.score);
     console.log("");
-    console.log(chalk14.yellow(`  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`));
+    console.log(
+      chalk14.yellow(
+        `  Score would drop from ${baselineScore.score} to ${afterScore.score} \u2014 reverting changes.`
+      )
+    );
     try {
       const { restored, removed } = undoSetup();
       if (restored.length > 0 || removed.length > 0) {
-        console.log(chalk14.dim(`  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`));
+        console.log(
+          chalk14.dim(
+            `  Reverted ${restored.length + removed.length} file${restored.length + removed.length === 1 ? "" : "s"} from backup.`
+          )
+        );
       }
     } catch {
     }
-    console.log(chalk14.dim("  Run ") + chalk14.hex("#83D1EB")(`${bin} init --force`) + chalk14.dim(" to override.\n"));
+    console.log(
+      chalk14.dim("  Run ") + chalk14.hex("#83D1EB")(`${bin} init --force`) + chalk14.dim(" to override.\n")
+    );
     return;
   }
   if (report) {
     report.markStep("Post-write scoring");
-    report.addSection("Scoring: Post-Write", `**Score**: ${afterScore.score}/100 (delta: ${afterScore.score - baselineScore.score >= 0 ? "+" : ""}${afterScore.score - baselineScore.score})
+    report.addSection(
+      "Scoring: Post-Write",
+      `**Score**: ${afterScore.score}/100 (delta: ${afterScore.score - baselineScore.score >= 0 ? "+" : ""}${afterScore.score - baselineScore.score})
 
 | Check | Passed | Points | Max |
 |-------|--------|--------|-----|
-` + afterScore.checks.map((c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`).join("\n"));
+` + afterScore.checks.map(
+        (c) => `| ${c.name} | ${c.passed ? "Yes" : "No"} | ${c.earnedPoints} | ${c.maxPoints} |`
+      ).join("\n")
+    );
   }
   recordScore(afterScore, "init");
   trackInitCompleted("full-generation", afterScore.score);
@@ -10319,7 +10449,10 @@ ${agentRefs.join(" ")}
   if (options.verbose) {
     log(options.verbose, `Final score: ${afterScore.score}/100`);
     for (const c of afterScore.checks.filter((ch) => !ch.passed)) {
-      log(options.verbose, `  Still failing: ${c.name} (${c.earnedPoints}/${c.maxPoints})${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`);
+      log(
+        options.verbose,
+        `  Still failing: ${c.name} (${c.earnedPoints}/${c.maxPoints})${c.suggestion ? ` \u2014 ${c.suggestion}` : ""}`
+      );
     }
   }
   let communitySkillsInstalled = 0;
@@ -10336,21 +10469,32 @@ ${agentRefs.join(" ")}
   const done = chalk14.green("\u2713");
   console.log(chalk14.bold.green("\n  Caliber is set up!\n"));
   console.log(chalk14.bold("  What's configured:\n"));
-  console.log(`    ${done}  Continuous sync     ${chalk14.dim("pre-commit hook keeps all agent configs in sync")}`);
-  console.log(`    ${done}  Config generated    ${chalk14.dim(`score: ${afterScore.score}/100`)}`);
-  console.log(`    ${done}  Agent skills        ${chalk14.dim("/setup-caliber for new team members")}`);
+  console.log(
+    `    ${done}  Continuous sync          ${chalk14.dim("pre-commit hook keeps all agent configs in sync")}`
+  );
+  console.log(
+    `    ${done}  Config generated         ${title(`${bin} score`)} ${chalk14.dim("for full breakdown")}`
+  );
+  console.log(
+    `    ${done}  Agent skills             ${chalk14.dim("/setup-caliber for new team members")}`
+  );
   if (hasLearnableAgent) {
-    console.log(`    ${done}  Session learning    ${chalk14.dim("learns from your corrections")}`);
+    console.log(
+      `    ${done}  Session learning         ${chalk14.dim("agent learns from your feedback")}`
+    );
   }
   if (communitySkillsInstalled > 0) {
-    console.log(`    ${done}  Community skills    ${chalk14.dim(`${communitySkillsInstalled} installed for your stack`)}`);
+    console.log(
+      `    ${done}  Community skills         ${chalk14.dim(`${communitySkillsInstalled} skill${communitySkillsInstalled > 1 ? "s" : ""} installed for your stack`)}`
+    );
   }
   console.log(chalk14.bold("\n  What happens next:\n"));
-  console.log(chalk14.dim("    Every commit syncs your agent configs automatically."));
-  console.log(chalk14.dim("    New team members run /setup-caliber to get set up instantly.\n"));
-  console.log(`    ${title(`${bin} score`)}        Full scoring breakdown`);
-  console.log(`    ${title(`${bin} skills`)}       Find community skills`);
-  console.log(`    ${title(`${bin} undo`)}         Revert changes`);
+  console.log(chalk14.dim("    Every commit will automatically sync your agent configs."));
+  console.log(chalk14.dim("    New team members can run /setup-caliber to get set up instantly.\n"));
+  console.log(chalk14.bold("  Explore:\n"));
+  console.log(`    ${title(`${bin} score`)}        Full scoring breakdown with improvement tips`);
+  console.log(`    ${title(`${bin} skills`)}       Find community skills for your stack`);
+  console.log(`    ${title(`${bin} undo`)}         Revert all changes from this run`);
   console.log(`    ${title(`${bin} uninstall`)}    Remove Caliber completely`);
   console.log("");
   if (options.showTokens) {
@@ -10360,8 +10504,10 @@ ${agentRefs.join(" ")}
     report.markStep("Finished");
     const reportPath = path28.join(process.cwd(), ".caliber", "debug-report.md");
     report.write(reportPath);
-    console.log(chalk14.dim(`  Debug report written to ${path28.relative(process.cwd(), reportPath)}
-`));
+    console.log(
+      chalk14.dim(`  Debug report written to ${path28.relative(process.cwd(), reportPath)}
+`)
+    );
   }
 }
 
@@ -10914,6 +11060,13 @@ Changed files: ${diff.changedFiles.join(", ")}`);
     parts.push("\n[.cursorrules]");
     parts.push(existingDocs.cursorrules);
   }
+  if (existingDocs.claudeSkills?.length) {
+    for (const skill of existingDocs.claudeSkills) {
+      parts.push(`
+[.claude/skills/${skill.filename}]`);
+      parts.push(skill.content);
+    }
+  }
   if (existingDocs.cursorRules?.length) {
     for (const rule of existingDocs.cursorRules) {
       if (rule.filename.startsWith("caliber-")) continue;
@@ -11176,6 +11329,15 @@ function clearRefreshError() {
   } catch {
   }
 }
+function detectSyncedAgents(writtenFiles) {
+  const agents = [];
+  const joined = writtenFiles.join(" ");
+  if (joined.includes("CLAUDE.md") || joined.includes(".claude/")) agents.push("Claude Code");
+  if (joined.includes(".cursor/") || joined.includes(".cursorrules")) agents.push("Cursor");
+  if (joined.includes("copilot-instructions") || joined.includes(".github/instructions/")) agents.push("Copilot");
+  if (joined.includes("AGENTS.md") || joined.includes(".agents/")) agents.push("Codex");
+  return agents;
+}
 function log2(quiet, ...args) {
   if (!quiet) console.log(...args);
 }
@@ -11338,8 +11500,18 @@ async function refreshSingleRepo(repoDir, options) {
   }
   recordScore(postScore, "refresh");
   spinner?.succeed(`${prefix}Updated ${written.length} doc${written.length === 1 ? "" : "s"}`);
+  const fileChangesMap = new Map(
+    (response.fileChanges || []).map((fc) => [fc.file, fc.description])
+  );
   for (const file of written) {
-    log2(quiet, `  ${chalk19.green("\u2713")} ${file}`);
+    const desc = fileChangesMap.get(file);
+    const suffix = desc ? chalk19.dim(` \u2014 ${desc}`) : "";
+    log2(quiet, `  ${chalk19.green("\u2713")} ${file}${suffix}`);
+  }
+  const agents = detectSyncedAgents(written);
+  if (agents.length > 1) {
+    log2(quiet, chalk19.cyan(`
+  ${agents.length} agent formats in sync (${agents.join(", ")})`));
   }
   if (response.changesSummary) {
     log2(quiet, chalk19.dim(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rely-ai/caliber",
-  "version": "1.36.0",
+  "version": "1.37.0-dev.1774891449",
   "description": "AI context infrastructure for coding agents — keeps CLAUDE.md, Cursor rules, and skills in sync as your codebase evolves",
   "type": "module",
   "bin": {