@nbiish/cognitive-tools-mcp 8.8.4 → 8.9.3

package/README.md

@@ -22,7 +22,7 @@
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
 </div>
 
-Revolutionary MCP server with Enhanced 6-Stage Cognitive Deliberation Framework. The `deliberate` tool combines Scientific Investigation, OOReD analysis, and Critical Thinking methodologies with **DYNAMIC prompting strategy evaluation** (Chain-of-Thought, Tree-of-Thoughts, Self-Consistency, Meta-Prompting, Role-Based) - strategies are now evaluated in-prompt with 0.00-1.00 scoring based on actual task context. *(Integration guidelines in [`latest.md`](latest.md) are licensed under [LICENSE](LICENSE).)*
+Revolutionary MCP server with Enhanced 2-Round, 6-Stage Cognitive Deliberation Framework (v8.9.2). The `deliberate` tool implements an **advanced guided notepad** approach with **dynamic prompting strategy evaluation from modern-prompting.mdc** - featuring **MINIMAL filler verbiage** and **maximum LLM freedom** accepting only `input` and `context` parameters. *(Integration guidelines in [`latest.md`](latest.md) are licensed under [LICENSE](LICENSE).)*
 
 Known as:
 - Anishinaabemowin: [`@nbiish/gikendaasowin-aabajichiganan-mcp`](https://www.npmjs.com/package/@nbiish/gikendaasowin-aabajichiganan-mcp)
@@ -38,7 +38,7 @@ Both packages are maintained in parallel and receive the same updates. You can u
 
 ## ᐴ REPOSITORY STRUCTURE ᔔ [MAZINAAZIWIN] ◈──◆──◇──◆──◈
 
-Current repository structure (v8.8.3):
+Current repository structure (v8.9.2):
 
 ```text
 .
@@ -63,6 +63,7 @@ Current repository structure (v8.8.3):
 ├── package-cognitive-tools.json # English package configuration
 ├── package-gikendaasowin.json  # Anishinaabemowin package configuration
 ├── package.json               # Main package configuration
+├── PRD.md                     # Product Requirements Document
 ├── publish-both-packages.sh   # Dual publishing script
 ├── qr-stripe-donation.png     # Donation QR code
 ├── README.md                  # This file
@@ -75,37 +76,33 @@ Current repository structure (v8.8.3):
 
 ## ᐴ GASHKITOONAN ᔔ [ENHANCED CAPABILITIES] ◈──◆──◇──◆──◈
 
-### 🚀 Revolutionary 6-Stage Cognitive Framework
+### 🚀 Revolutionary 2-Round, 6-Stage Cognitive Framework (v8.9.2)
 
-**Stage 1: Scientific Investigation** (Chain-of-Thought + Role-Based)
-- Systematic hypothesis formation using scientific method
-- Expert domain perspective integration
-- Step-by-step reasoning for complex problem decomposition
+**NEW IN v8.9.2: ADVANCED GUIDED NOTEPAD APPROACH**
 
-**Stage 2: Initial OOReD** (Tree-of-Thoughts + Meta-Prompting)
-- Multiple parallel reasoning paths exploration
-- Self-reflection on reasoning quality and consistency  
-- Alternative solution pathway evaluation
+- **LLM Freedom:** Tool accepts only `input` and `context` - no mode parameter needed
+- **Zero Filler Verbiage:** No formatting constraints, headers, or verbose output
+- **Dynamic Strategy Selection:** Evaluates modern-prompting.mdc strategies with 0.00-1.00 rating system
+- **Auto-Mode Detection:** Automatically determines analyze/decide/synthesize/evaluate approach
+- **Pure Cognitive Output:** Raw cognitive processing results for maximum LLM flexibility
 
-**Stage 3: Critical Thinking + Pre-Act** (Self-Consistency + Meta-Prompting)
-- 10-step critical thinking framework application
-- Multiple validation approaches for reliability
-- Pre-action planning with tool identification
+**2-Round Processing Architecture:**
 
-**Stage 4: Scientific Review** (Chain-of-Thought + Self-Consistency)  
-- Systematic review of initial investigation findings
-- Cross-validation using multiple approaches
-- Enhanced evidence quality assessment
+**Round 1: Foundation Building**
+- **Stage 1: Scientific Investigation** - Systematic hypothesis formation with scientific method
+- **Stage 2: Initial OOReD** - Multiple reasoning path exploration with Tree-of-Thoughts
 
-**Stage 5: OOReD Review** (Tree-of-Thoughts + Role-Based)
-- Multi-path refinement of reasoning processes
-- Expert domain perspectives integration
-- Cross-stage consistency optimization
+**Round 2: Refinement & Action**
+- **Stage 3: Critical Thinking + Pre-Act** - 10-step framework with tool identification
+- **Stage 4: Scientific Review** - Cross-validation of investigation findings
+- **Stage 5: OOReD Review** - Multi-path reasoning refinement
+- **Stage 6: Final Action** - Comprehensive synthesis with actionable recommendations
 
-**Stage 6: Final Action** (All Strategies Integrated)
-- Comprehensive synthesis of all previous stages
-- Fact-based actionable recommendations
-- Complete quality assurance and validation
+**Dynamic Strategy Integration:**
+- Evaluates all modern-prompting.mdc strategies during Orient stage
+- Assigns solution level (0.00-0.99) + efficiency level (0.00-0.99) ratings
+- Uses strategies with combined rating ≥1.42 (combines multiple if ≥1.53)
+- Includes natural "tool use before re-deliberation: X" count in output
 
 <div align="center">
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
@@ -113,33 +110,33 @@ Current repository structure (v8.8.3):
 
 ## ᐴ APITENDAAGOZIJIG ᔔ [PERFORMANCE METRICS] ◈──◆──◇──◆──◈
 
-- **Enhanced Reliability:** 45-60% error reduction through 6-stage validation
-- **Improved Depth:** 95% comprehensive coverage with scientific rigor  
-- **Better Actionability:** 88% actionable recommendations with implementation roadmaps
-- **Quality Assurance:** 94% validation success rate with cross-stage consistency
+- **Dynamic Strategy Selection:** Evaluates 15+ modern prompting strategies with quantitative rating
+- **2-Round Processing:** Foundation building + refinement for comprehensive analysis
+- **Enhanced Reliability:** Multi-stage validation reduces cognitive errors significantly
+- **Maximum LLM Freedom:** Zero formatting constraints allow natural AI expression
+- **Tool Integration:** Natural count suggestions for optimal re-deliberation timing
 
 <div align="center">
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
 </div>
 
-## 🚀 NEW: Dynamic Prompting Strategy Evaluation (v8.0.1)
+## 🚀 Advanced Guided Notepad Approach (v8.9.2)
 
-**Revolutionary Update:** The system now evaluates prompting strategies **in-prompt** based on actual task context rather than using hardcoded scores.
+This revolutionary update transforms the deliberation tool into an "advanced guided notepad" that provides cognitive enhancement without constraining AI creativity.
 
-### Key Improvements:
+### Core Innovation
 
-- **Context-Aware Selection:** Strategies are scored 0.00-1.00 based on actual input complexity, task requirements, and available context
-- **Dynamic Optimization:** Only strategies scoring ≥1.38 (solution + efficiency) are selected for each specific task
-- **Task-Specific Adaptation:** Different strategies are preferred for coding vs. analysis vs. creative vs. decision tasks
-- **Efficiency Optimization:** Avoids computational overhead by selecting appropriate strategies for simple vs. complex tasks
+**Pure Cognitive Processing:** The tool now provides generations of cognitive techniques as "hints" to process thoughts better, backed by research and rigor, while allowing LLMs complete freedom in output construction.
 
-### Example Dynamic Evaluation:
-- Simple coding tasks → PAL (Program-Aided Language) gets higher efficiency scores
-- Complex analysis tasks → Tree-of-Thoughts gets higher solution scores  
-- Decision-making tasks → Self-Consistency gets prioritized for validation
-- Large context tasks → Context-Compression becomes highly efficient
+### Processing Architecture
 
-This makes the deliberation tool truly adaptive and intelligent for each specific use case!
+1. **Input Analysis:** Auto-determines optimal cognitive processing approach (analyze/decide/synthesize/evaluate)
+2. **Round 1:** Scientific Investigation + Initial OOReD (internal cognitive processing)
+3. **Round 2:** Critical Thinking + Reviews + Final Action (internal cognitive processing)
+4. **Strategy Selection:** Evaluates modern-prompting.mdc techniques with quantitative ratings
+5. **Output:** Concise cognitive results + tool usage recommendations
+
+This approach enables LLMs to leverage advanced cognitive frameworks while maintaining their natural problem-solving flow!
 
 <div align="center">
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
@@ -191,11 +188,14 @@ Add to your `claude_desktop_config.json`:
 
 ### Available Tools
 
-**`deliberate`** - Enhanced 6-Stage Cognitive Processing Engine
+**`deliberate`** - Advanced 2-Round, 6-Stage Cognitive Processing Engine (v8.9.2)
 
-- **Modes:** analyze, decide, synthesize, evaluate
-- **Input:** Complex problems requiring comprehensive cognitive analysis
-- **Output:** Six-stage structured analysis with actionable recommendations
+- **Input Parameters:**
+  - `input` (required): The problem, question, or situation needing cognitive deliberation
+  - `context` (optional): Additional background information or constraints
+- **Auto-Processing:** Automatically determines optimal cognitive approach and selects best prompting strategies
+- **Output:** Pure cognitive processing results with natural tool usage count integration
+- **Features:** Dynamic strategy evaluation, 2-round processing architecture, zero filler verbiage approach
 
 <div align="center">
 ╭────────────[ ◈◆◇ CITATION ◇◆◈ ]─────────────╮
@@ -221,7 +221,7 @@ Please cite this project using the following BibTeX entry:
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
 </div>
 
-This project is licensed under the [COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS](LICENSE).
+This project is licensed under the [COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS](LICENSE) and follows [CONTRIBUTING.md](CONTRIBUTING.md) guidelines.
 
 <div align="center">
 ◈──◆──◇─────────────────────────────────────────────────◇──◆──◈