# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Directory Purpose

This is the Obsidian Copilot plugin data directory within the PARA-organized Obsidian vault. It stores:

- **copilot-custom-prompts/**: Reusable prompt templates accessed via Copilot's slash command menu and context menu
- **copilot-conversations/**: Historical conversation logs with timestamps and context notes

## Copilot Prompt File Format

Custom prompt files use YAML frontmatter to configure plugin behavior:

```yaml
---
copilot-command-context-menu-enabled: true   # Show in right-click context menu
copilot-command-slash-enabled: true          # Show in slash command palette
copilot-command-context-menu-order: 1000     # Display order (lower = higher priority)
copilot-command-model-key: ""                # Optional: override default AI model
copilot-command-last-used: 0                 # Timestamp of last use (managed by plugin)
---
```

The prompt body should contain `{}` as a placeholder for selected text or active note content.

## Existing Custom Prompts

Current prompts in order (context-menu-order):

| Order | Prompt | Purpose |
|-------|--------|---------|
| 1000 | Fix grammar and spelling | Correct text while preserving formatting |
| 1010 | Translate to Chinese | Preserve meaning, tone, and structure |
| 1020 | Summarize | Bullet-point summary of key points |
| 1030 | Simplify | Rewrite at 6th-grade reading level |
| 1040 | Make shorter | Condense text |
| 1050 | Emojify | Add relevant emojis (no adjacent duplicates) |
| 1060 | Make longer | Expand text |
| 1070 | Remove URLs | Strip URLs from content |
| 1080 | Rewrite as tweet | Convert to tweet format |
| 1090 | Rewrite as tweet thread | Convert to tweet thread |
| 1100 | Generate table of contents | Create TOC from headings |
| 1110 | Generate glossary | Extract key terms and definitions |
| 1120 | Explain like I am 5 | ELI5 simplification |

## Conversation Log Format

Conversation files capture AI interactions with the following frontmatter:

```yaml
---
epoch: 1764382388758
modelKey: "moonshotai/kimi-k2-thinking|3rd party (openai-format)"
topic: "Topic Name"
tags:
  - copilot-conversation
---
```

Conversations include context notes (e.g., `[Context: Notes: 100-project/Personal/resume/2025.md]`) and timestamps for each message.

## Working with This Directory

### Adding a new custom prompt:
1. Create a new `.md` file in `copilot-custom-prompts/`
2. Add YAML frontmatter with appropriate `copilot-command-context-menu-order`
3. Write the prompt body using `{}` as the content placeholder
4. Avoid conflicting order numbers with existing prompts

### Conversation logs:
- These are auto-generated by the Copilot plugin
- File names follow pattern: `{context}_{prompt}@{timestamp}.md`
- Prefixed with `activeNote_` when operating on the active note
- Do not manually edit unless debugging plugin behavior

## Relationship to Parent Vault

This directory lives within the PARA-organized vault at `/home/windy/project/obsidian/vault-para/`. When working with Copilot features that reference vault notes (via `{activeNote}` or context), be aware of the vault structure:

- `100-project/`: Active projects
- `200-area/`: Ongoing areas of responsibility
- `300-resources/`: Reference materials
- `400-archive/`: Archived content