diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..74e68da
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to SuperClaude will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.1] - 2025-06-26
+
+### Added
+- `--introspect` flag for framework self-analysis and improvement capabilities
+- Enhanced SuperClaude identity declaration with mission statement
+
+### Fixed
+- Corrected file count reporting in install.sh verification process
+- Resolved critical file copying issues in install.sh
+
+## [2.0.0] - 2025-06-26
+
+### Added
+- Comprehensive security and robustness improvements to install.sh
+- Optimize all 18 command files using @include reference system
+- Commands cheat sheet documentation
+- Custom installation directory support (#4)
+- Community interaction files (CONTRIBUTING.md, CODE_OF_CONDUCT.md)
+- MIT License
+
+### Changed
+- Complete migration to v2 with @include reference system
+- Standardized @include reference system across all command files
+- Migrated PERSONAS to flag system for Claude Code compliance
+- Transformed README.md into engaging developer-friendly format
+- Major optimization achieving 35% token reduction through template system & file consolidation
+- Enhanced Task Management System - Adaptation of PR #5 (#7)
+
+### Removed
+- All hard claims, metrics, and numeric targets
+- All references to user: and project: prefixes
+- References to deleted scripts and pattern system
+
+### Fixed
+- Shared resources count in install.sh
+- .gitignore configuration and removed logs/claudedocs from tracking
+
+## [1.0.0] - 2025-06-22
+
+### Added
+- Initial release of SuperClaude v1.0.0 configuration framework
+- Core configuration system with CLAUDE.md
+- Command system with 18 optimized command files
+- Shared resources and patterns
+- Installation script (install.sh)
+- Comprehensive documentation
+
+---
+
+*Note: This changelog was generated from git history. For detailed commit messages, run `git log`.*
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 659325c..2d88f05 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -49,6 +49,8 @@ Thanks for contributing to SuperClaude! This guide helps you get started.
 ## Development Guidelines
 
 ### File Structure
+
+**Repository Structure:**
 ```
 SuperClaude/
 ├── CLAUDE.md, RULES.md, PERSONAS.md, MCP.md  # Core configs
@@ -58,6 +60,14 @@ SuperClaude/
 └── README.md                                 # Documentation
 ```
 
+**After Installation (in ~/.claude/):**
+```
+~/.claude/
+├── CLAUDE.md, RULES.md, PERSONAS.md, MCP.md  # Installed configs
+├── commands/                                  # Installed commands
+└── commands/shared/                          # Installed resources
+```
+
 ### Code Standards
 - **YAML**: 2-space indentation, descriptive keys
 - **Markdown**: Clear headers, consistent formatting
@@ -69,7 +79,6 @@ SuperClaude/
 - Verify slash commands work in Claude Code
 - Check YAML syntax validity
 - Test personas & MCP integration
-- Run `validate-references.sh` to check @pattern system
 
 ## Submission Process
 
@@ -141,7 +150,7 @@ Description & purpose
 2. **Purpose**: Reusable configurations & @pattern templates
 3. **Naming**: descriptive-name.yml
 4. **Structure**: Clear, documented sections
-5. **Validation**: Use `validate-references.sh` to check @pattern links
+5. **Validation**: Check @pattern links manually for correctness
 
 ## Persona Development
 
diff --git a/README.md b/README.md
index 5c8c842..1875c6e 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,8 @@ cd SuperClaude
 
 Zero dependencies. Installs to `~/.claude/` by default.
 
+**Note:** After installation, all configuration files are located in `~/.claude/` (your home directory), not in the project directory.
+
 ## 💡 Core Capabilities
 
 ### 🧠 **Cognitive Personas (Now as Flags!)**
@@ -117,6 +119,8 @@ Development lifecycle coverage:
 - **Magic**: AI-generated UI components
 - **Puppeteer**: Browser testing and automation
 
+**⚠️ Important:** SuperClaude does not include MCP servers. You need to install them separately in Claude Code's MCP settings to use MCP-related flags (--c7, --seq, --magic, --pup).
+
 ### 📊 **Token Efficiency**
 SuperClaude's @include template system helps manage token usage:
 - **UltraCompressed mode** option for token reduction
diff --git a/SECURITY.md b/SECURITY.md
index 6c60cbe..5527413 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -4,8 +4,8 @@
 
 | Version | Supported |
 |---------|-----------|
-| 4.0.x   | ✅ Yes    |
-| < 4.0   | ❌ No     |
+| 2.0.x   | ✅ Yes    |
+| < 2.0   | ❌ No     |
 
 ## Reporting Security Vulnerabilities