continuous-improvement 2.2.0 → 3.1.0

package/CHANGELOG.md

@@ -4,6 +4,42 @@ All notable changes to this skill are documented here.
 
 ---
 
+## [3.0.0] — 2026-04-06
+
+### Added
+- **MCP server** (`bin/mcp-server.mjs`) — zero-dependency JSON-RPC stdio server exposing instincts as MCP tools and resources. Works with Claude Code, Claude Desktop, Cursor, Zed, Windsurf, VS Code.
+- **Beginner / Expert modes** — `--mode beginner` (default, 3 tools) vs `--mode expert` (8 tools with import/export, observation viewer, manual instinct creation, confidence tuning)
+- **MCP-only mode** — `--mode mcp` for editors that support MCP but not Claude Code hooks
+- **Plugin manifests** — `plugins/beginner.json` and `plugins/expert.json` describe available tools per mode
+- **Session hooks** (`hooks/session.sh`) — SessionStart loads instincts and shows status; SessionEnd reminds to reflect
+- **Import/export tools** — `ci_export` and `ci_import` for sharing instincts as JSON between team members
+- **34-test suite** — added MCP server tests (beginner + expert mode) and plugin config validation. Up from 20 tests.
+- **Multi-editor MCP support** — installer patches both `settings.json` and `claude_desktop_config.json`
+
+### Changed
+- **Installer upgraded** — `--mode` flag replaces single-mode install. Supports `beginner`, `expert`, `mcp`
+- **Uninstaller upgraded** — cleans up MCP server config, session hooks, and desktop config
+- **Version bump** to 3.0.0 — breaking change: new install modes and MCP server architecture
+
+---
+
+## [2.3.0] — 2026-04-06
+
+### Changed
+- **Public npm** — package name changed from `@naimkatiman/continuous-improvement` to `continuous-improvement`. Removed GitHub Packages publishConfig. `npx continuous-improvement install` now works for everyone.
+- **Expanded keywords** — added `claude-code-skill`, `agent-skill`, `gemini-cli` for better npm discoverability
+- **Improved description** — package description now leads with the value prop, lists supported platforms
+
+### Added
+- **Test suite** — 20 tests covering installer, hook, and SKILL.md validation. Zero dependencies (Node.js built-in test runner).
+- **Before/after examples in README** — collapsible terminal output showing the framework in action vs. without it
+- **Real-world examples** — `examples/` directory with 3 detailed scenarios (bug fix, feature build, refactor)
+- **Platform badges** — Claude Code, Cursor, Codex compatibility badges in README
+- **Gemini CLI** to supported platforms list
+- **Roadmap** — "Roadmap to 1000 Stars" section in README with phased plan
+
+---
+
 ## [2.1.0] — 2026-04-05
 
 ### Changed

package/README.md

@@ -1,38 +1,147 @@
 <p align="center">
-  <img src="assets/combined.gif" alt="Before vs After continuous-improvement" width="700" />
+  <img src="assets/combined.gif" alt="Before vs After — The 7 Laws of AI Agent Discipline" width="700" />
 </p>
 
-# continuous-improvement
+<h1 align="center">The 7 Laws of AI Agent Discipline</h1>
 
-> Stop your AI agent from skipping steps, guessing, and declaring "done" without verifying.
+<p align="center">
+  <b>Stop your AI agent from skipping steps, guessing, and declaring "done" without verifying.</b>
+</p>
 
