# 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:**
```markdown
# 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"