CLAUDE.md

Project-Specific Instructions

[Inherits all rules from ~/.claude/CLAUDE.md]

Logging Standard

Unified Log Format (All log files MUST use Markdown):

• File extension: .md (not .txt)
• Headers: # Title, ## Section, ### Subsection
• Metadata: **Key:** value
• Code blocks: Triple backticks with language identifier
• Token-efficient: Use ## headings instead of ==== separators (95% token savings)

Log File Structure Template:

# Log Title

**Session Start:** YYYY-MM-DDTHH:MM:SS
**Key:** value

## Section [timestamp]

**Question:** ...
**Evidence items:** N

### Subsection

```text
Content here

Result: value

Next Section

**Console Output (Status Workflow):**
- **Compressed status updates:** `[node] ✓ result` or `[node] ✗ error`
- **Progress indicators:** `[1/1] Processing task_id`, `[1/20]` for batch
- **Key milestones only:** 3-4 statements vs verbose logs
- **Node labels:** `[plan]`, `[execute]`, `[answer]` with success/failure

**Log Files (_log/ folder):**
- `llm_session_*.md` - LLM synthesis session with questions, evidence, responses
- `{video_id}_transcript.md` - Raw transcripts from YouTube/Whisper
- **Purpose:** Post-run analysis, context preservation, audit trail
- **Benefits:** Collapsible headings in editors, token-efficient, readable in plain text

**Console Format Example:**

[plan] ✓ 660 chars [execute] 1 tool(s) selected [1/1] youtube_transcript ✓ [execute] 1 tools, 1 evidence [answer] ✓ 3 Session saved to: _log/llm_session_20260113_022706.md

**Note:** Explicit user request overrides global rule about "no logs/ folder"