decision-graph-analyzer

Analyze AI Counsel decision graphs to retrieve deliberations and detect patterns.

1|1|Updated Oct 13, 2025
One-click install
npx skills add https://github.com/blueman82/ai-counsel --skill decision-graph-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-graph-analyzer
Source: https://github.com/blueman82/ai-counsel/tree/main/.claude/skills/decision-graph-analyzer
Command: npx skills add https://github.com/blueman82/ai-counsel --skill decision-graph-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sentence-transformers.

What problem does it solve?

Understanding past AI decisions, finding relevant context, identifying patterns, and debugging the decision graph memory system can be complex and time-consuming. This skill provides tools and patterns to effectively query, analyze, and troubleshoot the AI Counsel's institutional memory.

Core Features & Use Cases

  • Similar Decision Retrieval: Find and inject context from past deliberations semantically related to a new question.
  • Database Statistics & Health: Monitor the growth, check the integrity, and debug performance of the SQLite-based decision graph.
  • Cache Performance Analysis: Analyze L1/L2 cache hit rates to optimize query latency and memory usage.
  • Tiered Context Formatting: Understand how context is formatted (strong, moderate, brief) based on similarity and token budget.
  • Use Case: Before starting a new deliberation on "Should we use GraphQL?", use this skill to query the decision graph for similar past debates, injecting relevant context to accelerate convergence and avoid re-hashing old arguments.

Quick Start

To find past deliberations related to a specific topic, use the query_decisions tool with the search_similar operation. For example: mcp__ai-counsel__query_decisions({ query: "database choice", operation: "search_similar", limit: 5 })

Frequently Asked Questions about decision-graph-analyzer

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

FAQPage Schema
How do I find past AI decisions similar to a new question I'm deliberating?

Similar decision retrieval uses semantic search to query your decision graph and surface past deliberations related to your current topic. Search by query term—for example, "database choice"—to retrieve contextually relevant past debates and inject their outcomes into your current reasoning.

What's the best way to debug and monitor my decision graph database performance?

Database statistics and health checks analyze your SQLite-based decision graph to monitor growth, verify integrity, and measure cache performance. Use health_check and get_graph_stats methods to identify bottlenecks and optimize query latency.

Can I use semantic search to retrieve and inject context from stored deliberations?

Yes. The retrieval layer applies two-tier caching and adaptive k retrieval with noise floor filtering to fetch semantically similar past deliberations and format them at tiered detail levels based on token budget and relevance.

How do I identify contradictions or detect evolution in past AI decisions?

Query your decision graph to surface patterns across participant stances and deliberation history. The analysis layer detects when similar topics generated conflicting conclusions or evolved reasoning over time, surfacing drift in decision logic.

What does the decision graph store, and how is it structured?

The decision graph is a SQLite3 database with three core tables: decision_nodes (deliberations and outcomes), participant_stances (positions taken), and decision_similarities (semantic relationships). This schema enables retrieval, pattern detection, and context injection for new deliberations.

Do I need to understand sentence embeddings to use semantic search on my decisions?

No. The semantic search layer abstracts embedding generation via sentence-transformers. You query by natural language topic; the system handles vectorization, similarity scoring, and ranking automatically.