playbook-ai 1.4.1 → 1.4.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable updates to Playbook are documented here. Only impactful changes are listed — new commands, upgraded behavior, and things that make your workflow better. Cosmetic fixes and internal housekeeping are omitted.
 
+## [1.4.3] — 2026-05-25
+
+### Performance
+- **`/start` context reduction** — removed redundant `CLAUDE.md` read (already injected automatically into every session via system context). Added daily throttle on the Playbook update check: after the first check of the day, subsequent `/start` calls skip the git fetch + curl + CHANGELOG read entirely. Timestamp stored in `~/.claude/.playbook-last-update-check`.
+
+## [1.4.2] — 2026-05-17
+
+### Reliability
+- **PreCompact hook** — automatically appends a timestamped marker to `WORK_LOG.md` whenever Claude Code hits the context limit and auto-compaction fires. No more silent mid-session state loss. The marker flags that state above the line may be incomplete and prompts starting a new session. Installed via `hooks/precompact-save.sh`; wired into `settings.json` at install time (additive merge for users who already have a settings.json).
+
 ## [1.4.1] — 2026-05-03
 
 ### Strategy

package/CLAUDE.md

@@ -114,6 +114,11 @@
 - Propose parallel work when independent tasks can run simultaneously
 - Never overlap files/tables/workflows between parallel sessions
 
+## Writing Style
+- **No em dashes.** Use a colon, a comma, or restructure the sentence.
+- Avoid AI writing tells: "delve," "leverage," "utilize," "comprehensive," "robust," "nuanced," "crucial," "pivotal," "it's worth noting," "in conclusion"
+- No filler openers: "Certainly!", "Of course!", "Great question!", "Absolutely!"
+
 ## Plugins
 - **Frontend Design** (`frontend-design@claude-plugins-official`) is installed by default. It generates distinctive, production-grade frontend interfaces with bold typography, unique color palettes, and creative layouts. No action needed — it's active automatically.
 - **Code Review Agents** (`code-review@claude-plugins-official`) is recommended for PR-based workflows. Install with: `/plugin install code-review@claude-plugins-official`. It runs multiple specialized review agents in parallel (comment analysis, test coverage, silent failure detection, type design, code quality, simplification) with confidence-based scoring.

package/VERSION

@@ -1 +1 @@
-1.4.1
+1.4.3

package/commands/end.md

@@ -12,11 +12,13 @@ Session closeout. Do everything needed so the user can walk away without taking
    - Update "Known Issues / Next Steps" — remove anything completed, add anything new discovered, reprioritize if needed. Be explicit about what's next and what's blocked
    - If any task is partially done, document exactly where it was left off and what remains
 
-3. **Trim WORK_LOG.md if needed.** Count the number of dated session entries (lines matching `## YYYY-MM-DD` or `### YYYY-MM-DD`). If there are more than 100 sessions:
+3. **Compress WORK_LOG.md if needed.** Count the number of entries — dated session headers (`## YYYY-MM-DD` or `### YYYY-MM-DD`) plus any existing `## Compressed:` blocks. If the total exceeds 100:
+   - Read the 10 oldest entries (whether raw sessions or prior compressed blocks)
+   - Summarize each to 2-3 bullets: what was done, what changed, what was decided
+   - Replace those 10 entries with a single block at the bottom: `## Compressed: [earliest date] – [latest date]` followed by the bullet summaries
    - Keep the Overall State / header section intact
-   - Keep the 100 most recent session entries
-   - Remove everything older — those sessions have served their purpose and the important bits should already be captured in Overall State and auto-memory
-   - Do NOT archive to a separate file — just delete. Git history has the full log if ever needed.
+   - Result: you drop from 101+ entries to ~92, with history preserved in compressed form
+   - This fires roughly once every 9-10 sessions — not every session after the limit
 
 4. **Update PM tool** (if MCP is connected). Mark completed tasks as done. Update in-progress tasks with status notes. Create new tasks for anything discovered during the session that needs tracking.
 

