experiment: create current project state entry point

This commit is contained in:
2026-08-06 14:06:20 +01:00
parent 4661b8e8e5
commit 61c8a3adbd
3 changed files with 165 additions and 2 deletions
+59 -2
View File
@@ -1551,10 +1551,67 @@ None. The five questions were answered accurately from the minimum context set.
Pending review. Nothing has been archived, moved, or deleted. The proposed context-loading plan is documented in `docs/project-knowledge-inventory.md`.
---
---
## Current Open Questions
## Experiment 27 — Create a Short Current-State Entry Point
**Status:** Pending Rob's review
### Hypothesis
A concise current-state document can replace the large experiment-log section as the normal starting point for future work. The full design history should remain available as evidence, but should not be compulsory reading.
### Documents Used
| Document | Sections |
|---|---|
| `docs/project-knowledge-inventory.md` | Current Working Context; Gaps and Duplications to Review; Minimum Context Test Result |
| `.claude/project-context.md` | Entire file (~102 lines) |
| `.claude/architecture-guardrails.md` | Entire file (~77 lines) |
| `docs/design-evolution-log.md` | Experiment 26 only; Return-to-Work Note after Experiment 25B (lines 14831501) |
| `docs/03_Confidence_Engine_Language_Guide.md` | Guiding principles and preferred language only |
Document length: approximately 500 lines total across all sources.
### Created File
`docs/current-project-state.md` — 252 lines. Organised by what is true now, not chronologically. Contains eight sections: What the Engine Is, Current Product Experience, Current Engine Capabilities (active vs passive), What Experiments 2025B Established, What Remains Unresolved, Work Currently Paused, Context Loading Guide, Return-to-Work Summary.
### Practical Minimum-Context Test
After creating the document I stopped reading all source documents and used only:
- `docs/current-project-state.md`
- `.claude/architecture-guardrails.md`
To produce this briefing for a returning developer:
1. **Active:** Deterministic reasoning pipeline, unknown selection (atomicity/answerability), question formulation within reasoning patterns, scenario API, turn cycle orchestration. Nothing more from the engine itself.
2. **Passive:** Investigation-state assessment, behaviour selection, decision condition status, question-to-condition relevance, evidence direction, evidence scope, scope-aware condition status — all isolated diagnostic layers with no active integration.
3. **Paused:** Engine experiments (after 25B), UI experiments. Knowledge-management is active. Nothing archived or deleted.
4. **Provisional:** Keyword/phrase matching for scope detection; passive classifier generalisability across domains; how passive reasoning enters the active cycle; whether architecture docs match implementation.
5. **Next:** `docs/current-project-state.md` is the starting point. Use the inventory for task-specific context. Guardrails before code changes.
Result: The briefing was accurate and complete from these two files. No essential information was missing. The routing table in section 7 of the current-state document provided all necessary references without requiring additional documents.
### Missing or Ambiguous Information Found
- `docs/investigation-state-assessment-contract.md` (232 lines) describes a data contract that may no longer match implementation after experiments 1525B; not verified.
- The exact line count of the created document should be confirmed with `wc -l`.
- Whether any of the passive classifiers have been partially integrated since Exp 25B was closed requires checking source code — this task did not read it.
### Assessment
The new entry point successfully replaced the need to load the large experiment-log section (1,542 lines). The current-state document conveys active vs passive capabilities, pause status, unresolved questions and loading instructions in a single short file. It can replace the large default log section as the normal starting point for future work.
The practical briefing was produced accurately from only two files without reading any source material beyond what was used to create it. This confirms the hypothesis that a concise current-state document is sufficient context for understanding where the project stands.
### Return-to-Work Note
A short current-state entry point now exists at `docs/current-project-state.md`. Future Claude sessions should begin there. The full experiment history remains available in `docs/design-evolution-log.md` but is no longer default reading. Nothing has been archived, moved or deleted yet. Before changing the documentation structure, review whether the new entry point reliably replaces the large log section and whether any historical documents should be formally archived. First file to inspect when resuming: `docs/current-project-state.md`. Branch: `feature/user-workspace-ux-v0.7`.
### Status
Pending Rob's review.
The following are active explorations rather than decisions.