@xelth/eck-snapshot 6.0.4 → 6.0.5

package/README.md

@@ -2,6 +2,7 @@
 
 A specialized, AI-native CLI tool designed to create and restore single-file text snapshots of Git repositories. Optimized for providing full project context to Large Language Models (LLMs) and serving as the coordination hub for AI Coders.
 
+
 ## 🎯 The Battle-Tested Workflow & Quick Start
 
 I personally use this tool daily with local AI coding agents (**Claude Code** using Claude, and **OpenCode** using GLM). My reliable, heavily-tested workflow is:
@@ -14,9 +15,9 @@ npm install -g @xelth/eck-snapshot
 ### 2. Initial Context (Full Snapshots)
 Take a full snapshot and feed it to a powerful Web LLM (Senior Architect like **Gemini** or **Grok**). *(Note: **ChatGPT** also works, but you MUST paste the specific prompt provided at the end of the snapshot output as your first prompt).*
 ```bash
-eck-snapshot snapshot
+eck-snapshot
 ```
-*(For massive monorepos, slice the context using profiles: `eck-snapshot snapshot --profile frontend`)*
+*(For massive monorepos, slice the context using profiles: `eck-snapshot --profile frontend`)*
 
 ### 3. Direct Execution
 Pass the Architect's technical plan to your local Coder agent (Claude Code / OpenCode). The Coder will implement the changes directly in your repository.
@@ -48,5 +49,16 @@ This core loop is highly polished, actively maintained, and works exceptionally
 * **☠️ Skeleton Mode:** Uses `Tree-sitter` and `Babel` to strip function bodies (`--skeleton`), drastically reducing token count.
 * **📊 Telemetry Hub:** Integrated with a Rust-based microservice for tracking agent execution metrics and auto-syncing token estimation weights.
 
+
+## 💡 The Philosophy: Why force a full snapshot?
+
+You've probably noticed a pattern: the longer you chat with an LLM about your codebase, the smarter it gets and the better its code becomes. 
+
+How do you get that expert-level understanding from the very first prompt? You can't rely on an agent guessing which isolated files to read based on filenames. You need to force-feed it the entire context at once. 
+
+Think of AI models like human engineers. Imagine a person standing next to a massive bookshelf of programming textbooks. The total amount of information available to them is exactly the same before they go to university and after they graduate. Both can open a book, check the table of contents, and look up a formula. Yet, the results they produce are vastly different. Why? Because the graduate has the structural context *inside their head*. 
+
+LLMs work the exact same way. Giving an AI a "file search" tool is like putting a beginner next to the bookshelf. Forcing a complete project snapshot into the LLM's massive context window is like giving it a university degree in your specific codebase. That is what `eck-snapshot` does.
+
 ## License
 MIT © xelth-com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelth/eck-snapshot",
-  "version": "6.0.4",
+  "version": "6.0.5",
   "description": "A powerful CLI tool to create and restore single-file text snapshots of Git repositories. Optimized for AI context, LLM workflows, and multi-agent Swarm coordination.",
   "main": "index.js",
   "type": "module",