Files
confidence-engine/.claude/project-context.md
T
2026-08-03 15:51:46 +01:00

2.0 KiB

Project Context

What the Confidence Engine is

The Confidence Engine is a structured reasoning tool intended to help people decide whether they have enough justified confidence to act.

It does not simply answer the user's original question.

It:

  1. reconstructs the situation;
  2. separates observations, assumptions, relationships and unknowns;
  3. creates a structured reasoning graph;
  4. selects the most useful unresolved uncertainty;
  5. asks one simple question;
  6. updates the graph from the answer;
  7. repeats until action is justified or the remaining uncertainty is clear.

A chatbot remembers the conversation.

The Confidence Engine preserves the state of the reasoning.

Product direction

The eventual product should feel like a calm, capable investigator helping the user think one step at a time.

The user should not need to understand:

  • graph theory;
  • node IDs;
  • internal enums;
  • schemas;
  • prompt versions;
  • proposal validation;
  • model-provider details.

Those remain available through developer/debug views.

Core product promise

The engine should help a user reach one of these states:

  • I have enough justified confidence to act.
  • I do not yet have enough confidence, but I know what to investigate next.
  • I have discovered that my original question needs reframing.

Current development stage

The deterministic reasoning architecture reached a stable alpha checkpoint.

Current work is primarily improving:

  • usability;
  • presentation;
  • loading feedback;
  • plain-language explanations;
  • separation of user and developer views.

Do not resume broad reasoning architecture work unless a repeated observed failure clearly requires it.

Important philosophy

Complicated situations are made from smaller parts.

Each part may influence the whole, but parts do not necessarily carry equal weight.

Previous cases may suggest where to investigate, but they must never determine the outcome of a new case.

Every case begins with no accepted evidence from previous cases.