| # 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" | |