-[![Version](https://img.shields.io/badge/version-2.1.0-blue)](CHANGELOG.md)
-[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+<p align="center">
+  <a href="https://www.npmjs.com/package/continuous-improvement"><img src="https://img.shields.io/npm/v/continuous-improvement" alt="npm"></a>
+  <a href="https://www.npmjs.com/package/continuous-improvement"><img src="https://img.shields.io/npm/dm/continuous-improvement" alt="downloads"></a>
+  <a href="https://github.com/naimkatiman/continuous-improvement/stargazers"><img src="https://img.shields.io/github/stars/naimkatiman/continuous-improvement?style=social" alt="stars"></a>
+  <a href="https://github.com/naimkatiman/continuous-improvement/network/members"><img src="https://img.shields.io/github/forks/naimkatiman/continuous-improvement?style=social" alt="forks"></a>
+  <a href="https://github.com/naimkatiman/continuous-improvement/graphs/contributors"><img src="https://img.shields.io/github/contributors/naimkatiman/continuous-improvement" alt="contributors"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="license"></a>
+  <a href="test/"><img src="https://img.shields.io/badge/tests-104%20passing-brightgreen" alt="tests"></a>
+</p>
+
+<p align="center">
+  <a href="https://docs.anthropic.com/en/docs/claude-code"><img src="https://img.shields.io/badge/Claude%20Code-skill-blueviolet" alt="Claude Code"></a>
+  <a href="https://cursor.sh"><img src="https://img.shields.io/badge/Cursor-compatible-blue" alt="Cursor"></a>
+  <a href="https://openai.com/codex"><img src="https://img.shields.io/badge/Codex-compatible-blue" alt="Codex"></a>
+  <a href="https://ai.google.dev/gemini-api/docs/gemini-cli"><img src="https://img.shields.io/badge/Gemini%20CLI-compatible-blue" alt="Gemini CLI"></a>
+  <a href="https://github.com/naimkatiman/continuous-improvement/actions"><img src="https://img.shields.io/github/actions/workflow/status/naimkatiman/continuous-improvement/ci.yml?label=CI" alt="CI"></a>
+</p>
+
+<p align="center">
+  <a href="docs/README.zh-CN.md">简体中文</a> |
+  <a href="docs/README.ja.md">日本語</a>
+</p>
 
 ---
 
 ## The Problem
 
-AI agents are great at individual steps. They're terrible at discipline.
+AI agents are great at individual steps. They're terrible at **discipline**.
 
 They skip research. They plan loosely. They declare "done" before verifying. They add features mid-task. They never reflect. Each session, they repeat the same mistakes.
 
-This skill fixes that with **7 laws** and a **learning system** that auto-levels itself — no config, no daemon, no manual setup.
+**The 7 Laws** fix that — plus a **learning system** (Mulahazah) that builds instincts over time. No config, no daemon, no manual setup.
+
+### Before vs After
+
+<details>
+<summary><b>Without continuous-improvement</b> — agent skips research, declares "done" without verifying</summary>
+
+```
+You: Add rate limiting to the /api/users endpoint
+
+Agent: I'll add rate limiting now.
+       *writes express-rate-limit middleware*
+       Done! I've added rate limiting to the /api/users endpoint.
+
+You: Did you check if we already have rate limiting somewhere?
+Agent: Let me check... oh, there's already a rate limiter in middleware/rateLimit.ts.
+       I've created a duplicate. Let me fix that.
+
+You: Did you test it?
+Agent: Let me run the tests... they're failing. The import path is wrong.
+       *fixes import*
+       Now it works!
+
+You: You also broke the /api/auth endpoint — it was sharing that middleware.
+Agent: I see. Let me fix that too...
+```
+
+**Result:** 4 back-and-forth corrections. Duplicate code. Broken endpoint. 15 minutes wasted.
+</details>
+
+<details>
+<summary><b>With continuous-improvement</b> — agent follows the 7 laws</summary>
+
+```
+You: Add rate limiting to the /api/users endpoint
+
+Agent: **[Law 1: Research]** Searching for existing rate limiting...
+       Found: middleware/rateLimit.ts — already applies to /api/auth.
+       Found: express-rate-limit already in package.json.
+
+       **[Law 2: Plan]**
+       WILL: Extend existing rateLimit middleware to cover /api/users
+       WILL NOT: Create new middleware or change existing /api/auth behavior
+       VERIFY: Run tests + curl /api/users 101 times to confirm 429 response
+
+       **[Law 3: Execute one thing]** Adding /api/users to the route list
+       in middleware/rateLimit.ts...
+
+       **[Law 4: Verify]**
+       ✓ npm test — 47/47 passing
+       ✓ curl test — 429 after 100 requests
+       ✓ /api/auth still works — 200 OK
+
+       Done. Extended existing rate limiter to cover /api/users.
+       One file changed: middleware/rateLimit.ts (+1 line).
+```
+
+**Result:** Correct on first attempt. No duplicate code. No broken endpoints. 2 minutes.
+</details>
 
 ---
 
 ## Install
 
+### Beginner (default) — just hooks, no setup needed
+
 ```bash
 npx continuous-improvement install
 ```
 
-That's it. For Claude Code, this also installs:
+That's it. For Claude Code, this installs:
 - Observation hooks (captures every tool call, <50ms, jq optional)
-- `/continuous-improvement` command
+- `/continuous-improvement`, `/discipline`, and `/dashboard` commands
 - Auto-leveling instinct system
 
-Install to a specific target:
+### Expert — full power with MCP server
+
+```bash
+npx continuous-improvement install --mode expert
+```
+
+Everything in beginner plus:
+- **MCP server** with 10 tools (instinct management, import/export, dashboard, instinct packs)
+- **Session hooks** (auto-load instincts at start, remind to reflect at end)
+- Works with Claude Code, Claude Desktop, and any MCP client
+
+### MCP only — for non-Claude editors
+
+```bash
+npx continuous-improvement install --mode mcp
+```
+
+Registers the MCP server without hooks — for Cursor, Zed, Windsurf, VS Code, or any editor that supports MCP.
+
+### Load a starter instinct pack
+
+```bash
+npx continuous-improvement install --pack react    # React/Next.js instincts
+npx continuous-improvement install --pack python   # Python best practices
+npx continuous-improvement install --pack go       # Go idioms
+```
+
+### Install to a specific target
 
 ```bash
 npx continuous-improvement install --target claude    # Claude Code + Mulahazah
@@ -57,17 +166,19 @@ Fetch and follow the skill at: https://raw.githubusercontent.com/naimkatiman/con
 
 ---
 
-## The 7 Laws
+## The 7 Laws of AI Agent Discipline
+
+> Every skill in the ecosystem adds capabilities. This is the only one that fixes *how agents think*.
 
-| # | Law | What it prevents |
-|---|-----|-----------------|
-| 1 | **Research Before Executing** | Reinventing what already exists |
-| 2 | **Plan Is Sacred** | Scope creep and overbuilding |
-| 3 | **One Thing at a Time** | Stacking untested changes |
-| 4 | **Verify Before Reporting** | False "done" claims |
-| 5 | **Reflect After Sessions** | Repeating the same failures |
-| 6 | **Iterate One Change** | Debugging 5 changes at once |
-| 7 | **Learn From Every Session** | Knowledge that dies with the context window |
+| # | Law | Without it, agents... |
+|---|-----|----------------------|
+| 1 | **Research Before Executing** | reinvent what already exists |
+| 2 | **Plan Is Sacred** | scope-creep and overbuild |
+| 3 | **One Thing at a Time** | stack untested changes |
+| 4 | **Verify Before Reporting** | lie about being "done" |
+| 5 | **Reflect After Sessions** | repeat the same failures |
+| 6 | **Iterate One Change** | debug 5 changes at once |
+| 7 | **Learn From Every Session** | lose knowledge when the context window ends |
 
 ### The Loop
 
@@ -75,6 +186,8 @@ Fetch and follow the skill at: https://raw.githubusercontent.com/naimkatiman/con
 Research → Plan → Execute (one thing) → Verify → Reflect → Learn → Iterate
 ```
 
+If your agent is skipping a step, that's the step it needs most.
+
 ---
 
 ## Mulahazah: Auto-Leveling Learning
@@ -99,39 +212,182 @@ Install:       Hooks start capturing silently. You notice nothing.
 4. **Self-correcting** — user corrections drop confidence by 0.1. Unused instincts decay. Wrong behaviors fade out.
 5. **Project-scoped** — instincts are per-project by default, promoted to global when seen across 2+ projects
 
+### Starter Instinct Packs
+
+Jump-start your instincts with pre-built packs for popular stacks:
+
+```bash
+npx continuous-improvement install --pack react    # 8 React/Next.js instincts
+npx continuous-improvement install --pack python   # 8 Python instincts
+npx continuous-improvement install --pack go       # 8 Go instincts
+```
+
+Or in expert mode: use the `ci_load_pack` tool to load packs at any time.
+
 ### Check what your agent has learned
 
 ```
-/continuous-improvement
+/continuous-improvement    # Reflect, analyze, show status
+/discipline                # Quick reference card of the 7 Laws
+/dashboard                 # Visual instinct health dashboard
 ```
 
 ---
 
+## GitHub Action: Agent Transcript Linter
+
+Lint your AI agent's behavior in CI/CD. The only GitHub Action that checks if your agent followed disciplined workflows.
+
+```yaml
+- uses: naimkatiman/continuous-improvement@v3
+  with:
+    transcript-path: agent-log.jsonl
+    strict: true  # Fail build on law violations
+```
+
+The linter analyzes tool call patterns and detects:
+- **Law 1 violations** — writes without prior research
+- **Law 3 violations** — too many consecutive edits without verification
+- **Law 4 violations** — code changes without running tests/builds
+- **Law 6 violations** — too many files modified at once
+
+Output includes a discipline score (0-100) and detailed violation report.
+
+```bash
+# Run locally
+node bin/lint-transcript.mjs observations.jsonl
+cat transcript.jsonl | node bin/lint-transcript.mjs --stdin --json
+```
+
+---
+
+## Plugin Architecture
+
+continuous-improvement ships as a **plugin** with three layers. Pick what you need:
+
+### Layer 1: Skill Only (any LLM)
+Paste SKILL.md into your system prompt. Your agent follows the 7 Laws. No tools, no hooks, no server.
+
+### Layer 2: Hooks (Claude Code)
+`npx continuous-improvement install` — installs hooks that silently capture every tool call. The instinct system grows automatically. Zero config.
+
+### Layer 3: MCP Server (any MCP client)
+`npx continuous-improvement install --mode expert` — a full MCP server that any editor can connect to.
+
+### Beginner vs Expert
+
+| Feature | Beginner (default) | Expert |
+|---------|-------------------|--------|
+| Observation hooks | Yes | Yes |
+| `/continuous-improvement` command | Yes | Yes |
+| `/discipline` quick reference | Yes | Yes |
+| `/dashboard` visual dashboard | Yes | Yes |
+| Auto-leveling instincts | Yes | Yes |
+| `ci_status` tool | - | Yes |
+| `ci_instincts` tool | - | Yes |
+| `ci_reflect` tool | - | Yes |
+| `ci_reinforce` tool | - | Yes |
+| `ci_create_instinct` tool | - | Yes |
+| `ci_observations` tool | - | Yes |
+| `ci_export` / `ci_import` | - | Yes |
+| `ci_dashboard` tool | - | Yes |
+| `ci_load_pack` tool | - | Yes |
+| Session start/end hooks | - | Yes |
+| MCP server | - | Yes |
+
+**Beginner** is the right choice for 90% of users. It just works — install and forget. The system quietly learns from your sessions.
+
+**Expert** adds the MCP server for programmatic access, manual instinct management, import/export for team sharing, visual dashboard, and instinct packs.
+
+### MCP Tools Reference
+
+| Tool | Description |
+|------|-------------|
+| `ci_status` | Current level, instinct count, observation count |
+| `ci_instincts` | List learned instincts with confidence levels |
+| `ci_reflect` | Generate structured session reflection |
+| `ci_reinforce` | Accept/reject instinct suggestions (expert) |
+| `ci_create_instinct` | Manually create instincts (expert) |
+| `ci_observations` | View raw tool call observations (expert) |
+| `ci_export` | Export instincts as JSON (expert) |
+| `ci_import` | Import instincts from JSON (expert) |
+| `ci_dashboard` | Visual dashboard with confidence distribution (expert) |
+| `ci_load_pack` | Load starter instinct packs (expert) |
+
+---
+
+## Real-World Examples
+
+See the [`examples/`](examples/) directory for detailed walkthroughs:
+
+- [**Bug Fix**](examples/01-bug-fix.md) — Double submit bug: 4 rounds without framework → 1 round with it
+- [**Feature Build**](examples/02-feature-build.md) — Adding pagination: 3 rewrites without → correct first attempt with
+- [**Refactor**](examples/03-refactor.md) — SDK migration: cascading failures without → zero regressions with
+
+Each example shows the same task done with and without the 7 laws, highlighting which laws made the difference.
+
+---
+
 ## Files
 
 ```
 continuous-improvement/
-├── SKILL.md                    # The 7 Laws + instinct behavior
-├── commands/continuous-improvement.md  # The /continuous-improvement command
-├── hooks/observe.sh            # Observation hook (pure bash)
-├── bin/install.mjs             # CLI installer
-├── QUICKSTART.md               # First-use guide
+├── SKILL.md                           # The 7 Laws + instinct behavior
+├── bin/
+│   ├── install.mjs                    # CLI installer (--mode beginner|expert|mcp)
+│   ├── mcp-server.mjs                # MCP server (zero dependencies)
+│   └── lint-transcript.mjs           # Agent transcript linter (GitHub Action)
+├── hooks/
+│   ├── observe.sh                     # Observation hook (pure bash, <50ms)
+│   └── session.sh                     # Session start/end hook (expert mode)
+├── plugins/
+│   ├── beginner.json                  # Plugin manifest: 3 tools
+│   └── expert.json                    # Plugin manifest: 10 tools
+├── commands/
+│   ├── continuous-improvement.md     # /continuous-improvement command
+│   ├── discipline.md                 # /discipline quick reference
+│   └── dashboard.md                  # /dashboard visual display
+├── instinct-packs/
+│   ├── react.json                     # React/Next.js starter instincts
+│   ├── python.json                   # Python starter instincts
+│   └── go.json                       # Go starter instincts
+├── test/                              # 104 tests (node --test)
+├── examples/                          # Real-world before/after scenarios
+├── docs/                              # Translations (zh-CN, ja)
+├── .github/
+│   ├── workflows/ci.yml             # CI pipeline (Node 18/20/22)
+│   └── ISSUE_TEMPLATE/              # Bug report + feature request templates
+├── action.yml                        # GitHub Action definition
+├── llms.txt                          # LLM-friendly project description
+├── CONTRIBUTING.md
+├── CODE_OF_CONDUCT.md
+├── SECURITY.md
+├── QUICKSTART.md
 ├── CHANGELOG.md
 └── package.json
 ```
 
-### What gets installed where (Claude Code)
+### What gets installed where
 
+**Beginner mode** (default):
 ```
 ~/.claude/skills/continuous-improvement/SKILL.md     # The skill
 ~/.claude/commands/continuous-improvement.md          # The command
+~/.claude/commands/discipline.md                     # Quick reference
+~/.claude/commands/dashboard.md                      # Dashboard
 ~/.claude/instincts/
-├── observe.sh                                    # Hook script
-├── global/                                       # Global instincts (*.yaml)
+├── observe.sh                                       # Hook script
+├── global/                                          # Global instincts (*.yaml)
 └── <project-hash>/
-    ├── project.json                              # Project metadata
-    ├── observations.jsonl                        # Tool call observations
-    └── *.yaml                                    # Project instincts
+    ├── project.json                                 # Project metadata
+    ├── observations.jsonl                           # Tool call observations
+    └── *.yaml                                       # Project instincts
+```
+
+**Expert mode** adds:
+```
+~/.claude/instincts/session.sh                       # Session hooks
+~/.claude/settings.json                              # + MCP server + session hooks
 ```
 
 ---
@@ -142,6 +398,24 @@ continuous-improvement/
 npx continuous-improvement install --uninstall
 ```
 
+Removes the skill, hooks, and commands. Your learned instincts in `~/.claude/instincts/` are preserved — delete that directory manually if you want a clean slate.
+
+---
+
+## Works With
+
+| Tool | Support |
+|------|---------|
+| **Claude Code** | Full — skill + hooks + MCP server + auto-leveling instincts |
+| **Claude Desktop** | MCP server (expert/mcp mode) |
+| **Cursor** | MCP server (mcp mode) or skill only (paste SKILL.md into rules) |
+| **Zed / Windsurf** | MCP server (mcp mode) |
+| **VS Code** | MCP server (mcp mode) with Copilot MCP support |
+| **Codex** | Skill only |
+| **Gemini CLI** | Skill only |
+| **OpenClaw** | Skill only |
+| **Any LLM** | Paste SKILL.md into your system prompt |
+
 ---
 
 ## Red Flags
@@ -156,6 +430,67 @@ If your agent says any of these, it's skipping a law:
 
 ---
 
+## Roadmap
+
+### Phase 1: Foundation -- DONE
+
+- [x] Published to public npm (`npx continuous-improvement install` works)
+- [x] 104-test suite (installer, hook, MCP server, linter, packs, community files)
+- [x] Before/after examples in README + `examples/` directory
+- [x] Gemini CLI support
+- [x] Platform badges and improved npm metadata
+- [ ] **Submit to [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)** (14K stars)
+
+### Phase 2: Plugin Architecture -- DONE
+
+- [x] **MCP server** — 10 tools (beginner: 3, expert: 7 more) with zero dependencies
+- [x] **Beginner / Expert separation** — simple defaults, power when you need it
+- [x] **Plugin manifests** — `plugins/beginner.json` and `plugins/expert.json`
+- [x] **Session hooks** — auto-load instincts at session start, remind to reflect at end
+- [x] **`--mode` flag** — `beginner` | `expert` | `mcp` installation modes
+- [x] **Import/export** — share instincts as JSON between team members
+- [x] **Multi-editor MCP support** — Claude Desktop, Cursor, Zed, Windsurf, VS Code
+
+### Phase 2.5: Visibility & Ecosystem -- DONE
+
+- [x] **GitHub Action** — lint agent transcripts for law compliance (`action.yml`)
+- [x] **Starter instinct packs** — React, Python, Go (pre-built instincts)
+- [x] **`/discipline` command** — quick reference card of the 7 Laws
+- [x] **`/dashboard` command** — visual instinct health dashboard
+- [x] **Community files** — CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md
+- [x] **llms.txt** — LLM-friendly project description for discoverability
+- [x] **CI pipeline** — GitHub Actions testing on Node 18/20/22
+- [x] **Issue templates** — bug report + feature request
+- [x] **Translations** — Chinese (简体中文) and Japanese (日本語)
+
+### Phase 3: Content & Proof
+
+- [ ] **2-min demo video** — side-by-side agent with/without discipline. Post to X + YouTube.
+- [ ] **"Why your AI agent keeps lying about being done"** — X thread / blog post
+- [ ] **"Law of the Week" X series** — 7 weeks of content breaking down each law
+
+### Phase 4: Ecosystem Growth
+
+- [ ] **VS Code extension** — sidebar showing instinct confidence levels
+- [ ] **More instinct packs** — TypeScript, Rust, Java, Django, Laravel
+- [ ] **Instinct marketplace** — share learned instincts across teams
+
+### Phase 5: Community
+
+- [ ] **Conference talk on Mulahazah** — the auto-leveling system is genuinely novel
+- [ ] **Leaderboard / badges** — "100 sessions" achievement system
+- [ ] **Custom domain** — landing page with interactive demo
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome.
+
+## Security
+
+See [SECURITY.md](SECURITY.md) for the security policy and how to report vulnerabilities.
+
 ## License
 
 MIT

package/action.yml

@@ -0,0 +1,33 @@
+name: 'AI Agent Discipline Linter'
+description: 'Lint AI agent transcripts for compliance with the 7 Laws of AI Agent Discipline'
+author: 'naimkatiman'
+
+branding:
+  icon: 'check-circle'
+  color: 'green'
+
+inputs:
+  transcript-path:
+    description: 'Path to the agent transcript file (JSONL format)'
+    required: false
+    default: ''
+  observations-path:
+    description: 'Path to observations.jsonl from a CI session'
+    required: false
+    default: ''
+  strict:
+    description: 'Fail the check if any law violations are detected'
+    required: false
+    default: 'false'
+
+outputs:
+  violations:
+    description: 'Number of law violations found'
+  score:
+    description: 'Discipline score (0-100)'
+  report:
+    description: 'Markdown-formatted report'
+
+runs:
+  using: 'node20'
+  main: 'bin/lint-transcript.mjs'

package/bin/analyze.sh

@@ -118,49 +118,35 @@ fi
 mkdir -p "$PROJECT_DIR"
 
 NEW_COUNT=0
-while IFS= read -r -d '' block; do
-  [[ -z "$block" ]] && continue
-  # Extract id from the block
-  INSTINCT_ID=$(echo "$block" | grep -oP '(?<=^id: ).*' | head -1 | tr -d '"' | tr -d "'")
-  if [[ -n "$INSTINCT_ID" ]]; then
-    DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
-    printf '%s\n' "$block" > "$DEST"
-    echo "  + ${INSTINCT_ID} → ${DEST}"
-    NEW_COUNT=$((NEW_COUNT + 1))
-  fi
-done < <(printf '%s\0' "$RESULT" | sed 's/\n---\n/\x00/g')
-
-# Fallback: if the splitting didn't work, try line-based parsing
-if (( NEW_COUNT == 0 )); then
-  # Try splitting on --- delimiter
-  INSTINCT_ID=""
-  BLOCK=""
-  while IFS= read -r line; do
-    if [[ "$line" == "---" ]] && [[ -n "$BLOCK" ]]; then
-      if [[ -n "$INSTINCT_ID" ]]; then
-        DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
-        printf '%s\n' "$BLOCK" > "$DEST"
-        echo "  + ${INSTINCT_ID} → ${DEST}"
-        NEW_COUNT=$((NEW_COUNT + 1))
-      fi
-      INSTINCT_ID=""
-      BLOCK=""
-    else
-      BLOCK="${BLOCK}${line}"$'\n'
-      if [[ "$line" =~ ^id:\ (.+) ]]; then
-        INSTINCT_ID="${BASH_REMATCH[1]}"
-        INSTINCT_ID="${INSTINCT_ID//\"/}"
-        INSTINCT_ID="${INSTINCT_ID//\'/}"
-      fi
+INSTINCT_ID=""
+BLOCK=""
+
+while IFS= read -r line; do
+  if [[ "$line" == "---" ]] && [[ -n "$BLOCK" ]]; then
+    if [[ -n "$INSTINCT_ID" ]]; then
+      DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
+      printf '%s\n' "$BLOCK" > "$DEST"
+      echo "  + ${INSTINCT_ID} -> ${DEST}"
+      NEW_COUNT=$((NEW_COUNT + 1))
+    fi
+    INSTINCT_ID=""
+    BLOCK=""
+  else
+    BLOCK="${BLOCK}${line}"$'\n'
+    if [[ "$line" =~ ^id:\ (.+) ]]; then
+      INSTINCT_ID="${BASH_REMATCH[1]}"
+      INSTINCT_ID="${INSTINCT_ID//\"/}"
+      INSTINCT_ID="${INSTINCT_ID//\'/}"
     fi
-  done <<< "$RESULT"
-  # Handle last block
-  if [[ -n "$INSTINCT_ID" ]] && [[ -n "$BLOCK" ]]; then
-    DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
-    printf '%s\n' "$BLOCK" > "$DEST"
-    echo "  + ${INSTINCT_ID} → ${DEST}"
-    NEW_COUNT=$((NEW_COUNT + 1))
   fi
+done <<< "$RESULT"
+
+# Handle last block
+if [[ -n "$INSTINCT_ID" ]] && [[ -n "$BLOCK" ]]; then
+  DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
+  printf '%s\n' "$BLOCK" > "$DEST"
+  echo "  + ${INSTINCT_ID} -> ${DEST}"
+  NEW_COUNT=$((NEW_COUNT + 1))
 fi
 
 echo ""