🔥 BREAKING CHANGE: Repository Restructure
PAI has been restructured for better GitHub UX and renamed for clarity!
⚠️ BREAKING CHANGES
1. PAI_DIR Environment Variable:
# OLD (v0.3.x and earlier):
export PAI_DIR="/path/to/PAI/PAI_DIRECTORY"
# NEW (v0.4.0+):
export PAI_DIR="/path/to/PAI"2. Repository Renamed:
- Old:
danielmiessler/PAI - New:
danielmiessler/Personal_AI_Infrastructure - GitHub automatically redirects old URL to new URL
- All existing links continue to work
🏗️ What Changed
Flattened Repository Structure:
Before (v0.3.x): After (v0.4.0):
PAI/ PAI/
├── PAI_DIRECTORY/ ├── agents/
│ ├── agents/ ├── commands/
│ ├── commands/ ├── documentation/
│ ├── skills/ ├── hooks/
│ └── ... ├── skills/
├── README.md ├── voice-server/
└── ... ├── .env.example
├── .mcp.json
├── settings.json
├── README.md
└── ...
Repository Renamed:
- Repository renamed from
PAItoPersonal_AI_Infrastructure - Clearer, more descriptive name
- Better SEO and discoverability
- GitHub automatically redirects old URL
Benefits:
- ✅ Functional directories immediately visible on GitHub
- ✅ No extra click required to see actual content
- ✅ More conventional repository structure
- ✅ Cleaner navigation for new users
- ✅ Better first impression for newcomers
📦 Migration Steps
1. Update PAI_DIR in shell config:
# Edit ~/.zshrc or ~/.bashrc
export PAI_DIR="/path/to/PAI" # Remove /PAI_DIRECTORY2. Reload your shell:
source ~/.zshrc # or source ~/.bashrc3. Pull latest changes:
cd /path/to/PAI
git pull4. Update git remote URL (optional but recommended):
git remote set-url origin git@github.com:danielmiessler/Personal_AI_Infrastructure.git
# Or for HTTPS:
git remote set-url origin https://github.com/danielmiessler/Personal_AI_Infrastructure.git📖 Documentation Updates
- Added prominent v0.4.0 breaking change notice to README
- Updated installation instructions
- Updated all path references throughout documentation
- Updated environment variables section
- Added comprehensive migration guide
- Made core mission statement prominent and centered
🎯 Why This Change
The previous nested structure (PAI_DIRECTORY/) added an unnecessary layer that made the repository less intuitive on GitHub. Users had to click into PAI_DIRECTORY/ to see the actual functional directories.
This restructure brings PAI in line with conventional repository layouts where functional code is immediately visible at the root.
📊 Statistics
- 810+ files moved to root
- Complete Fabric repository (242 patterns) structure preserved
- All git history maintained (100% renames)
- Zero content changes - pure structural refactor
🔗 Links
- Repository: https://github.com/danielmiessler/Personal_AI_Infrastructure
- Documentation: https://github.com/danielmiessler/Personal_AI_Infrastructure/tree/main/documentation
- Issues: https://github.com/danielmiessler/Personal_AI_Infrastructure/issues
Full Changelog: v0.3.2...v0.4.0