package/commands/start.md

@@ -1,5 +1,3 @@
-Read CLAUDE.md to understand the project rules and conventions.
-
 Read WORK_LOG.md **efficiently** — do NOT read the entire file if it's long:
 - Read the **first 30 lines** (Overall State, current status headers)
 - Read the **most recent session section** only (the first dated session entry)
@@ -17,7 +15,8 @@ Before anything else, silently check if a newer version of Playbook is available
 ### Pre-flight (silent — no output to user)
 
 1. Check if `~/.claude/.playbook-version` exists. If not, skip the update check entirely.
-2. Read the installed version from `~/.claude/.playbook-version`.
+2. **Daily throttle:** Check if `~/.claude/.playbook-last-update-check` exists and contains today's date (format: `YYYY-MM-DD`). If it does, skip the entire update check and go straight to the normal briefing. If not (file missing or date is old), proceed and write today's date to that file after the check completes — whether or not an update was found.
+3. Read the installed version from `~/.claude/.playbook-version`.
 3. Try to fetch the latest version:
    - **If git is available and `~/.claude/.playbook/` is a git repo:** Run `git -C ~/.claude/.playbook fetch origin main --quiet` then read `VERSION` from the fetched main branch using `git -C ~/.claude/.playbook show origin/main:VERSION`.
    - **If git is not available or fails:** Use `curl -sf https://raw.githubusercontent.com/bluemax713/playbook/main/VERSION` to get the latest version.

package/install.sh

@@ -80,6 +80,49 @@ else
   echo "  Installed settings.json"
 fi
 
+# Install hooks script
+mkdir -p "$CLAUDE_DIR/hooks"
+cp "$PLAYBOOK_DIR/hooks/precompact-save.sh" "$CLAUDE_DIR/hooks/precompact-save.sh"
+chmod +x "$CLAUDE_DIR/hooks/precompact-save.sh"
+echo "  Installed hook: precompact-save"
+
+# Merge PreCompact hook into existing settings.json (additive — won't overwrite existing hooks)
+python3 - << 'EOF'
+import json, os, sys
+
+settings_path = os.path.expanduser("~/.claude/settings.json")
+if not os.path.exists(settings_path):
+    sys.exit(0)
+
+with open(settings_path) as f:
+    settings = json.load(f)
+
+hook_command = "bash ~/.claude/hooks/precompact-save.sh"
+
+# Check if already wired up
+existing = settings.get("hooks", {}).get("PreCompact", [])
+for group in existing:
+    for h in group.get("hooks", []):
+        if h.get("command") == hook_command:
+            print("  PreCompact hook already configured — skipping")
+            sys.exit(0)
+
+# Add it
+if "hooks" not in settings:
+    settings["hooks"] = {}
+if "PreCompact" not in settings["hooks"]:
+    settings["hooks"]["PreCompact"] = []
+settings["hooks"]["PreCompact"].append({
+    "hooks": [{"type": "command", "command": hook_command}]
+})
+
+with open(settings_path, "w") as f:
+    json.dump(settings, f, indent=2)
+    f.write("\n")
+
+print("  Wired PreCompact hook into settings.json")
+EOF
+
 # Copy tech_stack.md template (won't overwrite if exists — user populates this)
 if [ -f "$CLAUDE_DIR/tech_stack.md" ]; then
   echo "  tech_stack.md already exists — skipping"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playbook-ai",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Operating playbook for non-technical founders working with Claude Code",
   "bin": {
     "playbook-ai": "bin/cli.js"

package/settings.json

@@ -2,6 +2,18 @@
   "env": {
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
   },
+  "hooks": {
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ~/.claude/hooks/precompact-save.sh"
+          }
+        ]
+      }
+    ]
+  },
   "enabledPlugins": {
     "frontend-design@claude-plugins-official": true
   },