robbond/confidence-engine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

experiment: separate current principles from architectural aspirations

Browse Source
This commit is contained in:
robbond
2026-08-06 15:07:06 +01:00
parent a4bbe0ef3f
commit 51f0c11bc8
5 changed files with 108 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/project-knowledge-inventory.md
+7 -1
View File
@@ -24,6 +24,12 @@ These are the documents Claude should normally read before continuing Confidence
- **Why required:** Prevents accidental modification of reasoning code during UX work. Lists every invariant that must be preserved and the current architecture pipeline. Essential safety document.
- **Size:** small
### docs/current-working-principles.md (new — Experiment 32)
- **Purpose:** Default principles guidance for product, reasoning, and engineering work. Separates current principles from aspirational architecture.
- **Sections to read:** Entire file (~60 lines).
- **Why required:** Provides only the guidance that should influence work today, verified against current implementation. Reduces ambiguity about which principles are active versus aspirational.
- **Size:** small
### docs/design-evolution-log.md (selected sections only)
- **Purpose:** Chronological record of design decisions, experiments, and their conclusions.
- **Sections to read:**
@@ -133,7 +139,7 @@ Documents or sections that are primarily historical evidence from past experimen
### Review Before Archive (may have future value; do not load by default now)
| Document | Size | Why review before archive |
|---|---|---|
| `docs/architectural-principles.md` (306 lines) | medium | 14 architectural principles from experiments. Experiment 30 confirmed: 6 current, 4 aspirational targets, 3 overlap guardrails but add context. Role: task-specific reference for reasoning architecture work. See `docs/document-role-review.md` §2. |
| `docs/architectural-principles.md` (306 lines) | medium | Broader and aspirational architectural principles from experiments. Experiment 30 confirmed: 6 current, 4 aspirational targets, 3 overlap guardrails but add context. Role: task-specific reference for reasoning architecture work — not a statement of current implementation. Use `docs/current-working-principles.md` for default guidance instead. See `docs/document-role-review.md` §2 and Experiment 32 entry. |
| `docs/backlog info.md` (390 lines) | large | **Superseded by Experiment 31.** Content split into `docs/ui-mock-reference.md` (mock fixtures reference, ~62 lines) and `docs/archive/deferred-ux-backlog.md` (deferred UX planning, ~376 lines). See archive index for provenance. |
### Do Not Move or Delete (evidence of design evolution)