-
Notifications
You must be signed in to change notification settings - Fork 488
Closed
Description
Pack files are large markdown documents (~50KB) where the actual contents (files created, hooks registered) are buried in documentation. Users can't quickly see what they're about to install.
Current Behavior
- Pack is a large markdown file
- Contents scattered throughout documentation
- User doesn't know what files/hooks will be created until after installation
- Surprise components (e.g., kai-hook-system includes observability library)
Problem
- User can't quickly answer "what am I about to install?"
- Pack descriptions are verbose, contents not summarized upfront
- Dependencies between components within a pack not clear
- User may not want all components (e.g., just hooks, not observability)
Suggested Fix
Add a "What's Included" summary near the top of each pack:
## What's Included
| Component | File | Purpose |
|-----------|------|---------|
| Session initializer | `hooks/initialize-session.ts` | Sets up session context |
| Core context loader | `hooks/load-core-context.ts` | Loads CORE skill |
| Security validator | `hooks/security-validator.ts` | Prompt injection defense |
| Observability lib | `hooks/lib/observability.ts` | Event logging |
**Files created:** 4
**Hooks registered:** 3
**Dependencies:** NoneThis gives users a quick overview before they commit to installation.
Environment
- macOS
- PAI v2 (current main branch)
Metadata
Metadata
Assignees
Labels
No labels