v2.0: Add hooks, agents, skills, rules, and plugin structure
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:
@@ -599,6 +599,123 @@ Use Tasker or Automate for:
|
||||
- [ ] [Task from external system]
|
||||
```
|
||||
|
||||
## v2.0 Features: Hooks, Agents, Skills & 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 (Auto-Discovered Capabilities)
|
||||
|
||||
Skills are capabilities Claude discovers and uses automatically. 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
|
||||
---
|
||||
|
||||
# Skill Instructions
|
||||
|
||||
[How to use this skill]
|
||||
```
|
||||
|
||||
#### Included Skills
|
||||
- `obsidian-vault-ops` - Vault file operations
|
||||
- `goal-tracking` - Goal cascade management
|
||||
- `daily-workflow` - Daily routine structure
|
||||
|
||||
### 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
|
||||
|
||||
@@ -99,6 +99,20 @@ When prompted:
|
||||
|
||||
## Phase 3: Claude Code Integration (10 minutes)
|
||||
|
||||
### New in v2.0: Plugin Features
|
||||
|
||||
Your vault now includes a full Claude Code plugin with advanced features:
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **Hooks** | Auto-commit on file changes, session initialization |
|
||||
| **Agents** | Specialized AI assistants for note organization, weekly review, goal alignment |
|
||||
| **Skills** | Auto-discovered capabilities for vault operations, goal tracking, daily workflows |
|
||||
| **Rules** | Path-specific conventions for markdown, productivity, projects |
|
||||
| **Status Line** | Terminal display of vault stats (note count, inbox, uncommitted changes) |
|
||||
|
||||
These work automatically once your vault is set up.
|
||||
|
||||
### Step 1: Configure Claude Code
|
||||
|
||||
```bash
|
||||
@@ -154,7 +168,25 @@ claude
|
||||
|
||||
Your style preference is automatically saved in `.claude/settings.local.json`. The output style file is located at `.claude/output-styles/coach.md` if you want to customize it.
|
||||
|
||||
### Step 5: Customize Context
|
||||
### Step 5: Using Agents (New in v2.0)
|
||||
|
||||
The vault includes 4 specialized agents for common PKM tasks:
|
||||
|
||||
```bash
|
||||
# Organize your vault, fix broken links
|
||||
claude "Use the note-organizer agent to audit my vault"
|
||||
|
||||
# Run a guided weekly review
|
||||
claude "Use the weekly-reviewer agent to help with my weekly review"
|
||||
|
||||
# Check goal alignment
|
||||
claude "Use the goal-aligner agent to analyze my recent activity"
|
||||
|
||||
# Process your inbox
|
||||
claude "Use the inbox-processor agent to clear my inbox"
|
||||
```
|
||||
|
||||
### Step 6: Customize Context
|
||||
|
||||
Edit `CLAUDE.md` in your vault root:
|
||||
1. Add your personal mission statement
|
||||
@@ -162,6 +194,8 @@ Edit `CLAUDE.md` in your vault root:
|
||||
3. Set your current focus areas
|
||||
4. Add any specific instructions for Claude
|
||||
|
||||
For personal overrides, copy `CLAUDE.local.md.template` to `CLAUDE.local.md` (gitignored).
|
||||
|
||||
## Phase 4: Git Setup (5 minutes)
|
||||
|
||||
### Step 1: Initialize Repository
|
||||
|
||||
Reference in New Issue
Block a user