Update all concept README files with comprehensive documentation

Extract and consolidate information from claude_concepts_guide.md into
individual concept folders:

- 01-slash-commands: Add architecture diagrams, features table, lifecycle
  diagram, best practices, and comprehensive examples
- 02-subagents: Add architecture, configuration, tool access hierarchy,
  context management, and practical delegation examples
- 03-memory: Add memory hierarchy, locations table, lifecycle diagram,
  4 practical examples, and features comparison
- 04-mcp: Add MCP architecture, ecosystem, setup process, 4 examples
  (GitHub, Database, Multi-MCP, Filesystem), and security best practices
- 05-skills: Add skill architecture, loading process, 3 complete examples
  with Python scripts (Code Review, Brand Voice, Documentation Generator)
- 06-plugins: Add plugin architecture, marketplace, lifecycle, 3 examples,
  features comparison, and publishing guide
- 07-hooks: Add hook types table, common examples, variables, 5 practical
  examples with code, and best practices
- 08-checkpoints: Add key concepts, all commands, use cases table,
  configuration, 4 practical examples, and troubleshooting
- 09-advanced-features: Add Planning Mode, Extended Thinking, Background
  Tasks, Permission Modes, Headless Mode, Session Management, interactive
  features, and complete configuration examples

All READMEs now include:
- Overview sections with clear explanations
- Mermaid diagrams for visual understanding
- Comprehensive tables and feature comparisons
- Practical code examples and templates
- Installation instructions
- Best practices and troubleshooting
- Cross-references to related concepts

Total changes: +3706 lines of comprehensive documentation

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Luong NGUYEN
2025-11-08 01:51:06 +01:00
parent d17564a9f2
commit 41527aed26
9 changed files with 3776 additions and 657 deletions

View File

@@ -2,24 +2,47 @@
Checkpoints allow you to save conversation state and rewind to previous points in your Claude Code session. This is invaluable for exploring different approaches, recovering from mistakes, or comparing alternative solutions.
## What Are Checkpoints?
## Overview
Checkpoints are snapshots of your conversation state, including:
Checkpoints allow you to save conversation state and rewind to previous points, enabling safe experimentation and exploration of multiple approaches. They are snapshots of your conversation state, including:
- All messages exchanged
- File modifications made
- Tool usage history
- Session context
Checkpoints are invaluable when exploring different approaches, recovering from mistakes, or comparing alternative solutions.
## Key Concepts
### Checkpoint
A saved point in your conversation that you can return to later.
| Concept | Description |
|---------|-------------|
| **Checkpoint** | Snapshot of conversation state including messages, files, and context |
| **Rewind** | Return to a previous checkpoint, discarding subsequent changes |
| **Branch Point** | Checkpoint from which multiple approaches are explored |
### Rewind
The action of returning to a previous checkpoint, discarding all changes made after that point.
## Commands
### Branch Point
A checkpoint where you explored multiple different approaches.
All checkpoint operations are performed using the `/checkpoint` command:
```bash
# Create checkpoint
/checkpoint save "Before refactoring"
# List checkpoints
/checkpoint list
# Rewind to checkpoint
/checkpoint rewind "Before refactoring"
# Compare checkpoints
/checkpoint diff checkpoint-1 checkpoint-2
# Delete checkpoint
/checkpoint delete checkpoint-1
# Export checkpoint
/checkpoint export "name" ~/checkpoints/backup.json
```
## Creating Checkpoints
@@ -41,6 +64,15 @@ User: /checkpoint save "Before API refactor"
User: /checkpoint create pre-deployment
```
## Use Cases
| Scenario | Workflow |
|----------|----------|
| **Exploring Approaches** | Save → Try A → Save → Rewind → Try B → Compare |
| **Safe Refactoring** | Save → Refactor → Test → If fail: Rewind |
| **A/B Testing** | Save → Design A → Save → Rewind → Design B → Compare |
| **Mistake Recovery** | Notice issue → Rewind to last good state |
## Using Checkpoints
### List Checkpoints
@@ -308,7 +340,7 @@ Poor checkpoint names:
## Configuration
Configure checkpoint behavior in settings:
Configure checkpoint behavior in settings. Here's the comprehensive configuration with all available options:
```json
{
@@ -324,11 +356,11 @@ Configure checkpoint behavior in settings:
### Configuration Options
- `autoCheckpoint`: Enable automatic checkpoints
- `autoCheckpointInterval`: Minutes between auto-checkpoints
- `maxCheckpoints`: Maximum number of checkpoints to retain
- `compressionEnabled`: Compress checkpoint data
- `includeFileContents`: Include full file contents in checkpoints
- `autoCheckpoint`: Enable automatic checkpoints (default: true)
- `autoCheckpointInterval`: Minutes between auto-checkpoints (default: 30)
- `maxCheckpoints`: Maximum number of checkpoints to retain (default: 20)
- `compressionEnabled`: Compress checkpoint data to save space (default: true)
- `includeFileContents`: Include full file contents in checkpoints (default: true)
## Limitations
@@ -424,3 +456,24 @@ Use both together:
5. Verify system works
6. Proceed cautiously
```
## Related Concepts
- **[Planning Mode](../07-planning/)** - Create detailed implementation plans before coding
- **[Memory Management](../06-memory/)** - Managing conversation history and context
- **[Code Navigation](../05-code-navigation/)** - Understanding and navigating your codebase
- **[Real-time Collaboration](../09-collaboration/)** - Working with teams using Claude Code
- **[Error Handling](../10-error-handling/)** - Handling and recovering from errors
- **[Best Practices](../11-best-practices/)** - General best practices for Claude Code usage
## Summary
Checkpoints are a powerful feature for safe exploration and experimentation in Claude Code. By combining checkpoints with your development workflow, you can:
- Experiment fearlessly with multiple approaches
- Quickly recover from mistakes without losing work
- Compare different solutions side-by-side
- Maintain clean, organized development sessions
- Integrate safely with version control systems
The key to effective checkpoint usage is creating them at meaningful points in your work and using descriptive names that make it easy to find and rewind to the right state when needed.