Ryan Malloy 162ca67098 Initial commit: Claude Code Hooks with Diátaxis documentation
 Features:
- 🧠 Shadow learner that builds intelligence from command patterns
- 🛡️ Smart command validation with safety checks
- 💾 Automatic context monitoring and backup system
- 🔄 Session continuity across Claude restarts

📚 Documentation:
- Complete Diátaxis-organized documentation
- Learning-oriented tutorial for getting started
- Task-oriented how-to guides for specific problems
- Information-oriented reference for quick lookup
- Understanding-oriented explanations of architecture

🚀 Installation:
- One-command installation script
- Bootstrap prompt for installation via Claude
- Cross-platform compatibility
- Comprehensive testing suite

🎯 Ready for real-world use and community feedback!

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-19 18:25:34 -06:00
..

Claude Code Hooks Documentation

This documentation is organized using the Diátaxis framework to serve different types of user needs.

📚 Documentation Types

🎓 Tutorial

Learning-oriented - For newcomers who want to gain confidence and skill

Start here if you're new to Claude Hooks. We'll guide you through your first experience, showing you how the system works by watching it in action.

Time commitment: 30-45 minutes
What you'll gain: Confidence using Claude with intelligent assistance


🛠️ How-To Guides

Task-oriented - For competent users solving specific problems

Choose the guide that matches your current need:


📖 Reference

Information-oriented - For looking up facts while working

Quick reference for when you need specific details:

  • CLI Commands - Complete command reference with options and examples
  • Hook API - Technical specification for hook input/output

💡 Explanation

Understanding-oriented - For gaining deeper insight

Read when you want to understand the "why" behind Claude Hooks:


🚀 Quick Start

New to Claude Hooks? → Start with the Tutorial

Need to solve a problem? → Check the How-To Guides

Looking up syntax or options? → Use the Reference

Want to understand how it works? → Read the Explanations


🤔 Which Type of Documentation Do I Need?

Use this decision tree:

Are you currently working on a task?
├─ Yes → Do you know what you want to accomplish?
│   ├─ Yes → How-To Guides 📋
│   └─ No → Reference 📖
└─ No → Are you learning or exploring?
    ├─ Learning → Tutorial 🎓
    └─ Understanding → Explanation 💡

📁 Project Navigation


🔍 Finding What You Need

Can't find what you're looking for?

  1. Search tip: Use your browser's find function (Ctrl+F / Cmd+F) on the reference pages
  2. GitHub search: Use the repository search to find specific terms across all documentation
  3. Start broader: If a specific how-to doesn't exist, try the tutorial or explanation first

Common documentation patterns:

  • All tutorials use "we" language and step-by-step instruction
  • All how-to guides start with "when to use this guide"
  • All reference pages are organized alphabetically and consistently formatted
  • All explanations can be read away from the computer

This organization ensures you get the right type of help for your current situation.