Claude Documentation

This folder contains documentation, guides, and notes related to Claude and Claude Code. It serves as a personal wiki for configuration, workflows, tips, and integrations.

Guides

Document	Description
Settings Architecture	Complete guide to Claude Code settings hierarchy, permissions, and MCP configuration
MCP Server Scopes	The three MCP server scopes (user, project, local) and when to use each
Audio Notifications	How to set up audio notifications for Claude Code events (task completion, idle, permissions)
MCP Servers	Inventory of all configured MCP servers — what they do and how they’re scoped

Skills

Custom slash commands available in Claude Code:

Skill	Description
`/create-skill`	Create a new Claude Code skill from conversation context, a file, or a description
`/cross-post`	Cross-post content to LinkedIn, Twitter/X, and Slack
`/find-skills`	Discover and install agent skills from the open skills ecosystem
`/merge`	Merge a PR (with merge commit), then clean up worktree and prune merged branches
`/new-project`	Scaffold a full-stack project with backend (Scalingo) and Next.js frontend (Cloudflare Pages)
`/notion-article`	Write and publish a blog article to Notion based on conversation context, a file, or a topic
`/pr`	Commit changes, create a branch, push, and open a pull request
`/promote-permissions`	Review ephemeral permissions and promote approved ones to versioned settings
`/review-apply`	Apply PR review feedback — reply to questions and implement requested changes
`/sentry-triage`	Triage unresolved Sentry issues, analyze root causes, and prioritize by impact
`/tmba-process`	Process a “Tech My Breath Away” meeting: move Notion page and upload video
`/workspace`	Read open Cursor editor tabs to understand what the user is working on
`/worktree`	Create or clean up a git worktree for feature work, with permission inheritance

Insights Reports

The insights/ directory contains usage analysis reports generated by Claude Code’s /insights command. These reports analyze session patterns, tool usage, friction points, and recommendations.

Report	Sessions	Hours	Commits
February 10, 2026	234	659	266

Structure

claude/
├── README.md          # This file - index of all documentation
├── CLAUDE.md          # Global instructions for all Claude Code sessions
├── .claude/
│   └── skills/        # Custom Claude Code skills (13 skills)
│       ├── create-skill/
│       ├── cross-post/
│       ├── find-skills/
│       ├── merge/
│       ├── new-project/
│       ├── notion-article/
│       ├── pr/
│       ├── promote-permissions/
│       ├── review-apply/
│       ├── sentry-triage/
│       ├── tmba-process/
│       ├── workspace/
│       └── worktree/
├── config/            # Configuration files (symlinked from ~/.claude/)
│   └── settings.json  # User-level Claude settings
├── guides/            # Step-by-step tutorials and how-tos
├── insights/          # Usage analysis reports from /insights command
│   └── report-*.html  # Self-contained HTML reports with usage patterns
└── notes/             # Personal notes and learnings

Quick Setup

The following files are symlinked from ~/.claude/ to this repo:

# Global instructions (loaded in every session)
ln -sf ~/dev/claude/CLAUDE.md ~/.claude/CLAUDE.md

# User-level settings
ln -sf ~/dev/claude/config/settings.json ~/.claude/settings.json

Adding a New Document

Create a new .md file in the appropriate folder
Add an entry to the relevant table above
Use descriptive filenames (e.g., mcp-server-setup.md)