86 lines
4.4 KiB
Markdown
86 lines
4.4 KiB
Markdown
# Current Return-to-Work Handoff — Confidence Engine
|
||
|
||
> This file describes only the latest stopping point. Replace its current-work sections when the project moves on. Historical evidence remains in the design log and archive.
|
||
|
||
## 1. Where We Left It
|
||
|
||
- Engine experiments are paused after Experiment 25B;
|
||
- UI experiments are paused;
|
||
- Knowledge-management experiments are active;
|
||
- Experiment 34 created a single return-to-work handoff file to replace scattered current-state notes;
|
||
- The working tree was clean at commit `1d92aa0`.
|
||
|
||
> This handoff describes the latest stopping point only. When work moves on, replace stale current-work details rather than appending another historical note. Historical experiment and commit information belongs in `docs/design-evolution-log.md`.
|
||
|
||
## 2. What Is True Now
|
||
|
||
- Main active engine path: deterministic reasoning pipeline (scenario reconstruction, graph update, unknown selection, question formulation, turn orchestration).
|
||
- Passive experimental classifiers from Experiments 18–25B remain isolated diagnostic layers; none control the user-facing investigation.
|
||
- Keyword and phrase-based scope detection remains provisional scaffolding.
|
||
- `docs/current-project-state.md` is the main entry point for active project state.
|
||
- `docs/task-context-packs.md` chooses the minimum context documents for each work type.
|
||
|
||
## 3. Why Work Is Paused
|
||
|
||
Engine and UI work were deliberately paused because documentation had grown large enough to overload Claude and make returning across sessions difficult. The current phase is simplifying what a fresh session must load to understand the project, without losing evidential history. Historical material remains available under `docs/archive/`.
|
||
|
||
## 4. What Was Just Completed
|
||
|
||
Experiment 34 consolidated scattered return-to-work notes into a single handoff file at `docs/current-handoff.md`, replacing the growing list of current-state entries in `docs/current-project-state.md`. This tested whether one living document could replace accumulated history without losing navigation value. No source code changed. No files moved or deleted.
|
||
|
||
**Commit:** `1d92aa0` (experiment: create single return-to-work handoff)
|
||
|
||
## 5. What Remains Open
|
||
|
||
- Whether the handoff stays accurate and concise after further project advances (tested by this experiment);
|
||
- Whether tasks crossing pack boundaries can still stay concise without loading excessive context;
|
||
- When knowledge-management work is complete enough to resume engine experiments.
|
||
|
||
### When This Knowledge-Management Phase Is Complete
|
||
|
||
Provisional criteria for review (not yet declared complete):
|
||
|
||
1. A fresh session can resume from the handoff and one context pack;
|
||
2. Current state has been verified against implementation;
|
||
3. Historical material is outside default loading;
|
||
4. Current principles are separated from aspirational architecture;
|
||
5. Task-specific routing works for engine and UI tasks;
|
||
6. A cross-boundary task has been tested;
|
||
7. Maintaining the handoff does not require reading the full history.
|
||
|
||
## 6. How to Resume
|
||
|
||
1. Read `docs/current-handoff.md`.
|
||
2. Read `docs/current-project-state.md`.
|
||
3. Choose one pack from `docs/task-context-packs.md`.
|
||
4. Read `.claude/architecture-guardrails.md` before any code change.
|
||
5. Load extra context only for a named gap — record why.
|
||
6. Check Git status before continuing.
|
||
|
||
## 7. First Files by Work Type
|
||
|
||
| Work type | Start with |
|
||
|---|---|
|
||
| Engine experiment | Engine Experiment pack |
|
||
| UI or mock work | UI and Mock pack |
|
||
| Architecture or contract review | Architecture or Contract pack |
|
||
| Knowledge management | Knowledge-Management pack |
|
||
|
||
## 8. Resume Check
|
||
|
||
Answer before continuing:
|
||
|
||
1. What work is currently active?
|
||
2. What work is paused?
|
||
3. What was the latest completed experiment?
|
||
4. Which context pack applies to the next task?
|
||
5. Is there any uncommitted work?
|
||
|
||
---
|
||
|
||
*Created by Experiment 34. Updated by Experiment 35. Branch: `feature/user-workspace-ux-v0.7`.*
|
||
|
||
### Return-to-Work Note (Experiment 35)
|
||
|
||
Experiment 35 tested handoff maintenance after another knowledge-management experiment completed. Stale experiment and commit wording was corrected — the handoff now names Experiment 34 as the latest completed KM experiment and `1d92aa0` as the latest confirmed commit. Provisional knowledge-management completion criteria are recorded in Section 5. Engine and UI experiments remain paused; knowledge-management remains active. First file to inspect when resuming: `docs/current-handoff.md`, then `docs/task-context-packs.md`.
|