chill/obsidian-claude-pkm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v2.0: Add hooks, agents, skills, rules, and plugin structure

Browse Source 
Major modernization to leverage latest Claude Code features:

Plugin Foundation:
- Add .claude-plugin/plugin.json manifest for distribution
- Add .claude/settings.json with permissions and hooks config

Hooks (automatic behaviors):
- SessionStart: Initialize vault environment variables
- PostToolUse: Auto-commit changes after Write/Edit operations

Custom Agents (4):
- note-organizer: Vault organization and link maintenance
- weekly-reviewer: Facilitate weekly review aligned with goals
- goal-aligner: Check daily/weekly alignment with long-term goals
- inbox-processor: GTD-style inbox processing

Skills (3):
- obsidian-vault-ops: Read/write vault files, manage wiki-links
- goal-tracking: Track progress across goal cascade
- daily-workflow: Morning/midday/evening routines

Modular Rules (3):
- markdown-standards: File naming, tags, frontmatter conventions
- productivity-workflow: Goal cascade, daily/weekly planning
- project-management: Project structure and status tracking

Other:
- Add statusline.sh for terminal vault stats display
- Add CLAUDE.local.md.template for personal overrides
- Update CLAUDE.md with new features documentation
- Update all docs with v2.0 features and upgrade guide

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Bill Allred
2025-12-19 18:57:48 -08:00
parent eda01cbe46
commit 78a822a3df
21 changed files with 1643 additions and 159 deletions
Download Patch File Download Diff File Expand all files Collapse all files

215
vault-template/CLAUDE.md
View File

