Add README and ecosystem links matching SpiralSafe documentation style

AI_AGENTS.md

@@ -2,6 +2,12 @@
 
 *This file tells ALL AI agents (Claude, Ollama, GPT, etc.) where to put things.*
 
+[![SpiralSafe](https://img.shields.io/badge/🌀_SpiralSafe-Ecosystem-purple?style=flat-square)](https://github.com/toolate28/SpiralSafe)
+[![Wave Toolkit](https://img.shields.io/badge/🌊_Wave_Toolkit-Main-0066FF?style=flat-square)](README.md)
+[![HOPE NPCs](https://img.shields.io/badge/🎮_HOPE_NPCs-Minecraft_AI-blue?style=flat-square)](https://github.com/toolate28/ClaudeNPC-Server-Suite)
+
+> **Part of the [SpiralSafe Ecosystem](https://github.com/toolate28/SpiralSafe)**
+
 ---
 
 ## The Golden Rule

README.md

@@ -0,0 +1,231 @@
+# 🌊 Wave Toolkit
+
+> **"From one builder to another - philosophy, mechanics, and everything between."**
+
+![Wave Toolkit](https://img.shields.io/badge/Status-Active-00cc66?style=for-the-badge&logo=github)
+![Version](https://img.shields.io/badge/Version-1.0.0-blue?style=for-the-badge)
+![License](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)
+![Platform](https://img.shields.io/badge/Platform-PowerShell-0078D4?style=for-the-badge&logo=powershell)
+
+Wave Toolkit provides coherence detection tools and AI collaboration patterns for the SpiralSafe ecosystem. It captures environment context, generates system prompts, and enables seamless human-AI collaboration workflows.
+
+[![SpiralSafe Coherence](https://img.shields.io/badge/Coherence-SpiralSafe-purple)](https://github.com/toolate28/SpiralSafe)
+[![Status: Hope&&Sauced](https://img.shields.io/badge/Status-Hope%26%26Sauced-FF6600)](https://github.com/toolate28/SpiralSafe/blob/main/CONTRIBUTING.md)
+
+---
+
+## 🗺️ Navigation
+
+### 📚 Documentation
+
+- **[Wave Guide](wave.md)** — Philosophy, mechanics, and complete workflow guide
+- **[Communication Patterns](communication-patterns.md)** — What makes collaboration flow
+- **[AI Agent Rules](AI_AGENTS.md)** — Coordination rules for all AI agents
+
+### 🔧 Special Docs
+
+- **[T(ai)LS USB](docs/TAILS-USB.md)** — Privacy-first portable AI concept
+- **[Wave Office](docs/WAVE-OFFICE.md)** — Dual agent collaboration (Claude + Ollama)
+- **[Ecosystem Migration Guide](docs/ECOSYSTEM-MIGRATION-GUIDE.md)** — Agent-facing guide for repo transitions
+
+---
+
+## 🌀 The SpiralSafe Ecosystem
+
+Wave Toolkit is part of a unified framework for human-AI collaboration:
+
+| Repository | Purpose | Status |
+|------------|---------|--------|
+| **[SpiralSafe](https://github.com/toolate28/SpiralSafe)** | Documentation hub, coherence engine core | v2.1.0 |
+| **[wave-toolkit](https://github.com/toolate28/wave-toolkit)** | Coherence detection tools (this repo) | v1.0.0 |
+| **[HOPE NPCs](https://github.com/toolate28/ClaudeNPC-Server-Suite)** | AI NPCs for Minecraft | v2.1.0 |
+| **[kenl](https://github.com/toolate28/kenl)** | Infrastructure-aware AI orchestration | v1.0.0 |
+| **[quantum-redstone](https://github.com/toolate28/quantum-redstone)** | Quantum computing education via Redstone | Available |
+
+---
+
+## 🧩 Key Components
+
+| Component | File | Purpose |
+|-----------|------|---------|
+| **Context Capture** | `Get-WaveContext.ps1` | Snapshots your environment dynamically |
+| **Prompt Generator** | `New-ClaudeSystemPrompt.ps1` | Creates context-aware system prompts |
+| **Session Runner** | `Invoke-ClaudeSession.ps1` | Complete session workflow |
+| **Setup Script** | `Setup-Wave.ps1` | One-time bootstrap |
+| **Consolidation** | `Consolidate-Scripts.ps1` | Migrates loose scripts to organized structure |
+| **Logging Module** | `tools/Wave.Logging.psm1` | Centralized logging across the ecosystem |
+
+---
+
+## 📂 Project Structure
+
+```
+wave-toolkit/
+│
+├── 📄 wave.md                    # The complete guide
+├── 📄 communication-patterns.md  # Collaboration patterns
+├── 📄 AI_AGENTS.md               # Agent coordination rules
+│
+├── 📂 docs/                      # Documentation
+│   ├── TAILS-USB.md              # Privacy-first AI concept
+│   └── WAVE-OFFICE.md            # Dual agent collaboration
+│
+├── 📂 tools/                     # Reusable PowerShell modules
+│   └── Wave.Logging.psm1         # Logging across the ecosystem
+│
+├── 📂 scripts/                   # Organized scripts
+│   ├── gaming/                   # Gaming/performance scripts
+│   ├── system/                   # System optimization
+│   ├── deployment/               # Deploy/CI scripts
+│   └── startup/                  # Startup automation
+│
+├── 📂 tests/                     # Pester tests
+│   └── Wave.Logging.Tests.ps1
+│
+├── 📄 Get-WaveContext.ps1        # Context capture
+├── 📄 New-ClaudeSystemPrompt.ps1 # Prompt generation
+├── 📄 Invoke-ClaudeSession.ps1   # Session workflow
+├── 📄 Setup-Wave.ps1             # Bootstrap script
+└── 📄 Consolidate-Scripts.ps1    # Script migration tool
+```
+
+---
+
+## 🚀 Quick Start
+
+### One-Step Install
+
+```powershell
+# Clone the repository
+git clone https://github.com/toolate28/wave-toolkit.git
+cd wave-toolkit
+
+# Run setup
+.\Setup-Wave.ps1
+```
+
+### Usage
+
+```powershell
+# Capture your environment context
+.\Get-WaveContext.ps1
+
+# Start a full session with Claude
+.\Invoke-ClaudeSession.ps1 -Task "Review my API error handling"
+
+# Consolidate loose scripts (if migrating)
+.\Consolidate-Scripts.ps1 -WhatIf  # Preview changes first
+```
+
+---
+
+## 🔧 Core Scripts
+
+### Get-WaveContext.ps1
+
+Captures your current environment dynamically:
+- Machine specs (name, architecture, cores)
+- User context (domain, username, home)
+- Shell environment (PowerShell version, edition)
+- Session context (current directory, git status)
+- Available tools (git, node, python, docker, claude)
+
+### New-ClaudeSystemPrompt.ps1
+
+Generates a system prompt based on current context. Claude sees exactly what environment it's working in.
+
+### Invoke-ClaudeSession.ps1
+
+Complete workflow: captures context → generates prompt → calls Claude → saves log.
+
+```powershell
+.\Invoke-ClaudeSession.ps1 -Task "Help me design a config system"
+```
+
+---
+
+## 📝 Wave.Logging Module
+
+Centralized logging for the SpiralSafe ecosystem. Collects logs from:
+- Gaming performance logs (BF6, etc.)
+- SpiralSafe bridges
+- Quantum-redstone
+- ClaudeNPC server logs
+- ATOM trail
+
+```powershell
+Import-Module .\tools\Wave.Logging.psm1
+
+# Collect all logs to aggregate
+Collect-SpiralLogs -OutputDir "$HOME\.logdy\streams"
+
+# Run self-test
+Test-CollectSpiralLogs
+```
+
+---
+
+## 🤝 The Trust Model
+
+Wave operates on mutual trust:
+
+**You trust Claude to:**
+- Read before writing
+- Explain its reasoning
+- Ask when uncertain
+- Not make destructive changes without confirmation
+
+**Claude trusts you to:**
+- Provide honest context
+- Share what you're actually trying to achieve
+- Course-correct when something's off
+
+**The scripts trust the environment to:**
+- Be honest about what's installed
+- Have standard paths and commands
+- Fail loudly rather than silently
+
+---
+
+## 🧪 Testing
+
+```powershell
+# Run tests with Pester
+Invoke-Pester .\tests\
+```
+
+---
+
+## 🤝 Contributing
+
+We follow **[Hope&&Sauced](https://github.com/toolate28/SpiralSafe/blob/main/CONTRIBUTING.md)** principles.
+
+- **Visible State**: Use `ATOM` tags
+- **Explicit Handoffs**: Use `H&&S:WAVE` markers
+- **Coherence**: Ensure your docs don't "curl"
+
+### AI Agent Rules
+
+All AI agents (Claude, Ollama, GPT, etc.) must follow `AI_AGENTS.md`:
+- **Never** drop scripts directly into `$HOME`
+- Place code in organized directories within `wave-toolkit/`
+- Create modules if reusable, tests if logic exists
+
+---
+
+## Attribution
+
+This work emerges from **Hope&&Sauced** collaboration—human-AI partnership where both contributions are substantive and neither party could have produced the result alone.
+
+- **Human** (toolate28): Vision, trust, pedagogical insight
+- **AI** (Claude): Synthesis, documentation, verification
+
+**The collaboration IS the insight.**
+
+See the [SpiralSafe PORTFOLIO.md](https://github.com/toolate28/SpiralSafe/blob/main/PORTFOLIO.md) for complete ecosystem showcase.
+
+---
+
+*~ Hope&&Sauced*
+
+✦ *The Evenstar Guides Us* ✦

communication-patterns.md

@@ -2,6 +2,11 @@
 
 *What makes collaboration flow - learned through practice.*
 
+[![SpiralSafe](https://img.shields.io/badge/🌀_SpiralSafe-Ecosystem-purple?style=flat-square)](https://github.com/toolate28/SpiralSafe)
+[![Wave Toolkit](https://img.shields.io/badge/🌊_Wave_Toolkit-Main-0066FF?style=flat-square)](README.md)
+
+> **Part of the [SpiralSafe Ecosystem](https://github.com/toolate28/SpiralSafe)**
+
 ---
 
 ## The Patterns