Develop

.ai/docs/notifications.md

@@ -44,7 +44,21 @@ The notification system keeps you in flow by alerting you when:
 
 ## 🚀 Quick Start
 
-Notifications work out of the box! The system automatically:
+### For CLI Tools
+
+Notifications are **OFF by default** for CLI tools. Enable them with:
+
+```bash
+# Enable notifications for a command
+NOTIFY=true amplifier-synthesis process article.md
+
+# Or use make with notification support
+make synthesis  # Uses NOTIFY=true internally
+```
+
+### Automatic Detection
+
+The system automatically:
 
 1. Detects your platform
 2. Uses the best notification method
@@ -272,8 +286,8 @@ fi
 Group related notifications:
 
 ```bash
-# macOS - Group by project
-osascript -e "display notification \"$MESSAGE\" with title \"$PROJECT\" group \"$PROJECT\""
+# macOS - Show with project subtitle
+osascript -e "display notification \"$MESSAGE\" with title \"Amplifier\" subtitle \"$PROJECT\""
 ```
 
 ## 🎯 Best Practices

.claude/README.md

@@ -31,6 +31,7 @@ The `commands/` directory contains markdown files that define custom workflows:
 - Each `.md` file becomes a slash command in Claude Code
 - Commands can orchestrate complex multi-step processes
 - They encode best practices and methodologies
+- Key commands include `/transcripts` for restoring conversation history after compaction
 
 ### Automation Tools
 
@@ -39,6 +40,8 @@ The `tools/` directory contains scripts that integrate with Claude Code:
 - `notify.sh` - Cross-platform desktop notifications
 - `make-check.sh` - Intelligent quality check runner
 - `subagent-logger.py` - Logs interactions with sub-agents
+- `hook_precompact.py` - Exports conversation transcripts before compaction
+- `transcript_manager.py` - CLI tool for managing conversation transcripts
 - Triggered by hooks defined in `settings.json`
 
 ### Configuration
@@ -59,6 +62,8 @@ The `tools/` directory contains scripts that integrate with Claude Code:
 4. Notification hook triggers `notify.sh`
 5. You get desktop notification of results
 6. If sub-agents were used, `subagent-logger.py` logs their interactions to `.data/subagents-logs`
+7. Before conversation compaction, PreCompact hook triggers `hook_precompact.py`
+8. Full transcript is exported to `.data/transcripts/` preserving your entire conversation
 
 ### Command Execution