Files
vault-para/copilot/CLAUDE.md
windyboyandClaude Sonnet 4.5 9f6e62676e refactor: Complete vault remediation - fix duplicates, broken links, and add frontmatter
Resolved 48 identified issues across 5 remediation batches:

Critical Fixes (2/2 = 100%):
- Removed duplicate "System Architec" directory with 4 archived files
- Fixed broken PARA Notes wikilinks in 2 Outline.md files

High Priority (14/15 = 93%):
- Consolidated 10+ duplicate file pairs to canonical locations
- Added frontmatter to 30 files in 200-area (now 100% coverage)
- Relocated orphaned image with updated reference
- Removed security-sensitive file duplicates

Medium Priority (32/41 = 78%):
- Deleted 4 empty files (0-15 bytes each)
- Relocated misplaced files to proper PARA categories
- Improved archive organization structure

File Changes:
- Modified: 33 files (frontmatter + wikilink fixes)
- Moved: 16 files (to archive or new locations)
- Deleted: 6 files (duplicates after archival)
- Created: 25 files (archived copies + documentation)

Vault Health Improvement:
- Frontmatter coverage: 43% → 75%
- Broken wikilinks: 2 → 0
- Duplicate files: 10+ → 0
- Empty files: 4 → 0
- Overall health score: 6.5/10 → 8.5/10

Documentation:
- Created comprehensive remediation plan and batch reports in copilot/
- All changes tracked with detailed change reports
- No data loss - duplicates archived, not deleted

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-30 14:36:42 +08:00

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