# Claude PM Framework Documentation

**Last Updated**: 2025-07-14  
**Framework Version**: 0.7.0  
**Purpose**: Essential documentation for running and developing the Claude PM Framework

## Quick Navigation

### 🚀 Get Started
- **[Main Documentation Hub](INDEX.md)** - Complete framework overview and navigation
- **[User Guide](user-guide/)** - Complete setup and usage documentation
- **[Getting Started](user-guide/01-getting-started.md)** - Installation and first steps

### 🏗️ Development
- **[Design Patterns](design/)** - Project design templates and patterns
- **[Architecture](architecture/)** - Current system architecture
- **[Development Workflow](development/)** - Development best practices

### 🛠️ Operations
- **[Tools](tools/)** - Development and validation tools
- **[Operations](operations/)** - System operations and monitoring
- **[Troubleshooting](troubleshooting/)** - Problem resolution guides

## Core Documentation

### Essential Documents
- **INDEX.md** - Main documentation hub with comprehensive navigation
- **context-population-patterns.md** - Active development patterns for agent coordination  
### Directory Structure
- **[user-guide/](user-guide/)** - Complete user documentation and tutorials
- **[design/](design/)** - Design patterns, templates, and project planning guides  
- **[architecture/](architecture/)** - System architecture and technical specifications
- **[development/](development/)** - Development workflows and best practices
- **[operations/](operations/)** - System operations and monitoring
- **[troubleshooting/](troubleshooting/)** - Problem resolution and debugging
- **[tools/](tools/)** - Development and validation tools
- **[knowledge/](knowledge/)** - Knowledge base and reference materials
- **[archive/](archive/)** - Historical and reference documentation

## 🗂️ Documentation Organization

### What's In Main docs/
The main documentation directory contains only essential, actively-used documentation:

- **Navigation**: INDEX.md provides comprehensive framework navigation
- **User Documentation**: Complete user guide with setup, usage, and advanced features
- **Current Architecture**: Up-to-date technical architecture and design patterns
- **Active Tools**: Currently maintained development and validation tools
- **Current Operations**: Present-day operational procedures and monitoring

### What's In archive/
Historical and reference documentation has been organized into `/docs/archive/`:

- **Comprehensive Guides**: The 12 numbered comprehensive guides (reduced cognitive load)
- **Version-Specific**: Documentation tied to specific framework versions
- **Analysis Reports**: Framework research and gap analysis documents  
- **Epic Documents**: Historical epic planning and strategy documents

See **[archive/ARCHIVE_README.md](archive/ARCHIVE_README.md)** for complete details on archived content.

## 🎯 Documentation Goals

### Clarity and Simplicity
- **Reduced Cognitive Load**: Main directory focuses on essential, daily-use documentation
- **Clear Navigation**: INDEX.md provides comprehensive navigation hub
- **User-Focused**: Documentation organized around user workflows and needs

### Accuracy and Currency
- **Current Information**: Main docs reflect current framework capabilities (v0.7.0)
- **No Outdated Content**: Version-specific and historical content properly archived
- **Regular Updates**: Documentation maintained alongside framework development

### Accessibility
- **Progressive Disclosure**: Information organized from basic to advanced
- **Multiple Entry Points**: Quick navigation for different user types
- **Complete Coverage**: From installation to advanced customization

## 🚀 Getting Started

### New Users
1. **[Start Here](INDEX.md)** - Complete framework overview
2. **[Installation](user-guide/01-getting-started.md)** - Setup and configuration
3. **[First Project](user-guide/01-getting-started.md#quick-start-example)** - Create your first project

### Developers
1. **[Architecture Overview](user-guide/02-architecture-concepts.md)** - Understand the framework
2. **[Design Patterns](design/)** - Project templates and patterns
3. **[Development Workflow](development/)** - Best practices and procedures

### Administrators
1. **[Installation Guide](user-guide/01-getting-started.md)** - System setup
2. **[Operations Guide](operations/)** - Monitoring and maintenance
3. **[Troubleshooting](troubleshooting/)** - Problem resolution

## 📋 Documentation Maintenance

### Regular Updates
- **Framework Changes**: Documentation updated with framework releases
- **User Feedback**: Improvements based on user experience and feedback
- **Link Validation**: Regular validation of internal and external links
- **Content Review**: Periodic review for accuracy and relevance

### Contributing
- **Issues**: Report documentation issues through GitHub
- **Pull Requests**: Submit improvements and corrections
- **Feedback**: Share documentation experience and suggestions
- **Testing**: Help validate documentation accuracy

---

**Cleanup Date**: 2025-07-14  
**Organization**: Essential docs in main directory, historical in archive  
**Focus**: Running and developing the Claude PM Framework