decision-graph-analyzer

Analyze past deliberations in the decision graph for current query context.

1|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/OmarTheGrey/Council-Of-HAL --skill decision-graph-analyzer-omarthegrey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-graph-analyzer
Source: https://github.com/OmarTheGrey/Council-Of-HAL/tree/main/.claude/skills/decision-graph-analyzer
Command: npx skills add https://github.com/OmarTheGrey/Council-Of-HAL --skill decision-graph-analyzer-omarthegrey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI systems often make decisions in isolation, lacking institutional memory. This skill provides tools to query, analyze, and troubleshoot the AI Counsel's decision graph, allowing you to leverage past deliberations for better future outcomes and prevent redundant debates.

Core Features & Use Cases

  • Semantic Search: Find past deliberations semantically similar to new questions, providing valuable context for current decisions.
  • Database Inspection: Retrieve statistics, analyze growth, and validate the health of the decision graph database for optimal performance.
  • Context Injection Debugging: Troubleshoot why context isn't being retrieved or isn't improving deliberation quality, ensuring relevant information is used.
  • Performance Analysis: Monitor and optimize the two-tier caching system for fast retrieval of historical data.
  • Use Case: A new project requires a decision on API architecture. You can use this skill to query the decision graph for similar past discussions, understand previous consensus, and inject that knowledge into the current deliberation, preventing redundant debates.

Quick Start

Show me how to find past deliberations related to 'database migration' from the decision graph and display their consensus.

Frequently Asked Questions about decision-graph-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query past decisions from a decision graph database?

Query the decision graph using semantic search to find past deliberations similar to your current question. The skill retrieves relevant historical decisions from a SQLite backend with adaptive k-nearest neighbor retrieval, two-tier caching, and noise filtering to surface the most applicable context.

Can I use semantic search to find similar past deliberations across projects?

Yes. Semantic search analyzes the decision graph to locate deliberations semantically similar to new queries across all stored projects. This prevents redundant debates and injects relevant historical consensus into current decisions.

What database structure does the decision graph use?

The decision graph uses a SQLite backend with three core tables: decision_nodes storing deliberations, participant_stances capturing positions, and decision_similarities indexing semantic relationships. This structure enables efficient retrieval and maintenance of decision history.

How do I troubleshoot why context isn't improving my AI decisions?

Use context injection debugging endpoints to inspect decision graph statistics, validate database health, and analyze retrieval performance. The skill identifies whether context retrieval is failing, caching is inefficient, or injected context simply lacks relevance to current deliberations.

What performance monitoring does the decision graph provide?

Monitor and optimize the two-tier caching system for fast historical retrieval, inspect database growth statistics, estimate archival benefits, and run health checks. These maintenance endpoints surface performance bottlenecks and inform optimization decisions.

Can I use this skill without existing decision history?

The skill requires a populated decision graph to function meaningfully. You need prior deliberations stored in the SQLite backend to retrieve context; new projects with no history will yield limited semantic search results until decisions accumulate.