The current README doesn't fully explain the hook system or the two-step installation process. I've written a detailed "How PAI Works" section that breaks down the architecture, the hook system, and the installation phases. I have a PR ready to add this.