@techwavedev/agi-agent-kit 1.1.7 → 1.2.7

package/CHANGELOG.md

@@ -5,10 +5,151 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.7] - 2026-02-11
+
+### Security & Maintenance
+
+- **Repository Sanitization**: Removed all internal development configurations (`.agent`, `.claude`, `.gemini`) and private skills from the public repository.
+- **Workflow Hardening**: Enforced fork-and-PR workflow in `CONTRIBUTING.md`.
+- **Community Standards**: Added issue templates and PR templates.
+
+## [1.2.6] - 2026-02-10
+
+### Added
+
+- **notebooklm-rag (Deep RAG)**: MCP-first autonomous knowledge backend powered by Google NotebookLM + Gemini. The agent fully manages NotebookLM via MCP tools — authentication, library CRUD, querying with auto follow-ups, and Qdrant caching for token savings and cross-session context keeping. Includes fallback Python scripts (Patchright browser automation) when MCP is unavailable. Opt-in for users with Google accounts; default RAG remains `qdrant-memory`. Based on [PleasePrompto/notebooklm-skill](https://github.com/PleasePrompto/notebooklm-skill) (MIT).
+
+### Removed
+
+- **notebooklm-mcp**: Merged into `notebooklm-rag`. The comprehensive Deep RAG skill supersedes the basic MCP connector.
+
+### Fixed
+
+- **npmignore**: Fixed deep-path glob patterns (`**/__pycache__/`, `**/*.pyc`, `**/data/`) preventing compiled Python files and sensitive data from leaking into the published NPM package.
+
+## [1.2.5] - 2026-02-09
+
+### Fixed
+
+- **Documentation Updates**: README updated to reflect current version and removed internal skill references.
+
+## [1.2.4] - 2026-02-09
+
+### Fixed
+
+- **Minor bug fixes**: Addressed issues from v1.2.3 release.
+
+## [1.2.3] - 2026-02-09
+
+### Added
+
+- **Auto Python Virtual Environment**: `npx init` now auto-creates `.venv/` and installs all dependencies — eliminates the `externally-managed-environment` error on macOS.
+- **Auto Platform Setup**: `npx init` runs `platform_setup.py --auto` after venv creation, pre-configuring platform-specific settings (`.claude/settings.json`, `.claude/skills/`) and showing remaining manual steps.
+- **Activation Reference Table** (README): Comprehensive reference with 4 sections — 14 slash commands, 8 `@agent` mentions, 18 natural language trigger keyword categories, and 6 memory system commands.
+- **Semantic Memory Section** (README): Setup guide with Qdrant + Ollama commands, token savings table (90-100% savings), and usage examples.
+- **`pyright`** added to `requirements.txt` for Python type checking out of the box.
+
+### Changed
+
+- **`requirements.txt`**: Expanded from 6 to 12 packages across 5 organized sections (Core, Memory, Embeddings, Cloud, Testing & Auditing). Every dependency is documented with inline comments.
+- **`bin/init.js`**: Added `setupPythonEnv()` and `runPlatformSetup()` functions. Uses `child_process.execSync` for venv creation and `pip install`. Cross-platform support (macOS/Linux/Windows paths).
+- **README Prerequisites**: No longer tells users to `pip install` manually — now references auto-created `.venv` with activation command.
+- **Post-install message**: Step 1 is now "Activate the Python environment" instead of "Install Python dependencies."
+- **Templates synced**: `requirements.txt`, `README.md` copied to `templates/base/` for NPX distribution.
+- **Documentation SKILL.md**: `Last Updated` timestamp refreshed to 2026-02-09.
+- **SKILLS_CATALOG.md**: Regenerated with 56 skills.
+
+### Fixed
+
+- **`ModuleNotFoundError: No module named 'yaml'`**: `pyyaml` was missing from `requirements.txt` — `system_checkup.py` crashed on fresh installs. Now included in core dependencies.
+- **Missing dependencies**: `gitpython`, `ollama`, `sentence-transformers`, `playwright` were used by skills but not listed in `requirements.txt`. All now included.
+- **`--auto-apply` flag**: `init.js` called `platform_setup.py` with non-existent `--auto-apply` flag — fixed to use existing `--auto` flag.
+
+## [1.2.2] - 2026-02-09
+
+### Added
+
+- **Platform-Adaptive Multi-Agent Orchestration** (`parallel-agents` v2.0):
+  - **Strategy A: Claude Code Agent Teams** — True parallel multi-agent orchestration via tmux/in-process sessions. Requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.
+  - **Strategy B: Claude Code Subagents** — Background/foreground task orchestration via `Task()` tool with `context: fork`.
+  - **Strategy C: Sequential Personas** — Universal fallback for Gemini, Opencode, and other platforms using `@agent` persona switching.
+  - **Strategy D: Kiro Autonomous Agent** — Async parallel task execution in sandboxed environments with PR-based delivery and cross-repo coordination.
+  - Automatic platform detection and strategy selection.
+  - Subagent configuration reference (frontmatter, tools, permissions, model, memory).
+  - Full Claude Code subagent lifecycle documentation (create, configure, invoke, manage).
+
+- **Kiro IDE Powers & Autonomous Agent Support**:
+  - Full Kiro Powers documentation: `POWER.md` anatomy, frontmatter keywords activation, onboarding sections, steering files, `mcp.json` configuration with auto-namespacing.
+  - Kiro Hooks system (`.kiro/hooks/`) with JSON structure and automated behaviors.
+  - Kiro Autonomous Agent: sandboxed execution, PR-based reviews, cross-repo coordination, learning from code reviews.
+  - 12 curated launch partner Powers documented (Figma, Supabase, Stripe, Neon, Netlify, Postman, Strands, Datadog, Dynatrace, AWS CDK, Terraform, Aurora).
+  - **Antigravity ↔ Kiro mapping guide**: Skill-to-Power conversion workflow, directory mapping, frontmatter translation.
+
+- **Plugin & Extension Auto-Discovery** (`plugin-discovery` v1.1.0 — NEW SKILL):
+  - Cross-platform extension auto-discovery for Claude Code, Kiro IDE, Gemini, and Opencode.
+  - Claude Code: Plugin marketplace guide (official + custom), LSP plugins by language, service integrations, scopes, subagent/skill discovery.
+  - Kiro: Full Powers discovery, installation guide (IDE, kiro.dev, GitHub, local path), setup checklist.
+  - Gemini/Opencode: Skills catalog discovery, MCP server detection.
+  - Cross-platform compatibility map (11 features × 4 platforms).
+
+- **One-Shot Platform Setup Wizard** (`platform_setup.py`):
+  - Auto-detects platform: Claude Code, Kiro IDE, Gemini, Opencode.
+  - Scans project tech stack: languages (JS/TS/Python/Go/Rust/Ruby), frameworks (Next.js/React/Vue/Express/Angular/Svelte/Astro/React Native), services (GitHub/GitLab/Docker/Vercel/Netlify/Stripe/Supabase/Firebase/Terraform).
+  - Generates prioritized recommendations with `🔴 High` / `🟡 Medium` / `🟢 Low` indicators.
+  - Auto-applies configurable settings (Agent Teams, directory creation, hook setup) with single `Y/n` confirmation.
+  - Shows manual instructions for platform-only actions (plugin installs, Power installs).
+  - 4 modes: interactive, `--auto`, `--dry-run`, `--json`.
+  - New `/setup` workflow with `// turbo` annotation for auto-run.
+
+- **Intelligent Routing v2.0** (`intelligent-routing` v2.0):
+  - Platform detection at session start (Claude Code, Kiro IDE, Gemini, Opencode).
+  - Proactive capability announcements per platform.
+  - Team Leader mode for Claude Code with Agent Teams enabled.
+  - Powers-driven orchestration mode for Kiro IDE.
+  - Proactive feature recommendations: suggests Agent Teams, plugins, Powers, Autonomous Agent when not enabled.
+  - Multi-domain task routing adapts to best available parallelism strategy.
+
+- **Memory System Integration** (`session_boot.py` — NEW SCRIPT):
+  - `execution/session_boot.py` — Single entry point for session initialization. Checks Qdrant, Ollama, embedding models, and collections in one command. `--auto-fix` flag auto-pulls missing models and creates collections.
+  - **Session Boot Protocol** added as the **first section** in `AGENTS.md` — agents run `python3 execution/session_boot.py --auto-fix` before any work begins.
+  - `AGENTS.md` Memory-First section rewritten with explicit CLI commands: `memory_manager.py auto`, `store`, `cache-store` with decision tree table.
+  - `platform_setup.py` now detects full memory system: Qdrant status, Ollama status, embedding model presence, collection existence, point counts.
+  - Memory recommendations engine: suggests starting Qdrant/Ollama, pulling embedding model, or initializing collections when issues are detected.
+  - Memory report section (🧠) in platform setup output shows live system status.
+
+### Changed
+
+- **`parallel-agents`**: Rewritten from v1.0 to v2.0 — now platform-adaptive with 4 orchestration strategies instead of 1.
+- **`intelligent-routing`**: Rewritten from v1.0 to v2.0 — now includes platform detection, proactive recommendations, and Kiro support.
+- **Cross-Platform Compatibility Map**: Updated with 2 new rows (Dynamic MCP Loading, Cross-Repo Tasks) and accurate Kiro feature coverage.
+- **`package.json`**: Added `kiro`, `opencode`, and `platform-adaptive` keywords for NPM discoverability.
+- **Templates**: All modified skills (`parallel-agents`, `intelligent-routing`, `plugin-discovery`) and scripts (`platform_setup.py`) synced to `templates/skills/knowledge/` for NPX distribution.
+- **SKILLS_CATALOG.md**: Regenerated with 56 skills, including the new `plugin-discovery` skill.
+- **`bin/init.js`**: NPX init now copies `execution/` scripts (session_boot.py, session_init.py, memory_manager.py) and `directives/` (memory_integration.md) to scaffolded projects. Update function also refreshes these files.
+- **Post-install message**: Now shows `session_boot.py --auto-fix` as step 3 after installation.
+- **`/setup-memory` workflow**: Fixed stale references, now uses correct scripts (session_init.py, memory_manager.py).
+- **`/setup` workflow**: Added memory system troubleshooting section with Docker/Ollama/collection init commands.
+
+### Fixed
+
+- **Stale script references**: `/setup-memory` workflow referenced non-existent `init_memory_system.py` and `memory_middleware.py` — now correctly uses `session_init.py` and `memory_manager.py`.
+- **Memory system unused**: Despite being installed, no agent instructions explicitly told agents WHEN to call the memory scripts. Now enforced via Session Boot Protocol at top of AGENTS.md.
+- **`platform_setup.py` missing memory**: Setup wizard reported platform features but ignored Qdrant/Ollama status — now detects and recommends fixes.
+- **`info` action missing**: Platform setup wizard didn't handle informational recommendations (e.g., "collections are empty") — added `info` action type with ℹ️ status icon.
+- **Templates missing execution scripts**: NPX init created the `execution/` directory but didn't copy any scripts into it — now ships session_boot.py, session_init.py, and memory_manager.py.
+
 ## [1.1.7] - 2026-02-07
 
 ### Added
 
+- **NotebookLM RAG Skill** (EC Scoped): New `notebooklm-rag` skill providing deep-search RAG capabilities powered by Google NotebookLM + Gemini 2.5. Complementary to `qdrant-memory` for explicit, document-grounded research.
+  - **B.L.A.S.T. Protocol**: Structured research workflow (Browse → Load → Ask → Synthesize → Transfer).
+  - **4 Research Modes**: Quick (single query), Deep (3-5 iterative), Cross-Ref (multi-notebook), Plan (doc-grounded planning).
+  - **Confidence Classification**: Automatic HIGH/MEDIUM/LOW categorization with source attribution.
+  - `scripts/research_query.py` — Generates structured research questions by mode.
+  - `scripts/research_report.py` — Formats findings into Markdown/JSON reports with confidence levels and knowledge gap analysis.
+  - `scripts/preflight_check.py` — Pre-flight validation checklist for MCP server, auth, and library.
+  - `references/research_patterns.md` — Workflow templates, query optimization, rate limit strategies.
 - **Auto-Update in Skill Creator**: `init_skill.py` now auto-runs `update_catalog.py` and `sync_docs.py` after creating a new skill.
   - Default ON — use `--no-auto-update` to skip.
   - New `--skills-dir` flag for specifying catalog update target directory.
@@ -20,7 +161,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Skill Creator Documentation** (`SKILL_skillcreator.md`):
   - Step 3: Documents new auto-update behavior and `--no-auto-update` / `--skills-dir` flags.
   - Step 6: Notes that manual catalog update is now only needed for modifications/deletions.
-- **SKILLS_CATALOG.md**: Regenerated with 45 public skills.
+- **SKILLS_CATALOG.md**: Regenerated with 55 skills including `notebooklm-rag`.
 
 ### Fixed
 

package/README.md

@@ -7,6 +7,8 @@
 
 `@techwavedev/agi-agent-kit` is a modular, deterministic framework designed to bridge the gap between LLM reasoning and reliable production execution. It scaffolds a "3-Layer Architecture" (Intent → Orchestration → Execution) that forces agents to use tested scripts rather than hallucinating code.
 
+**v1.2.6** — Now with platform-adaptive orchestration and integrated semantic memory across Claude Code, Kiro IDE, Gemini, and Opencode.
+
 ---
 
 ## 🚀 Quick Start
@@ -23,18 +25,62 @@ You'll be prompted to choose a pack:
 - **knowledge** - Core + 36 specialized skills (API, Security, Design, Architecture)
 - **full** - Complete suite with `.agent/` structure (agents, workflows, rules)
 
+After installation, run the **one-shot setup wizard** to auto-configure your environment:
+
+```bash
+python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir .
+```
+
+This detects your platform, scans the project stack, and configures everything with a single confirmation.
+
+Then **boot the memory system** for automatic token savings:
+
+```bash
+python3 execution/session_boot.py --auto-fix
+```
+
+This checks Qdrant, Ollama, embedding models, and collections — auto-fixing any issues.
+
 ---
 
 ## ✨ Key Features
 
-| Feature                     | Description                                                                |
-| --------------------------- | -------------------------------------------------------------------------- |
-| **Deterministic Execution** | Separates business logic (Python scripts) from AI reasoning (Directives)   |
-| **Modular Skill System**    | Plug-and-play capabilities that can be added or removed instantly          |
-| **Semantic Memory**         | Built-in Qdrant-powered memory with 95% token savings via caching          |
-| **Universal Compatibility** | Works with Claude, Gemini, and OpenAI via standardized context files       |
-| **Self-Healing Workflows**  | Agents read error logs, patch scripts, and update directives automatically |
-| **Self-Update**             | Update to the latest version with a single command                         |
+| Feature                       | Description                                                                 |
+| ----------------------------- | --------------------------------------------------------------------------- |
+| **Deterministic Execution**   | Separates business logic (Python scripts) from AI reasoning (Directives)    |
+| **Modular Skill System**      | 56 plug-and-play skills that can be added or removed instantly              |
+| **Platform-Adaptive**         | Auto-detects and optimizes for Claude Code, Kiro IDE, Gemini, and Opencode  |
+| **Multi-Agent Orchestration** | Agent Teams, subagents, Powers, or sequential personas — adapts to platform |
+| **Semantic Memory**           | Built-in Qdrant-powered memory with 95% token savings via caching           |
+| **Deep RAG (NotebookLM)**     | Opt-in autonomous research via Google NotebookLM + Gemini, fully MCP-driven |
+| **Self-Healing Workflows**    | Agents read error logs, patch scripts, and update directives automatically  |
+| **One-Shot Setup**            | Platform detection + project stack scan + auto-configuration in one command |
+
+---
+
+## 🌐 Platform Support
+
+The framework automatically detects your AI coding environment and activates the best available features:
+
+| Platform        | Orchestration Strategy              | Key Features                                 |
+| --------------- | ----------------------------------- | -------------------------------------------- |
+| **Claude Code** | Agent Teams (parallel) or Subagents | Plugins, marketplace, LSP, hooks             |
+| **Kiro IDE**    | Powers + Autonomous Agent (async)   | Dynamic MCP loading, hooks, cross-repo tasks |
+| **Gemini**      | Sequential personas via `@agent`    | Skills, MCP servers, execution scripts       |
+| **Opencode**    | Sequential personas via `@agent`    | Skills, MCP servers, providers               |
+
+Run `/setup` to auto-detect and configure your platform, or use the setup script directly:
+
+```bash
+# Interactive (one Y/n question)
+python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir .
+
+# Auto-apply everything
+python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir . --auto
+
+# Preview without changes
+python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir . --dry-run
+```
 
 ---
 
@@ -43,16 +89,25 @@ You'll be prompted to choose a pack:
 ```
 your-project/
 ├── AGENTS.md              # Master instruction file (symlinked to GEMINI.md, CLAUDE.md)
-├── skills/                # Pre-built tools
+├── skills/                # 56 pre-built tools
 │   ├── webcrawler/        # Documentation harvesting
 │   ├── pdf-reader/        # PDF text extraction
 │   ├── qdrant-memory/     # Semantic caching & memory
 │   ├── documentation/     # Auto-documentation maintenance
-│   └── self-update/       # Framework self-update capability
+│   ├── plugin-discovery/  # Platform detection & setup wizard
+│   ├── parallel-agents/   # Multi-agent orchestration
+│   ├── intelligent-routing/ # Smart agent selection & routing
+│   ├── self-update/       # Framework self-update capability
+│   └── ...                # 48 more specialized skills
 ├── directives/            # SOPs in Markdown
+│   └── memory_integration.md  # Memory protocol reference
 ├── execution/             # Deterministic Python scripts
+│   ├── session_boot.py    # Session startup (Qdrant + Ollama check)
+│   ├── session_init.py    # Collection initializer
+│   └── memory_manager.py  # Store/retrieve/cache operations
 ├── skill-creator/         # Tools to create new skills
 └── .agent/                # (full pack) Agents, workflows, rules
+    └── workflows/         # /setup, /deploy, /test, /debug, etc.
 ```
 
 ---
@@ -68,6 +123,7 @@ The system operates on three layers:
 ├─────────────────────────────────────────────────────────┤
 │  Layer 2: ORCHESTRATION (Agent)                         │
 │  └─ LLM reads directive, decides which tool to call     │
+│  └─ Platform-adaptive: Teams, Subagents, or Personas    │
 ├─────────────────────────────────────────────────────────┤
 │  Layer 3: EXECUTION (Code)                              │
 │  └─ Pure Python scripts (execution/) do the actual work │
@@ -78,16 +134,58 @@ The system operates on three layers:
 
 ---
 
+## 🧠 Semantic Memory
+
+Built-in Qdrant-powered memory with automatic token savings:
+
+| Scenario              | Without Memory | With Memory | Savings  |
+| --------------------- | -------------- | ----------- | -------- |
+| Repeated question     | ~2000 tokens   | 0 tokens    | **100%** |
+| Similar architecture  | ~5000 tokens   | ~500 tokens | **90%**  |
+| Past error resolution | ~3000 tokens   | ~300 tokens | **90%**  |
+
+**Setup** (requires [Qdrant](https://qdrant.tech/) + [Ollama](https://ollama.com/)):
+
+```bash
+# Start Qdrant
+docker run -d -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant
+
+# Start Ollama + pull embedding model
+ollama serve &
+ollama pull nomic-embed-text
+
+# Boot memory system (auto-creates collections)
+python3 execution/session_boot.py --auto-fix
+```
+
+Agents automatically run `session_boot.py` at session start (first instruction in `AGENTS.md`). Memory operations:
+
+```bash
+# Auto-query (check cache + retrieve context)
+python3 execution/memory_manager.py auto --query "your task summary"
+
+# Store a decision
+python3 execution/memory_manager.py store --content "what was decided" --type decision
+
+# Health check
+python3 execution/memory_manager.py health
+```
+
+---
+
 ## ⚡ Prerequisites
 
+The `npx init` command automatically creates a `.venv` and installs all dependencies. Just activate it:
+
 ```bash
-pip install requests beautifulsoup4 html2text lxml qdrant-client
+source .venv/bin/activate   # macOS/Linux
+# .venv\Scripts\activate    # Windows
 ```
 
-Optional (for semantic memory with local embeddings):
+If you need to reinstall or update dependencies:
 
 ```bash
-pip install ollama sentence-transformers
+.venv/bin/pip install -r requirements.txt
 ```
 
 ---
@@ -100,6 +198,12 @@ pip install ollama sentence-transformers
 npx @techwavedev/agi-agent-kit init --pack=full
 ```
 
+### Auto-detect platform and configure environment
+
+```bash
+python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir .
+```
+
 ### Update to latest version
 
 ```bash
@@ -108,6 +212,12 @@ npx @techwavedev/agi-agent-kit@latest init --pack=full
 python3 skills/self-update/scripts/update_kit.py
 ```
 
+### Boot memory system
+
+```bash
+python3 execution/session_boot.py --auto-fix
+```
+
 ### System health check
 
 ```bash
@@ -128,17 +238,87 @@ python3 skill-creator/scripts/update_catalog.py --skills-dir skills/
 
 ---
 
+## 🎯 Activation Reference
+
+Use these keywords, commands, and phrases to trigger specific capabilities:
+
+### Slash Commands (Workflows)
+
+| Command         | What It Does                                     |
+| --------------- | ------------------------------------------------ |
+| `/setup`        | Auto-detect platform and configure environment   |
+| `/setup-memory` | Initialize Qdrant + Ollama memory system         |
+| `/create`       | Start interactive app builder dialogue           |
+| `/plan`         | Create a structured project plan (no code)       |
+| `/enhance`      | Add or update features in existing app           |
+| `/debug`        | Activate systematic debugging mode               |
+| `/test`         | Generate and run tests                           |
+| `/deploy`       | Pre-flight checks + deployment                   |
+| `/orchestrate`  | Multi-agent coordination for complex tasks       |
+| `/brainstorm`   | Structured brainstorming with multiple options   |
+| `/preview`      | Start/stop local dev server                      |
+| `/status`       | Show project progress and status board           |
+| `/update`       | Update AGI Agent Kit to latest version           |
+| `/checkup`      | Verify agents, workflows, skills, and core files |
+
+### Agent Mentions (`@agent`)
+
+| Mention                | Specialist              | When To Use                               |
+| ---------------------- | ----------------------- | ----------------------------------------- |
+| `@orchestrator`        | Multi-agent coordinator | Complex multi-domain tasks                |
+| `@project-planner`     | Planning specialist     | Roadmaps, task breakdowns, phase planning |
+| `@frontend-specialist` | UI/UX architect         | Web interfaces, React, Next.js            |
+| `@mobile-developer`    | Mobile specialist       | iOS, Android, React Native, Flutter       |
+| `@backend-specialist`  | API/DB engineer         | Server-side, databases, APIs              |
+| `@security-auditor`    | Security expert         | Vulnerability scanning, audits, hardening |
+| `@debugger`            | Debug specialist        | Complex bug investigation                 |
+| `@game-developer`      | Game dev specialist     | 2D/3D games, multiplayer, VR/AR           |
+
+### Skill Trigger Keywords (Natural Language)
+
+| Category          | Trigger Words / Phrases                                               | Skill Activated                     |
+| ----------------- | --------------------------------------------------------------------- | ----------------------------------- |
+| **Memory**        | "don't use cache", "no cache", "skip memory", "fresh"                 | Memory opt-out                      |
+| **Research**      | "research my docs", "deep search", "@notebooklm", "query my notebook" | `notebooklm-rag` (Deep RAG)         |
+| **Documentation** | "update docs", "regenerate catalog", "sync documentation"             | `documentation`                     |
+| **Quality**       | "lint", "format", "check", "validate", "static analysis"              | `lint-and-validate`                 |
+| **Testing**       | "write tests", "run tests", "TDD", "test coverage"                    | `testing-patterns` / `tdd-workflow` |
+| **Architecture**  | "design system", "architecture decision", "ADR", "trade-off"          | `architecture`                      |
+| **Security**      | "security scan", "vulnerability", "audit", "OWASP"                    | `red-team-tactics`                  |
+| **Performance**   | "lighthouse", "bundle size", "core web vitals", "profiling"           | `performance-profiling`             |
+| **Design**        | "design UI", "color scheme", "typography", "layout"                   | `frontend-design`                   |
+| **Deployment**    | "deploy", "rollback", "release", "CI/CD"                              | `deployment-procedures`             |
+| **API**           | "REST API", "GraphQL", "tRPC", "API design"                           | `api-patterns`                      |
+| **Database**      | "schema design", "migration", "query optimization"                    | `database-design`                   |
+| **Planning**      | "plan this", "break down", "task list", "requirements"                | `plan-writing`                      |
+| **Brainstorming** | "explore options", "what are the approaches", "pros and cons"         | `brainstorming`                     |
+| **Code Review**   | "review this", "code quality", "best practices"                       | `code-review-checklist`             |
+| **i18n**          | "translate", "localization", "RTL", "locale"                          | `i18n-localization`                 |
+
+### Memory System Commands
+
+| What You Want                | Command / Phrase                                                                 |
+| ---------------------------- | -------------------------------------------------------------------------------- |
+| **Boot memory**              | `python3 execution/session_boot.py --auto-fix`                                   |
+| **Check before a task**      | `python3 execution/memory_manager.py auto --query "..."`                         |
+| **Store a decision**         | `python3 execution/memory_manager.py store --content "..." --type decision`      |
+| **Cache a response**         | `python3 execution/memory_manager.py cache-store --query "..." --response "..."` |
+| **Health check**             | `python3 execution/memory_manager.py health`                                     |
+| **Skip cache for this task** | Say "fresh", "no cache", or "skip memory" in your prompt                         |
+
+---
+
 ## 📚 Documentation
 
 - **[AGENTS.md](./AGENTS.md)** - Complete architecture and operating principles
-- **[skills/SKILLS_CATALOG.md](./skills/SKILLS_CATALOG.md)** - All available skills
+- **[skills/SKILLS_CATALOG.md](./skills/SKILLS_CATALOG.md)** - All 56 available skills
 - **[CHANGELOG.md](./CHANGELOG.md)** - Version history
 
 ---
 
 ## 🛡️ Security
 
-This package includes a pre-flight security scanner (`verify_public_release.py`) that checks for private terms before publishing. All templates are sanitized for public use.
+This package includes a pre-flight security scanner that checks for private terms before publishing. All templates are sanitized for public use.
 
 ---
 

package/bin/init.js

@@ -19,6 +19,7 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const { execSync } = require('child_process');
 
 // Color utilities for terminal output
 const colors = {
@@ -248,6 +249,24 @@ function copyBaseFiles(targetPath, templatesPath, options) {
     }
   }
   
+  // Copy execution scripts (memory system)
+  const srcExecution = path.join(templatesPath, 'base', 'execution');
+  const destExecution = path.join(targetPath, 'execution');
+  
+  if (fs.existsSync(srcExecution)) {
+    copyDirSync(srcExecution, destExecution);
+    log.success('Installed execution/ (memory system scripts)');
+  }
+  
+  // Copy directives
+  const srcDirectives = path.join(templatesPath, 'base', 'directives');
+  const destDirectives = path.join(targetPath, 'directives');
+  
+  if (fs.existsSync(srcDirectives)) {
+    copyDirSync(srcDirectives, destDirectives);
+    log.success('Installed directives/');
+  }
+  
   // Copy skill-creator
   const srcSkillCreator = path.join(templatesPath, 'base', 'skill-creator');
   const destSkillCreator = path.join(targetPath, 'skill-creator');
@@ -304,6 +323,120 @@ function copyAgentStructure(targetPath, templatesPath) {
   }
 }
 
+// Setup Python virtual environment and install dependencies
+function setupPythonEnv(targetPath) {
+  log.header('Setting up Python environment...');
+  
+  const venvPath = path.join(targetPath, '.venv');
+  const requirementsPath = path.join(targetPath, 'requirements.txt');
+  
+  // Skip if venv already exists
+  if (fs.existsSync(venvPath)) {
+    log.info('Python .venv already exists, skipping creation');
+    return;
+  }
+  
+  // Check if requirements.txt exists
+  if (!fs.existsSync(requirementsPath)) {
+    log.warn('requirements.txt not found, skipping Python setup');
+    return;
+  }
+  
+  // Detect Python
+  let pythonCmd = null;
+  for (const cmd of ['python3', 'python']) {
+    try {
+      execSync(`${cmd} --version`, { stdio: 'pipe' });
+      pythonCmd = cmd;
+      break;
+    } catch (e) {
+      // try next
+    }
+  }
+  
+  if (!pythonCmd) {
+    log.warn('Python not found. Install Python 3.8+ and run:');
+    console.log(`     ${colors.yellow}python3 -m venv .venv${colors.reset}`);
+    console.log(`     ${colors.yellow}source .venv/bin/activate${colors.reset}`);
+    console.log(`     ${colors.yellow}pip install -r requirements.txt${colors.reset}`);
+    return;
+  }
+  
+  // Create venv
+  try {
+    log.info(`Creating .venv with ${pythonCmd}...`);
+    execSync(`${pythonCmd} -m venv "${venvPath}"`, { stdio: 'pipe' });
+    log.success('Created .venv/');
+  } catch (e) {
+    log.warn(`Failed to create venv: ${e.message}`);
+    console.log(`     Try manually: ${colors.yellow}${pythonCmd} -m venv .venv${colors.reset}`);
+    return;
+  }
+  
+  // Determine pip path (cross-platform)
+  const isWindows = process.platform === 'win32';
+  const pipPath = isWindows
+    ? path.join(venvPath, 'Scripts', 'pip')
+    : path.join(venvPath, 'bin', 'pip');
+  
+  // Install dependencies
+  try {
+    log.info('Installing Python dependencies...');
+    execSync(`"${pipPath}" install -r "${requirementsPath}"`, {
+      stdio: 'pipe',
+      timeout: 300000 // 5 min timeout
+    });
+    log.success('All Python dependencies installed');
+  } catch (e) {
+    log.warn('Some dependencies may have failed to install');
+    console.log(`     Run manually: ${colors.yellow}${isWindows ? '.venv\\Scripts\\pip' : '.venv/bin/pip'} install -r requirements.txt${colors.reset}`);
+  }
+  
+  // Show activation hint
+  const activateCmd = isWindows ? '.venv\\Scripts\\activate' : 'source .venv/bin/activate';
+  log.info(`Activate with: ${colors.yellow}${activateCmd}${colors.reset}`);
+}
+
+// Auto-run platform setup wizard to pre-configure environment
+function runPlatformSetup(targetPath) {
+  const setupScript = path.join(targetPath, 'skills', 'plugin-discovery', 'scripts', 'platform_setup.py');
+  
+  if (!fs.existsSync(setupScript)) {
+    return; // Skill not installed (e.g. core pack)
+  }
+  
+  log.header('Running platform setup wizard...');
+  
+  // Use venv python if available, otherwise system python
+  const isWindows = process.platform === 'win32';
+  const venvPython = isWindows
+    ? path.join(targetPath, '.venv', 'Scripts', 'python')
+    : path.join(targetPath, '.venv', 'bin', 'python3');
+  const pythonCmd = fs.existsSync(venvPython) ? `"${venvPython}"` : 'python3';
+  
+  try {
+    const output = execSync(
+      `${pythonCmd} "${setupScript}" --project-dir "${targetPath}" --auto`,
+      { stdio: 'pipe', timeout: 30000 }
+    ).toString();
+    
+    // Show output
+    console.log(output);
+  } catch (e) {
+    // If --auto flag fails, try with piped stdin
+    try {
+      const output = execSync(
+        `${pythonCmd} "${setupScript}" --project-dir "${targetPath}"`,
+        { stdio: 'pipe', timeout: 30000, input: 'y\n' }
+      ).toString();
+      console.log(output);
+    } catch (e2) {
+      log.warn('Platform setup wizard could not auto-run');
+      console.log(`     Run manually: ${colors.yellow}python3 skills/plugin-discovery/scripts/platform_setup.py --project-dir .${colors.reset}`);
+    }
+  }
+}
+
 // Main init function
 async function init(options) {
   log.header('🚀 AGI Agent Kit Initializer');
@@ -348,15 +481,23 @@ async function init(options) {
     copyAgentStructure(options.path, templatesPath);
   }
   
+  // Setup Python environment
+  setupPythonEnv(options.path);
+  
+  // Auto-run platform setup wizard
+  runPlatformSetup(options.path);
+  
   // Final message
   log.header('✨ Installation complete!');
   console.log(`
 Next steps:
-  1. Review ${colors.cyan}AGENTS.md${colors.reset} for architecture overview
-  2. Install Python dependencies:
-     ${colors.yellow}pip install requests beautifulsoup4 html2text lxml qdrant-client${colors.reset}
-  3. Check ${colors.cyan}skills/${colors.reset} for available capabilities
-  4. Create ${colors.cyan}.env${colors.reset} with your API keys
+  1. Activate the Python environment:
+     ${colors.yellow}source .venv/bin/activate${colors.reset}
+  2. Review ${colors.cyan}AGENTS.md${colors.reset} for architecture overview
+  3. Boot the memory system (optional, requires Qdrant + Ollama):
+     ${colors.yellow}python3 execution/session_boot.py --auto-fix${colors.reset}
+  4. Check ${colors.cyan}skills/${colors.reset} for available capabilities
+  5. Create ${colors.cyan}.env${colors.reset} with your API keys
   
 Happy coding! 🎉
 `);
@@ -430,6 +571,14 @@ async function update(options) {
       console.log(`  ${colors.green}✔${colors.reset} Updated skill-creator/`);
   }
 
+  // 3b. Update Execution Scripts (memory system)
+  const srcExec = path.join(templatesPath, 'base', 'execution');
+  const destExec = path.join(options.path, 'execution');
+  if (fs.existsSync(srcExec)) {
+      copyDirSync(srcExec, destExec);
+      console.log(`  ${colors.green}✔${colors.reset} Updated execution/ (memory system scripts)`);
+  }
+
   // 4. Update Core Documentation if needed
   // We generally respect user's AGENTS.md, but maybe we update GEMINI.md/CLAUDE.md symlinks?
   if (options.symlinks) {