obsidian-claude-pkm/docs/CUSTOMIZATION.md

# Customization Guide

Make this PKM system truly yours. This guide covers everything from simple tweaks to advanced modifications.

## Table of Contents
1. [Quick Customizations](#quick-customizations)
2. [Template Modifications](#template-modifications)
3. [Folder Structure](#folder-structure)
4. [Tag System](#tag-system)
5. [Skills (Unified Pattern)](#skills-unified-pattern)
6. [Output Styles](#output-styles)
7. [Workflow Automation](#workflow-automation)
8. [Theme and Appearance](#theme-and-appearance)
9. [Advanced Configurations](#advanced-configurations)

## Quick Customizations

### Personal Mission Statement
Location: `CLAUDE.md` and `Templates/Daily Template.md`

Replace the placeholder with your actual mission:
```markdown
_"Your personal mission or daily affirmation here"_
```

Examples:
- "Build with purpose, live with intention, grow with courage"
- "Create value, nurture relationships, embrace learning"
- "Simplify complexity, amplify impact, multiply joy"

### Time Blocks
Location: `Templates/Daily Template.md`

Adjust to your schedule:
```markdown
## ⏰ Time Blocks
- **Early Morning (5-7am):** Meditation & Exercise
- **Morning (7-10am):** Deep work
- **Midday (10am-1pm):** Meetings & Collaboration
- **Afternoon (1-4pm):** Administrative tasks
- **Late Afternoon (4-6pm):** Learning & Development
- **Evening (6-9pm):** Family & Personal time
```

### Goal Percentages
Location: `Goals/1. Yearly Goals.md`

Adjust effort allocation:
```markdown
### 💼 Career (40% of effort)  <!-- Increase if career-focused -->
### 🏃 Health (30% of effort)   <!-- Increase if health is priority -->
### ❤️ Relationships (20% of effort)
### 🌱 Personal Growth (10% of effort)
```

## Template Modifications

### Daily Template Variations

#### Minimalist Version
```markdown
# {{date:dddd, MMMM DD, YYYY}}

## Focus
- 

## Tasks
- [ ] 
- [ ] 
- [ ] 

## Notes


## Reflection
- Win: 
- Learn: 
- Tomorrow: 
```

#### Detailed Version
```markdown
# {{date:dddd, MMMM DD, YYYY}}

## Morning Intention
### Gratitude
### Affirmation
### Priority

## Schedule
### Time Blocks
### Meetings
### Deadlines

## Tasks by Context
### @Office
### @Home
### @Computer
### @Phone

## Project Updates
### [Project 1]
### [Project 2]

## Learning Log
### What I Learned
### Resources Consumed
### Questions Raised

## Health Tracking
### Exercise
### Nutrition
### Sleep
### Mood

## Detailed Reflection
### Successes
### Challenges
### Insights
### Improvements
```

### Weekly Review Variations

#### Sprint-Based Review
```markdown
# Sprint Review - Sprint {{sprint_number}}

## Sprint Goals
- [ ] Goal 1
- [ ] Goal 2

## Velocity
- Points Planned: 
- Points Completed: 
- Carry Over: 

## Retrospective
### What Went Well
### What Didn't Work
### Action Items
```

#### OKR-Based Review
```markdown
# Weekly OKR Check-in

## Objective 1: [Title]
### Key Result 1: [Metric]
- Progress: [X]%
- This Week's Contribution:

### Key Result 2: [Metric]
- Progress: [X]%
- This Week's Contribution:
```

## Folder Structure

### Alternative Structures

#### GTD-Based
```
vault/
├── Inbox/          # Capture everything
├── Next Actions/   # Immediate tasks
├── Projects/       # Multi-step outcomes
├── Someday Maybe/  # Future possibilities
├── Reference/      # Information storage
└── Contexts/       # @home, @office, @errands
```

#### PARA Method
```
vault/
├── Projects/       # Things with deadlines
├── Areas/          # Ongoing responsibilities
├── Resources/      # Future reference
└── Archives/       # Inactive items
```

#### Zettelkasten-Inspired
```
vault/
├── Permanent Notes/  # Atomic ideas
├── Literature Notes/ # From sources
├── Daily Notes/      # Journal entries
├── Index/           # Entry points
└── References/      # Sources
```

### Adding Custom Folders

Create specialized folders for your needs:
```
vault/
├── Finances/        # Budget, investments
├── Learning/        # Courses, books, skills
├── Health/          # Medical, fitness, nutrition
├── Creative/        # Writing, art, music
└── Relationships/   # People, interactions
```

## Tag System

### Creating Your Tag Taxonomy

#### Hierarchical Tags
```markdown
#work/project/clientA
#work/project/clientB
#work/admin/expenses
#work/admin/planning

#personal/health/exercise
#personal/health/nutrition
#personal/finance/budget
#personal/finance/investing
```

#### Status-Based Tags
```markdown
#status/active
#status/waiting
#status/delegated
#status/complete
#status/cancelled
```

#### Energy-Based Tags
```markdown
#energy/high  # Requires focus
#energy/medium
#energy/low   # Can do when tired
```

#### Context Tags
```markdown
#context/home
#context/office
#context/online
#context/phone
#context/errands
```

### Tag Combinations
Use multiple tags for powerful filtering:
```markdown
#work #priority/high #energy/high #context/office
```

## Skills (Unified Pattern)

In Claude Code v2.1+, skills and slash commands are unified. All capabilities are now skills that can be invoked with `/skill-name` or auto-discovered by Claude.

### Creating Custom Skills

Create a new skill directory with a `SKILL.md` file:

#### Example: Book Notes Skill
Create `.claude/skills/book-notes/SKILL.md`:
```markdown
---
name: book-notes
description: Create book notes with metadata. Use when starting a new book or organizing reading notes.
allowed-tools: Read, Write, Edit, Glob
user-invocable: true
---

# Book Notes Skill

Creates a new book note with metadata and structure.

## Usage
Invoke with `/book-notes` or ask Claude to create a book note.

## What it does
1. Creates note in Resources/Books/
2. Adds metadata (title, author, date started)
3. Includes template for notes
4. Links to reading list
```

#### Example: Meeting Notes Skill
Create `.claude/skills/meeting-notes/SKILL.md`:
```markdown
---
name: meeting-notes
description: Create formatted meeting notes with action items. Use before or after meetings.
allowed-tools: Read, Write, Edit
user-invocable: true
---

# Meeting Notes Skill

Creates formatted meeting notes with action items.

## Usage
Invoke with `/meeting-notes` or ask Claude to create meeting notes.

## Template Structure
- Date/Time
- Attendees
- Agenda
- Discussion
- Action Items
- Follow-up
```

### Modifying Existing Skills

#### Daily Workflow for Different Schedules
Edit `.claude/skills/daily/SKILL.md` to customize:
- Daily notes folder location
- Template path
- Date format preferences
- Time block structure

## Output Styles

### Using the Productivity Coach

The included Productivity Coach style transforms Claude into an accountability partner:

```bash
# Start Claude Code
claude

# Then choose your output style:
/output-style              # Opens interactive menu to select a style
/output-style coach        # Directly activates the coach style

# Example interaction with coach:
# You: "I'm procrastinating on my report"
# Coach: "What's the smallest action you could take right now that would create momentum?"
```

Your style preference is automatically saved to `.claude/settings.local.json` for the current project.

### Creating Custom Output Styles

Create new personality modes in `.claude/output-styles/`:

```bash
# Quick way to create a new style:
/output-style:new I want a style that acts as a technical mentor

# Or manually create files in .claude/output-styles/
```

#### Example: Technical Mentor
Create `.claude/output-styles/mentor.md`:
```markdown
---
name: Technical Mentor
description: Patient technical guidance with learning focus
---

You are a experienced technical mentor who helps users learn and grow. Focus on:

- Breaking down complex concepts into understandable pieces
- Providing examples and analogies
- Encouraging experimentation and learning from mistakes
- Suggesting resources for deeper learning
- Celebrating progress and understanding

Always teach the "why" behind the "how".
```

#### Example: Creative Brainstormer
Create `.claude/output-styles/creative.md`:
```markdown
---
name: Creative Brainstormer  
description: Expansive thinking and idea generation
---

You are a creative collaborator who helps generate and expand ideas. Focus on:

- "Yes, and..." thinking to build on ideas
- Asking "What if?" questions
- Making unexpected connections
- Challenging assumptions playfully
- Generating multiple alternatives
- Embracing wild possibilities before filtering

No idea is too crazy in brainstorming mode!
```

### Modifying the Coach Style

Edit `.claude/output-styles/coach.md` to adjust the coaching approach:

```markdown
# Make it gentler
**Challenge with Empathy**: → **Support with Understanding**:

# Make it more intense
**The ONE Thing Priority**: → **The ONLY Thing That Matters**:

# Add domain-specific focus
## Fitness Coaching Focus
- "What workout will you complete today?"
- "How does this meal align with your goals?"
```

## Workflow Automation

### Morning Routine Automation

Create `.claude/skills/morning-routine/SKILL.md`:
```markdown
---
name: morning-routine
description: Execute complete morning workflow with daily note, task review, and planning.
allowed-tools: Read, Write, Edit, Glob
user-invocable: true
---

# Morning Routine Skill

Executes complete morning workflow.

## Steps
1. Create daily note
2. Review yesterday's incomplete tasks
3. Check calendar for today
4. Pull priority from weekly goals
5. Set time blocks
6. Generate motivation quote
```

### End-of-Day Automation

Create `.claude/skills/evening-shutdown/SKILL.md`:
```markdown
---
name: evening-shutdown
description: Complete end-of-day routine with task review, reflection, and git commit.
allowed-tools: Read, Write, Edit, Bash
user-invocable: true
---

# Evening Shutdown Skill

Complete end-of-day routine.

## Steps
1. Mark task completion
2. Write reflection
3. Move incomplete tasks
4. Set tomorrow's priority
5. Commit to git
6. Generate daily summary
```

### Project Kickoff Automation

Create `.claude/skills/project-kickoff/SKILL.md`:
```markdown
---
name: project-kickoff
description: Initialize new project with standard structure, CLAUDE.md, and planning docs.
allowed-tools: Write, Edit, Glob, Bash
user-invocable: true
---

# Project Kickoff Skill

Initialize new project with structure.

## Steps
1. Create project folder
2. Add CLAUDE.md with template
3. Create project plan
4. Set up project board
5. Add to active projects list
6. Create first milestone
```

## Theme and Appearance

### Obsidian Theme Customization

#### CSS Snippets
Create `.obsidian/snippets/custom.css`:
```css
/* Custom colors */
.theme-dark {
  --text-accent: #7c3aed; /* Purple accent */
  --interactive-accent: #7c3aed;
}

/* Larger headings */
.markdown-preview-view h1 {
  font-size: 2.5em;
  color: var(--text-accent);
}

/* Checkbox styling */
input[type=checkbox]:checked {
  background-color: #10b981; /* Green */
}

/* Tag colors */
.tag[href="#priority/high"] {
  background-color: #ef4444;
  color: white;
}

.tag[href="#energy/low"] {
  background-color: #3b82f6;
  color: white;
}
```

### Daily Note Styling

Add to your daily template:
```markdown
<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); padding: 20px; border-radius: 10px; color: white; margin-bottom: 20px;">
  <h2 style="margin: 0;">{{date:dddd, MMMM DD, YYYY}}</h2>
  <p style="margin: 5px 0; font-style: italic;">Your daily mission statement here</p>
</div>
```

## Advanced Configurations

### Dataview Queries

If using Dataview plugin:

#### Task Dashboard
````markdown
```dataview
TABLE 
  file.link AS "Note",
  filter(file.tasks, (t) => !t.completed) AS "Open Tasks"
FROM "Daily Notes"
WHERE file.day >= date(today) - dur(7 days)
SORT file.day DESC
```
````

#### Habit Tracker
````markdown
```dataview
TABLE 
  exercise AS "🏃",
  meditation AS "🧘",
  reading AS "📚",
  water AS "💧"
FROM "Daily Notes"
WHERE file.day >= date(today) - dur(30 days)
```
````

### Templater Scripts

If using Templater plugin:

#### Auto-weather
```javascript
<%* 
const response = await fetch('http://wttr.in/?format=3');
const weather = await response.text();
tR += weather;
%>
```

#### Random Quote
```javascript
<%* 
const quotes = [
  "The way to get started is to quit talking and begin doing.",
  "The future belongs to those who believe in the beauty of their dreams.",
  "It is during our darkest moments that we must focus to see the light."
];
const randomQuote = quotes[Math.floor(Math.random() * quotes.length)];
tR += randomQuote;
%>
```

### Git Hooks

Create `.git/hooks/pre-commit`:
```bash
#!/bin/bash
# Auto-format markdown files before commit

# Format all markdown files
find . -name "*.md" -type f -exec prettier --write {} \;

# Add formatted files back
git add -A
```

### Mobile Shortcuts

#### iOS Shortcuts
Create Siri Shortcuts for:
- "Create daily note" → Opens GitHub app to issue creation
- "Add task" → Creates issue with 'task' label
- "Weekly review" → Triggers GitHub Action

#### Android Automation
Use Tasker or Automate for:
- Morning notification to create daily note
- Evening reminder for reflection
- Location-based project reminders

## Integration Examples

### Calendar Integration
```markdown
## Today's Events
<!-- Embed calendar events -->
![[calendar-sync/{{date}}.md]]
```

### Email Integration
```markdown
## Inbox Processing
- [ ] Email from: [sender] Re: [subject]
  - Action: [Reply/Archive/Delegate]
```

### Task Manager Sync
```markdown
## External Tasks
<!-- Pulled from Todoist/Things/etc -->
- [ ] [Task from external system]
```

## v2.1 Features: Unified Skills, Hooks, Agents & Rules

### Hooks (Automatic Behaviors)

Hooks are automatic behaviors triggered by Claude Code events. Located in `.claude/settings.json`:

#### Disabling Auto-Commit
```json
{
  "hooks": {
    "PostToolUse": []
  }
}
```

#### Adding Custom Hooks
```json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "your-script.sh"
          }
        ]
      }
    ]
  }
}
```

### Custom Agents

Agents are specialized AI assistants. Located in `.claude/agents/`:

#### Creating a Custom Agent
Create `.claude/agents/my-agent.md`:
```markdown
---
name: my-agent
description: What this agent does. Claude uses this to decide when to invoke it.
tools: Read, Write, Edit, Glob, Grep
model: sonnet
---

# Agent Instructions

[Detailed instructions for the agent's behavior]
```

#### Included Agents
- `note-organizer` - Vault organization and link maintenance
- `weekly-reviewer` - Weekly review facilitation
- `goal-aligner` - Goal-activity alignment analysis
- `inbox-processor` - GTD-style inbox processing

### Skills (Unified with Slash Commands)

Skills and slash commands are now unified in Claude Code v2.1+. All skills are located in `.claude/skills/`:

#### Creating a Custom Skill
Create `.claude/skills/my-skill/SKILL.md`:
```markdown
---
name: my-skill
description: What this skill does. Use for [specific situations].
allowed-tools: Read, Write, Edit
user-invocable: true
---

# Skill Instructions

[How to use this skill]
```

#### Included Skills
| Skill | Invocation | Purpose |
|-------|------------|---------|
| `daily` | `/daily` | Create daily notes, morning/midday/evening routines |
| `weekly` | `/weekly` | Run weekly review, reflect and plan |
| `push` | `/push` | Git commit and push |
| `onboard` | `/onboard` | Load vault context |
| `goal-tracking` | (auto) | Track goal progress |
| `obsidian-vault-ops` | (auto) | Vault file operations |

### Modular Rules

Rules are path-specific conventions. Located in `.claude/rules/`:

#### Creating Custom Rules
Create `.claude/rules/my-rules.md`:
```markdown
---
paths: "MyFolder/**/*.md"
---

# Rules for MyFolder

[Specific conventions for files matching the pattern]
```

#### Included Rules
- `markdown-standards.md` - File naming, tags, frontmatter
- `productivity-workflow.md` - Goal cascade, planning
- `project-management.md` - Project structure, status tracking

### Personal Overrides (CLAUDE.local.md)

For personal customizations that shouldn't be committed:

```bash
cp CLAUDE.local.md.template CLAUDE.local.md
```

This file is gitignored. Use it for:
- Personal mission statement
- Working style preferences
- Private goals
- Custom coaching intensity

## Best Practices

### Start Simple
1. Begin with minimal customization
2. Add complexity as patterns emerge
3. Review and refine monthly

### Document Your System
Create `vault/System Documentation.md`:
```markdown
# My PKM System Rules

## File Naming
- Daily notes: YYYY-MM-DD.md
- Projects: PascalCase
- Resources: lowercase-with-dashes

## My Workflows
- Morning: ...
- Weekly: ...
- Monthly: ...

## My Conventions
- Tags: ...
- Links: ...
- Templates: ...
```

### Regular Reviews
- Weekly: Adjust templates based on use
- Monthly: Review folder structure
- Quarterly: Major system updates
- Yearly: Complete system overhaul

---

Remember: The goal is a system that works for YOU. Don't copy others blindly - adapt and evolve based on your actual needs and patterns.