added claude context files

2026-08-03 15:51:46 +01:00
parent 44aad69e12
commit e2960853ba
5 changed files with 415 additions and 0 deletions
@@ -0,0 +1,74 @@
+# 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.