Releases: danielmiessler/Personal_AI_Infrastructure
PAI v2.5.0 — Think Deeper, Execute Faster
PAI v2.5.0 — Think Deeper, Execute Faster
The Algorithm learns to think about how it thinks—and do more work in parallel
What Changed
v2.4 introduced The Algorithm—a 7-phase approach to problem-solving with verifiable criteria. It worked, but it had blind spots: it picked capabilities based on habit rather than analysis, it skipped thinking tools without justification, and it ran independent tasks one at a time when they could have run simultaneously.
v2.5 fixes all three.
The Problem v2.5 Solves
v2.4's Algorithm:
Pick familiar tools → Execute sequentially → Hope the right capabilities were chosen
v2.5's Algorithm:
Hook suggests capabilities → Reverse-engineer true intent → Validate suggestions against ISC →
Justify every tool inclusion/exclusion → Execute independent work in parallel → Verify
The difference is metacognition. The Algorithm now thinks about how it thinks before it acts.
Three Major Features
1. Two-Pass Capability Selection
Previously, capability selection happened implicitly—the system defaulted to familiar patterns (usually Engineer + Research) regardless of what the task actually needed.
Now selection happens in two explicit passes:
Pass 1 — Hook Hints (before the Algorithm starts)
The FormatReminder hook runs AI inference on the raw prompt and suggests capabilities, skills, and thinking tools. These are draft suggestions—a head start, not a decision.
Pass 2 — THINK Validation (after OBSERVE completes)
With the full context of reverse-engineering and ISC criteria, the THINK phase validates every suggestion. Skills get added, removed, or confirmed. Pass 2 is authoritative.
🔍 SKILL CHECK (validate hook hints against ISC):
│ Hook suggested: CreateSkill:UpdateSkill
│ ISC requires: Architecture design (not just skill update)
│ Final skills: CreateSkill:UpdateSkill + Architect consultation
Why two passes? The hook gives a head start from the raw prompt. But OBSERVE changes the picture. A request that looks like a simple skill update might actually require architectural decisions, or might rest on questionable assumptions that need First Principles analysis. Pass 2 catches what Pass 1 cannot see.
2. Thinking Tools with Justify-Exclusion
v2.4 had thinking tools (Council, RedTeam, FirstPrinciples, etc.) but they were rarely used because the default was to skip them. v2.5 inverts this: thinking tools are opt-OUT, not opt-IN.
For every request, the Algorithm must evaluate each thinking tool and justify why it is NOT being used:
🔍 THINKING TOOLS ASSESSMENT (justify exclusion):
│ Council: EXCLUDE — single clear approach, no alternatives to debate
│ RedTeam: INCLUDE — proposal could fail in non-obvious ways
│ FirstPrinciples: INCLUDE — requirement rests on unexamined assumption
│ Science: EXCLUDE — not iterative/experimental
│ BeCreative: EXCLUDE — clear requirements, no divergence needed
│ Prompting: EXCLUDE — not generating prompts
The burden of proof is on exclusion. "Too simple" and "already know the answer" are not valid reasons—simple tasks can have hidden assumptions, and confidence without verification is exactly the failure mode this catches.
The Six Thinking Tools
| Tool | What It Does | Include When |
|---|---|---|
| Council | Multi-agent debate with 3-7 agents | Multiple valid approaches exist |
| RedTeam | Adversarial analysis with 32 agents | Claims need stress-testing |
| FirstPrinciples | Deconstruct, challenge, reconstruct | Assumptions need examining |
| Science | Hypothesis-test-analyze cycles | Iterative experimentation needed |
| BeCreative | Extended thinking, 5 diverse options | Creative divergence needed |
| Prompting | Meta-prompting with templates | Prompt optimization needed |
3. Parallel-by-Default Execution
When the Algorithm identifies independent tasks during BUILD/EXECUTE, they now launch simultaneously as concurrent agents in a single message. Serial execution of independent tasks is a failure mode.
BEFORE (v2.4): AFTER (v2.5):
Task A → wait Task A ─┐
Task B → wait Task B ─┼─ all at once
Task C → wait Task C ─┘
Task D → done Task D → done
The rule is simple: If tasks don't depend on each other's output, they run at the same time. Period.
This applies automatically to:
- Multiple file edits with no cross-dependencies
- Multiple research queries on different topics
- Multiple audits or scans of independent systems
- Multiple creation tasks with no shared state
Fan-out is the default pattern for 3+ independent workstreams.
Composition Patterns
Capabilities now combine using 7 named patterns, making orchestration explicit and visible:
| Pattern | Shape | Example | When |
|---|---|---|---|
| Pipeline | A → B → C | Explore → Architect → Engineer | Sequential domain handoff |
| TDD Loop | A ↔ B | Engineer ↔ QA | Build-verify cycle until ISC passes |
| Fan-out | → [A, B, C] | 3 Researchers in parallel | Multiple perspectives needed |
| Fan-in | [A, B, C] → D | Researchers → Synthesis | Merging parallel results |
| Gate | A → check → B or retry | Engineer → QA → Deploy or fix | Quality gate before progression |
| Escalation | A(haiku) → A(sonnet) → A(opus) | Model upgrade on failure | Complexity exceeded model tier |
| Specialist | Single A | Pentester for security review | One domain, deep expertise |
The full Capability Selection block in THINK phase now looks like:
🎯 CAPABILITY SELECTION:
│ Skills: CreateSkill:UpdateSkill
│ Thinking: FirstPrinciples, RedTeam
│ Primary: Architect — system design decision (ISC #1)
│ Support: Engineer — implementation (ISC #2-4)
│ Verify: QATester — browser verification (ISC #5)
│ Pattern: Pipeline
│ Sequence: Architect → Engineer → QATester
│ Rationale: Architecture must be decided before implementation begins
What's New in v2.5
Major Features
| Feature | Description |
|---|---|
| Two-Pass Capability Selection | Hook hints validated against ISC in THINK phase |
| Thinking Tools Assessment | 6 tools evaluated with justify-exclusion principle |
| Parallel-by-Default Execution | Independent tasks run concurrently, not sequentially |
| 7 Composition Patterns | Named patterns for combining capabilities |
| Mandatory AskUserQuestion | All user questions use structured tool, not inline text |
| 28 Skills | Refined from 29—CORE renamed to PAI |
| 17 Hooks | 2 new hooks for deeper system awareness |
| 356 Workflows | Expanded automation coverage |
Algorithm Upgrades (v0.2.23 → v0.2.25)
| Version | Change |
|---|---|
| v0.2.23 | Two-Pass Capability Selection, Skill Check in THINK, FormatReminder hook enrichment |
| v0.2.24 | Thinking Tools Assessment, justify-exclusion principle, mandatory AskUserQuestion |
| v0.2.25 | Parallel-by-default execution, fan-out as default pattern |
Structural Changes
- CORE → PAI — The core skill renamed from
COREtoPAIfor clarity - Consolidated SKILL.md — Single authoritative source for all PAI components with dynamic context loading
- INSTALL.ts — Wizard renamed from
PAIInstallWizard.tstoINSTALL.ts - INSTALL.md — New installation documentation added
- MEMORY structure — Updated directory organization for learning capture
- Settings template — Cleaner defaults with contextFiles updates
Full Release Contents
.claude/
├── INSTALL.ts # Interactive setup wizard
├── INSTALL.md # Installation documentation
├── settings.json # Template configuration
├── statusline-command.sh # 4-mode responsive status line
├── statusline-debug.sh # Status line debugging
│
├── hooks/ # 17 event hooks
│ ├── FormatReminder.hook.ts # AI-powered depth classification
│ ├── ExplicitRatingCapture.hook.ts
│ ├── ImplicitSentimentCapture.hook.ts
│ ├── RelationshipMemory.hook.ts
│ ├── SoulEvolution.hook.ts
│ └── ... (12 more)
│
├── skills/ # 28 production skills
│ ├── PAI/ # The Algorithm and system core
│ ├── Agents/ # Agent personalities and spawning
│ ├── Art/ # Visual content creation
│ ├── Browser/ # Playwright automation
│ ├── Research/ # Multi-model parallel research
│ ├── Fabric/ # 235 prompt patterns
│ └── ... (22 more)
│
├── agents/ # 12 named agent definitions
├── lib/ # Shared utilities
├── MEMORY/ # Learning capture system
├── Observability/ # Real-time monitoring dashboard
└── VoiceServer/ # Voice notification server
Quick Start
# 1. Clone the repo (if you haven't already)
git clone https://github.com/danielmiessler/PAI.git
...PAI v2.4.0 — The Algorithm
PAI v2.4.0 — The Algorithm
Our first attempt at a general problem solver built into PAI to pursue Euphoric Surprise.
The Algorithm
v2.4 introduces a structured, 7-phase approach to problem-solving. It's an experiment in making AI work more verifiable.
| Phase | Name | Purpose |
|---|---|---|
| 1 | OBSERVE | Gather information, understand current state |
| 2 | THINK | Analyze intent, desired outcome, failure modes |
| 3 | PLAN | Build Ideal State Criteria (ISC) - testable success conditions |
| 4 | BUILD | Construct the solution components |
| 5 | EXECUTE | Take action, track progress against criteria |
| 6 | VERIFY | Confirm all criteria met with evidence |
| 7 | LEARN | Capture insights, define next steps |
Ideal State Criteria (ISC)
The core mechanism is exactly 8-word, binary-testable conditions that define success. If you can define testable criteria upfront, you can actually verify whether something worked.
What's New
| Feature | Description |
|---|---|
| The Algorithm | 7-phase problem-solving with ISC tracking |
| 29 Skills | Up from 20—expanded domain coverage |
| 15 Hooks | Refined hook architecture |
| 331 Workflows | Comprehensive automation library |
| Improved Wizard | Better interactive setup with voice support |
| Voice Notifications | ElevenLabs integration for spoken alerts |
| Observability Dashboard | Real-time system monitoring |
| AllowList Enforcement | Security control for releases |
Installation
git clone https://github.com/danielmiessler/PAI.git
cd PAI/Releases/v2.4
[ -d ~/.claude ] && mv ~/.claude ~/.claude-backup-$(date +%Y%m%d)
cp -r .claude ~/
cd ~/.claude && bun run PAIInstallWizard.tsNamed Agents
| Agent | Specialty |
|---|---|
| Algorithm | ISC tracking, verification work |
| Architect | System design, distributed systems |
| Engineer | TDD, implementation patterns |
| Artist | Visual content, prompt engineering |
| Designer | UX/UI, accessibility |
| QATester | Browser automation, verification |
| Pentester | Security testing |
| Intern | High-agency generalist |
Full Documentation
See Releases/v2.4/README.md for complete documentation.
PAI v2.3.0 - Full Releases Return
PAI v2.3.0 - Full Releases Return
The most significant release since v2.0. PAI v2.3 brings back complete, functional releases while maintaining the modular Packs system. Now you can install PAI two ways: grab individual packs for specific capabilities, or download a complete .claude/ directory and start immediately.
🎯 Highlights
Full Releases Are Back
The Releases/v2.3/.claude/ directory contains a complete, functional PAI installation. Copy it to ~/.claude/ and you're running. No assembly required.
This addresses the most common feedback since v2.0: "I love the modular approach, but I just want the whole thing." Now you have both options.
Euphoric Surprise
PAI v2.3 introduces Euphoric Surprise as the north star—the singular pursuit that drives every interaction. Not just task completion, but results so thorough and thoughtful that you're genuinely surprised and delighted. This philosophy is now embedded throughout the documentation and skill design.
Customization as Principle #1
The PAI Founding Principles have been updated. Customization for Your Goals is now Principle #1—PAI exists to help you accomplish your goals in life. It democratizes access to personalized agentic infrastructure that knows your context, preferences, and history.
📦 What's in v2.3
Complete Release (Releases/v2.3/.claude/)
| Component | Count | Description |
|---|---|---|
| Skills | 22 | Full skill modules with workflows |
| Named Agents | 11 | Agents with personalities (Artist, Architect, Engineer, etc.) |
| Hooks | 15 | Lifecycle event handlers |
| Fabric Patterns | 100+ | Reusable prompt patterns |
Skills Included:
- Core: CORE, System, THEALGORITHM
- Research: Research, OSINT, PrivateInvestigator, AnnualReports
- Creative: Art, Prompting, Council, RedTeam
- Development: Browser, CreateCLI, CreateSkill, Agents
- Infrastructure: PAIUpgrade, BrightData, Telos, FirstPrinciples, Recon
Named Agents:
Artist, QATester, Architect, Designer, GeminiResearcher, GrokResearcher, CodexResearcher, Pentester, Intern, Engineer, ClaudeResearcher
Updated Packs (23 total)
All packs updated to v2.3 standards:
- Standardized INSTALL.md with AI wizard format
- Icon references in all READMEs
- Consistent versioning
⚡ Installation
Option 1: Full Installation (Recommended for New Users)
# Download v2.3 release
# Copy .claude/ to your home directory
cp -r Releases/v2.3/.claude ~/.claude
# Run installation wizard
cd ~/.claude && bun run install.ts
# Start using PAI
claudeOption 2: Individual Packs (Existing Users)
Browse Packs/ and install specific capabilities. Each pack is self-contained with complete instructions.
🔄 Changes Since v2.1.0
Major
- Full releases restored - Complete
.claude/directory inReleases/v2.3/ - 23 packs updated for v2.3 release
- Euphoric Surprise added as north star
- Customization elevated to Principle #1
- Visual README redesign with technical diagrams
Infrastructure
- Retired
pai-history-system, migrated to MEMORY in core - Security system upgrade to directory-based architecture
- Voice integration improvements in
pai-core-install - All pack INSTALL.md standardized to AI wizard format
Documentation
- Comprehensive README overhaul
- ELI5 section for newcomers ("Wait, Hold On—Assume I'm New to All This")
- Updated typing animation and badges
- Logo updated to v7
🚀 Getting Started
- Watch the walkthrough: PAI Overview Video
- Read the philosophy: The Real Internet of Things
- Understand the vision: Personal AI Maturity Model
📊 Stats
- 34 commits since v2.1.0
- 22 skills in full release
- 11 named agents with personalities
- 23 packs available
- 100+ fabric patterns included
PAI - Magnifying human capabilities through personalized AI infrastructure.
Everyone deserves AI that gets better at helping them over time. This is open-source. This is free. This is for everyone.
PAI v2.1.0 - Major Core Upgrade & New Upgrades Skill
PAI v2.1.0 - Major Core Upgrade & New Upgrades Skill
This release includes significant updates to the core infrastructure and introduces a new skill for tracking system upgrades.
Major Updates
pai-core-install v1.2.0 (Major Upgrade)
The core pack received its biggest update yet:
- NEW: MEMORY/ skeleton - 11-directory structure for session history, learnings, decisions, and state management
- NEW: settings.json.template - Complete hook configuration template with all events pre-configured
- USER/ directory (15 templates) - Personal configuration for identity, contacts, preferences
- SYSTEM/ directory (17 templates) - System architecture documentation for skills, hooks, memory, delegation
- Wizard-style installation - The installer now walks you through setup step-by-step with clear phases
This update transforms pai-core-install from a basic foundation into a complete infrastructure framework.
pai-browser-skill v1.2.0
Enhanced browser automation with debug-first philosophy:
- Always-on diagnostics and console capture
- Session auto-start capability
- 99% token savings through file-based MCP pattern
NEW: pai-upgrades-skill v1.0.0
A new skill for tracking and managing PAI system upgrades:
- Monitors for new features and capabilities
- Tracks upgrade opportunities
- Maintains upgrade history
- Helps plan and prioritize system improvements
Documentation Updates
- Updated pack count badge (8 → 10 packs)
- Fixed bundle references (Kai/ → Official/)
- Updated installation order with new skill
- Refreshed version numbers across all documentation
Install
# Fresh install
cd PAI/Bundles/Official && bun run install.ts
# Upgrade existing installation
cd PAI/Bundles/Official && bun run install.ts --updateWhat's Next
- More skills coming to the pack ecosystem
- Enhanced wizard-style installation across all packs
- Community contributions welcome!
Full Changelog: v2.0.0...v2.1.0
v2.0.0 - PAI Packs System Launch
PAI v2.0.0 - PAI Packs System Launch
Major Architecture Shift
- Transitioned from "mirrored system" approach to modular PAI Packs
- Packs are self-contained, AI-installable capability bundles
- Platform-agnostic design: works with Claude Code, OpenCode, Gemini Code, GPT-Codex, or custom systems
Available Packs (8)
- kai-core-install - Foundation pack with skill routing, identity, and architecture tracking
- kai-hook-system - Event-driven hook architecture
- kai-history-system - Automatic context-tracking
- kai-voice-system - Voice notifications with ElevenLabs TTS
- kai-art-skill - Visual content creation
- kai-prompting-skill - Meta-prompting system
- kai-agents-skill - Dynamic agent composition
- kai-observability-server - Real-time agent monitoring
Available Bundles (1)
- kai-core-bundle - Complete Kai infrastructure (4 foundational packs)
Why the Change?
- v1.x tried to mirror the entire Kai system - too fragile, too many interdependencies
- v2.0 extracts battle-tested features as independent, installable modules
- Each pack is like learning kung-fu in The Matrix - a complete capability download
Documentation
- Full pack template specification
- Complete pack system documentation
- Updated README with 14 Founding Principles and installation guide
v0.9.0 - Platform Agnostic Release
PAI v0.9.0 - Platform Agnostic Release
This release focuses on making PAI fully portable and fork-friendly. Your AI, your identity, your system.
Highlights
Observability Dashboard
- Complete real-time agent monitoring at
.claude/Observability/ - WebSocket streaming of all agent activity
- Live pulse charts, event timelines, and swim lanes
- Multiple themes (Tokyo Night, Nord, Catppuccin, etc.)
- Security obfuscation for sensitive data
- Run with:
~/.claude/Observability/manage.sh start
Genericized Agent Identity
- All agent references now use
process.env.DA || 'main' - No more hardcoded names - your DA name flows through the entire system
- Observability dashboard shows your configured identity
- Color system supports any DA name with intelligent defaults
Platform-Agnostic Configuration
- Added
_envDocsto settings.json explaining all environment variables - Clear separation:
settings.jsonfor identity/paths,.envfor API keys DA(Digital Assistant name) - your AI's identityPAI_DIR- root directory for all configurationTIME_ZONE- configurable timezone for timestamps
Statusline Enhancements
- Terminal color compatibility mode for different terminal emulators
- Dynamic Claude Code version display
- Cleaner greeting format
Skill System Improvements
- Canonical TitleCase file naming throughout
- Standardized skill-workflow-notification script for dashboard detection
- All paths use
${PAI_DIR}/for location-agnostic installation
Breaking Changes
None - this release is backwards compatible.
Upgrade Instructions
cd ~/.claude # or your PAI_DIR
git pull origin mainIf using a fresh install, follow the Quick Start in README.md.
Full Changelog: v0.7.0...v0.9.0
v0.7.0: Security, Skills, and Infrastructure Hardening
What's New in v0.7.0
Major release with 18 commits of improvements since v0.6.0.
🔒 Security
- Comprehensive prompt injection and input validation guidance
- Security hardening for art skill (removed Discord/Midjourney integration)
✨ New Skills
- BrightData - Four-tier progressive web scraping skill with complete MCP installation docs
- Art - PAI visual aesthetic system (Tron + Anthropic + Excalidraw fusion)
- Story-explanation - Narrative summary generation
- System-createskill and system-createcli - Meta-skills for building skills and CLIs
🏗️ Infrastructure
PAI_DIRwrapper and protection system- PAI vs Kai clarity documentation
- Comprehensive event capture hook system
- Complete MCP installation instructions
📚 Documentation
- Fixed all broken documentation links and references
- CORE skill is now the canonical documentation source
- Added 10 sanitized CORE skill files for public template
- Hook system branding updated from Kai to PAI
Full Changelog: v0.6.0...v0.7.0
v0.6.0 - Major Repository Restructure with .claude/ Directory
🔥 v0.6.0 - MAJOR UPGRADE: Repository Restructured with .claude/ Directory
⚠️ BREAKING CHANGE
The repository structure has been completely reorganized. All PAI infrastructure now lives in the .claude/ directory to properly mirror how PAI works in production.
🎯 What Changed
Repository Structure (Before → After)
Before (v0.5.0):
/PAI/
├── agents/
├── commands/
├── documentation/
├── hooks/
├── skills/
├── voice-server/
├── settings.json
└── README.md
After (v0.6.0):
/PAI/
├── .claude/ # ← All PAI infrastructure
│ ├── agents/
│ ├── commands/
│ ├── documentation/
│ ├── hooks/
│ ├── skills/
│ ├── voice-server/
│ ├── settings.json
│ ├── .mcp.json
│ └── setup.sh
├── README.md # GitHub files stay at root
├── LICENSE
└── .gitignore
🚀 Why This Matters
The Problem
Users reported issues with PAI not working correctly because the repository structure didn't match the actual working system. The real PAI system expects all infrastructure to live in ~/.claude/, but the repo had everything at root level, causing:
- Confusion about where files should go
- Compatibility issues during setup
- Difficulty using the repo as a reference
The Solution
- Proper Emulation: Repository now accurately represents how PAI works in production
- Easier Setup: Users can see exactly how their
~/.claude/directory should be structured - Less Confusion: Clear separation between GitHub files and PAI infrastructure
- Better Documentation: Structure itself serves as documentation
- Reference Implementation: Can be copied/referenced directly for setup
📦 Installation (New Users)
# Clone the repository
git clone https://github.com/danielmiessler/Personal_AI_Infrastructure.git
cd Personal_AI_Infrastructure
# Copy .claude directory to your home
cp -r .claude ~/.claude
# Configure environment
cp ~/.claude/.env.example ~/.claude/.env
vim ~/.claude/.env # Add your API keys
# Set environment variables (add to ~/.zshrc or ~/.bashrc)
export PAI_DIR="$HOME/PAI" # Points to repo root (for development)
export PAI_HOME="$HOME"🔄 Migration (Existing Users)
No action required for existing installations! Your ~/.claude/ directory is already set up correctly. This change only affects the repository structure, not your working installation.
If you want to update your installation:
cd $PAI_DIR # Your PAI repo
git pull
# Your existing ~/.claude/ continues to work as-is📋 What's Included
Files Moved to .claude/
- ✅ 8 agent definitions (
agents/) - ✅ 7 command files (
commands/) - ✅ 13 documentation files (
documentation/) - ✅ 11 hook scripts (
hooks/) - ✅ Full skills system including Fabric repo (
skills/) - ✅ Complete voice server (
voice-server/) - ✅ Configuration files (
settings.json,.mcp.json,.env.example) - ✅ Setup and utility scripts
Files Kept at Root (GitHub Infrastructure)
- ✅ README.md
- ✅ LICENSE
- ✅ SECURITY.md
- ✅ .gitignore
- ✅ .github/
📚 Documentation Updates
All documentation has been updated to reflect the new structure:
- ✅ README.md - Prominent MAJOR UPGRADE notice
- ✅ architecture.md - v0.6.0 structure notice
- ✅ how-to-start.md - Installation instructions updated
- ✅ QUICK-REFERENCE.md - Path references updated
- ✅ All path examples changed from
${PAI_DIR}/*to~/.claude/*
🔗 Related Issues
This release addresses user-reported compatibility issues and confusion about repository structure. The .claude/ organization makes PAI a proper reference implementation.
🙏 Thank You
Thank you to everyone who reported issues and provided feedback about the repository structure. This change makes PAI more accessible and easier to understand for new users.
Full Changelog: v0.5.0...v0.6.0
v0.4.0 - Repository Restructure 🔥 BREAKING CHANGE
🔥 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 [email protected]: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
v0.2.4 - README Cleanup & Organization
🧹 README Cleanup & Organization
This minor release focuses on improving the README organization and reducing visual clutter.
✨ What's New
- 📂 Collapsed Updates Section: Implemented two-level collapsing structure using nested
<details>tags (#27) - 🎯 Better Navigation: Significantly reduced vertical space taken by updates section
- 📊 Space Optimization: Updates now cleanly collapsed while maintaining full accessibility
- 🧹 Issue Management: Closed PR #24 after recent voice system updates
- ✅ Improved UX: All information remains accessible through intuitive collapse/expand interface
🔧 Changes
- Added parent
<details>wrapper around all update entries - Each update entry maintains its own collapsible state
- Most recent update (October 2, 2025) open by default
- Cleaner README with less scrolling required
📦 Installation
See the Quick Start Guide for installation instructions.
Full Changelog: v0.2.3...v0.2.4