vault-para/copilot/CLAUDE.md

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:

---
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:

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