86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
|
# 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
|