@@ -1,173 +1,96 @@
# Navigation & Context Guide for Claude Code
# Obsidian PKM Vault Context
## 🎯 System Purpose
[CUSTOMIZE THIS: Add your personal mission statement or life purpose here]
*Example: "Build meaningful technology that improves people's lives while maintaining balance and growth in all life areas."*
## System Purpose
[CUSTOMIZE: Add your personal mission statement here]
## 📁 Directory Structure & Purpose
*Example: "Build meaningful technology while maintaining balance across health, relationships, and personal growth."*
### Core Directories
- **Daily Notes/** - Daily journal entries and task management
- Named as `YYYY-MM-DD.md` format
- Contains daily planning, tasks, and reflections
- **Goals/** - Cascading goal system (3-year → yearly → monthly → weekly)
- Start with `0. Three Year Goals.md` for vision
- Break down into actionable items in `3. Weekly Review.md`
- **Projects/** - Active project folders
- Each project gets its own folder
- Include project-specific `CLAUDE.md` for context
- **Templates/** - Reusable note structures
- `Daily Template.md` - For daily notes
- `Weekly Review Template.md` - For weekly planning
- `Project Template.md` - For new projects
- **Archives/** - Completed or inactive content
- Move completed projects here
- Store old daily notes after monthly review
## Directory Structure
## 🏷️ Key Tags to Use
| Folder | Purpose |
|--------|---------|
| `Daily Notes/` | Daily journal entries (`YYYY-MM-DD.md`) |
| `Goals/` | Goal cascade (3-year → yearly → monthly → weekly) |
| `Projects/` | Active projects with their own `CLAUDE.md` |
| `Templates/` | Reusable note structures |
| `Archives/` | Completed/inactive content |
| `Inbox/` | Uncategorized captures (optional) |
### Priority Tags
- `#priority/high` - Must do today
- `#priority/medium` - Should do this week
- `#priority/low` - Nice to have
## Current Focus
### Context Tags
- `#work` - Professional tasks
- `#personal` - Personal development
- `#health` - Wellness activities
- `#family` - Relationships
- `#learning` - Skill development
See @Goals/2. Monthly Goals.md for this month's priorities.
### Status Tags
- `#active` - Currently working on
- `#waiting` - Blocked or waiting
- `#completed` - Done
- `#archived` - No longer relevant
## Tag System
[CUSTOMIZE THIS: Add your own tag system based on your workflow]
**Priority:** `#priority/high`, `#priority/medium`, `#priority/low`
**Status:** `#active`, `#waiting`, `#completed`, `#archived`
**Context:** `#work`, `#personal`, `#health`, `#learning`, `#family`
## 🔄 Workflow Instructions
## Available Commands
### Daily Workflow
1. **Morning (5 min)**
- Run `claude code /daily` to create today's note
- Review yesterday's unfinished tasks
- Set ONE main focus for today
- Plan your time blocks
| Command | Purpose |
|---------|---------|
| `/daily` | Create today's daily note from template |
| `/weekly` | Run weekly review process |
| `/push` | Commit and push changes to Git |
| `/onboard` | Load full vault context |
2. **Throughout the Day**
- Check off completed tasks
- Add thoughts and insights
- Capture new ideas in appropriate sections
## Available Agents
3. **Evening (5 min)**
- Complete reflection section
- Move unfinished tasks to tomorrow
- Run `claude code /push` to save changes
| Agent | Purpose |
|-------|---------|
| `note-organizer` | Organize vault, fix links, consolidate notes |
| `weekly-reviewer` | Facilitate weekly review aligned with goals |
| `goal-aligner` | Check daily/weekly alignment with long-term goals |
| `inbox-processor` | GTD-style inbox processing |
### Weekly Workflow
1. **Weekly Review (30 min)**
- Run `claude code /weekly` on Sunday
- Review past week's accomplishments
- Align next week with monthly goals
- Clean up and archive old notes
## Available Skills
### Project Management
1. **Starting a Project**
- Create folder in `Projects/`
- Add project-specific `CLAUDE.md`
- Define success criteria
- Break into actionable tasks
- **obsidian-vault-ops** - Read/write vault files, manage wiki-links
- **goal-tracking** - Track progress across goal cascade
- **daily-workflow** - Morning/midday/evening routines
2. **During Project**
- Keep all related notes in project folder
- Update project CLAUDE.md with progress
- Link to relevant daily notes
## Output Styles
3. **Completing Project**
- Create summary document
- Move to `Archives/`
- Extract lessons learned
**Productivity Coach** (`/output-style coach`)
- Challenges assumptions constructively
- Holds you accountable to commitments
- Asks powerful questions for clarity
- Connects daily work to mission
## 🤖 Claude Code Integration
## Daily Workflow
### Available Commands
- `/daily` - Creates today's daily note from template
- `/weekly` - Runs weekly review process
- `/push` - Commits and pushes changes to Git
- `/onboard` - Reads all CLAUDE.md files for context
### Morning (5 min)
1. Run `/daily` to create today's note
2. Identify ONE main focus
3. Review yesterday's incomplete tasks
4. Set time blocks
### Output Styles
Claude Code now supports different personality modes! This vault includes:
### Evening (5 min)
1. Complete reflection section
2. Move unfinished tasks
3. Run `/push` to save changes
- **Productivity Coach** - An accountability-focused coach that:
- Challenges you to clarify your true intentions
- Points out gaps between goals and actions
- Asks powerful questions to create momentum
- Holds you accountable to commitments
To use:
- Type `/output-style` in Claude Code for an interactive menu
- Or directly switch with: `/output-style coach`
- Your preference is automatically saved in `.claude/settings.local.json`
### Weekly (30 min - Sunday)
1. Run `/weekly` for guided review
2. Calculate goal progress
3. Plan next week's focus
4. Archive old notes
## Best Practices
### Best Practices with Claude
1. **Be Specific** - Give clear context about what you need
2. **Use Project Context** - Reference project CLAUDE.md files
3. **Try Different Styles** - Use coach mode when you need accountability
4. **Iterate** - Claude can help refine and improve your notes
5. **Review Suggestions** - Claude's suggestions are starting points
2. **Reference Goals** - Connect daily tasks to objectives
3. **Use Coach Mode** - When you need accountability
4. **Keep It Current** - Update project CLAUDE.md files regularly
## 📱 Mobile Access (via GitHub)
## Customization
### Setup
1. Initialize git in your vault
2. Create private GitHub repository
3. Set up GitHub Action (see `github-actions/claude.yml`)
4. Access notes via GitHub mobile app
### Mobile Workflow
1. View notes on GitHub mobile
2. Create issues for tasks/ideas
3. Claude processes issues automatically
4. Sync when back at desktop
## 🎨 Customization Points
[CUSTOMIZE THIS SECTION: Add your specific preferences]
### My Preferences
- **Daily Note Time**: [Morning/Evening]
- **Review Day**: [Sunday/Monday]
- **Time Blocking**: [Yes/No]
- **Task Management Style**: [GTD/Simple/Custom]
### Custom Shortcuts
- [Add your frequently used searches]
- [Add your common templates]
- [Add your workflow triggers]
## 📚 Resources & References
### Internal Links
- [[0. Three Year Goals]] - Long-term vision
- [[1. Yearly Goals]] - Current year focus
- [[2. Monthly Goals]] - This month's objectives
- [[3. Weekly Review]] - Weekly planning
### External Resources
[CUSTOMIZE THIS: Add your favorite references]
- [Resource 1]
- [Resource 2]
- [Resource 3]
For personal overrides that shouldn't be committed, create `CLAUDE.local.md`.
See `CLAUDE.local.md.template` for format.
---
*Last Updated: [DATE]*
*System Version: 1.0*
**Remember**: This system is meant to serve you, not constrain you. Adapt it as needed!
*See @.claude/rules/ for detailed conventions*
*Last Updated: 2024-12-19*
*System Version: 2.0*