Step 2 implemented

docs/step2.md

@@ -1,6 +1,6 @@
-Great—here’s a **detailed implementation plan for Step 2** based on your docs and current project state.
+## Step 2: prompts/transcribe_document.md
 
-## Step 2 Goal
+### Goal
 
 Implement the MVP prompt artifact system by creating a curated transcription prompt file:
 
@@ -121,6 +121,129 @@ In Step 2, ensure docs reflect this and that Step 3 will resolve:
 
 ---
 
+## Task-by-Task Execution Checklist
+
+## Phase A — Scaffold files
+
+- [ ] **A1. Create prompt directory**
+  - Path: `prompts/`
+  - Verify: directory exists at repo root
+
+- [ ] **A2. Create canonical prompt file**
+  - Path: `prompts/transcribe_document.md`
+  - Verify: file exists and is non-empty
+
+- [ ] **A3. (Recommended) Create prompt library README**
+  - Path: `prompts/README.md`
+  - Verify: includes naming + revision conventions
+
+---
+
+## Phase B — Author prompt content (core work)
+
+- [ ] **B1. Add Purpose section**
+  - States verbatim historical transcription objective
+  - Explicitly disallows summarization/paraphrase
+
+- [ ] **B2. Add Output Contract section**
+  - Plain text output expectation
+  - Preserve meaningful structure and reading order
+  - No fabricated text
+
+- [ ] **B3. Add Rule Set from `docs/Intent.md`**
+  - Misspellings/errors: `[sic]`
+  - Missing words: `[word]`
+  - Uncertain readings: `[guess?]`
+  - Illegible regions: `[illegible]` / reason labels
+  - Crossed-out text: `[deleted: ...]`
+  - Squeezed-in text: `[inserted: ...]`
+  - Superscripts/abbrev handling guidance
+  - Non-text visuals: bracketed descriptive labels
+  - Marginalia formatting cue
+  - Rejoin line-break hyphenated words silently
+  - Ambiguous capitalization policy
+  - Hierarchical outline numbering preservation
+
+- [ ] **B4. Add Ambiguity and Confidence policy**
+  - “Mark uncertainty instead of guessing”
+  - “Never silently normalize uncertain passages”
+
+- [ ] **B5. Add Final Self-Check section**
+  - Checklist for fidelity, uncertainty labeling, and format compliance
+
+---
+
+## Phase C — Add validations (tests)
+
+- [ ] **C1. Create prompt tests file**
+  - Path: `tests/test_prompts.py`
+
+- [ ] **C2. Add existence/health checks**
+  - Prompt file exists
+  - Prompt file has content (non-whitespace)
+
+- [ ] **C3. Add semantic anchor checks**
+  - Mentions verbatim behavior
+  - Mentions uncertainty marker pattern (`?` in brackets conceptually)
+  - Mentions illegible handling
+  - Mentions deleted/inserted conventions
+
+- [ ] **C4. Keep tests resilient**
+  - Avoid exact full-file snapshot assertions
+  - Assert required concepts, not precise phrasing
+
+---
+
+## Phase D — Documentation alignment
+
+- [ ] **D1. Update top-level docs/README reference**
+  - Mention that prompts live in `prompts/`
+  - Mention Step 3 loads from `PROMPT_DIR`
+
+- [ ] **D2. Confirm config compatibility**
+  - `src/transcription/config.py` already uses `prompt_dir = Path("./prompts")`
+  - No code change needed unless naming/path mismatch appears
+
+---
+
+## Phase E — Verification
+
+- [ ] **E1. Run targeted test file**
+  - `uv run pytest tests/test_prompts.py -q`
+
+- [ ] **E2. Run full suite**
+  - `uv run pytest -q`
+
+- [ ] **E3. Confirm no regressions**
+  - All existing tests still green (expected: previous 20 + new prompt tests)
+
+---
+
+## Phase F — Commit plan (recommended granularity)
+
+- [ ] **F1. Commit 1: scaffold**
+  - `prompts/transcribe_document.md` (initial structure)
+  - `prompts/README.md` (if included)
+
+- [ ] **F2. Commit 2: finalized prompt content**
+  - full rule-complete prompt text
+
+- [ ] **F3. Commit 3: tests + docs alignment**
+  - `tests/test_prompts.py`
+  - README/docs mention of prompt artifact pattern
+
+---
+
+## Done Criteria (quick gate)
+
+- [ ] Canonical prompt exists and is curated for verbatim transcription.
+- [ ] Prompt encodes all high-value handling rules from `docs/Intent.md`.
+- [ ] Prompt tests pass.
+- [ ] Full project tests pass with `uv`.
+- [ ] Ready for Step 3 provider integration.
+
+---
+
 ## Acceptance Criteria (Definition of Done)
 
 Step 2 is complete when all are true: