harnessed_reasoning/skill/SKILL.md

name	version	description	trigger_conditions
harnessed-reasoning-module-implementation	1.0.0	Complete production-ready implementation of Hermes Reasoning Engine module with advanced reasoning capabilities, planning, tool coordination, error recovery, and cross-session intelligence.	User requests to implement or extend Hermes Reasoning functionality Task involves AI reasoning engine development Need for context-aware reasoning with safety checks

Harnessed Reasoning Module Implementation Guide

Overview

This skill provides the complete implementation of the Harnessed Reasoning module, which implements advanced reasoning capabilities for the Hermes Agent ecosystem:

• Context-aware reasoning: Combines memory, sessions, and skills for intelligent decision-making
• Task decomposition: Breaks complex requests into executable subtasks
• Tool selection: Automatically selects appropriate tools for each subtask
• Safety checks: Multi-level safety validation (strict/moderate/lenient modes)
• Error recovery: Automatic recovery strategies for failed tool executions
• Cross-session intelligence: Leverages past sessions for better reasoning
• Multi-user isolation: Complete user separation with proper authentication

Module Structure

harnessed_reasoning/
├── harnessed_reasoning/      # Python package
│   ├── __init__.py          # Empty (Python package marker)
│   ├── init.py              # Module initialization with load_harnessed_reasoning()
│   ├── core.py              # Core reasoning engine (HermesReasoningEngine class)
│   └── config_functions.py  # Configuration get/save functions
├── wwwroot/                 # Frontend resources (.ui files)
├── models/                  # Database table definitions (JSON)
├── json/                    # CRUD operation definitions (JSON)
├── init/                    # Initialization data
├── skill/                   # This skill documentation
├── pyproject.toml           # Python packaging
└── README.md                # Module documentation

Database Tables

• harnessed_reasoning_config: User-specific reasoning configuration
• harnessed_reasoning_sessions: Reasoning session records with execution plans

Key Features

1. Reasoning Engine

• Configurable max reasoning steps and tool calls per step
• Intelligent context gathering from memory, sessions, and skills
• Keyword-based tool selection and parameter inference
• Confidence scoring for execution plans

2. Safety System

• Three safety modes: strict, moderate, lenient
• Dangerous command detection for terminal actions
• Path traversal protection for file operations
• User preference enforcement

3. Error Recovery

• Automatic retry with exponential backoff
• Context-aware recovery strategies (e.g., file not found -> search for similar files)
• Configurable max recovery attempts

Configuration

class ReasoningConfig:
    max_reasoning_steps: int = 10
    max_tool_calls_per_step: int = 5
    enable_cross_session_search: bool = True
    enable_skill_auto_loading: bool = True
    safety_mode: str = "strict"
    max_context_tokens: int = 4000
    enable_error_recovery: bool = True
    max_recovery_attempts: int = 3

Exposed Functions

• hermes_reason_and_execute(request, execute_immediately) - Main entry point
• hermes_get_reasoning_session(session_id) - Retrieve session by ID
• hermes_list_reasoning_sessions(limit, offset) - List user sessions
• hermes_get_reasoning_config() - Get default configuration
• hermes_save_reasoning_config(context, config_data) - Save user configuration

Related Skills

• module-development-spec: Module development workflow
• bricks-framework: Frontend development framework
• sqlor-database-module: Database integration patterns
• harnessed-agent-skill-architecture: Dual skill architecture