Commit c69530e5c828

@@ -89,6 +89,77 @@ After saving, inform the user:
 
 ---
 
+## Examples
+
+### Example 1: Infrastructure Session
+```markdown
+# Session: Configure Syncthing Folder Sync
+
+**Date:** 2026-01-15
+**Tool:** claude
+
+## Summary
+Added claude-history folder to Syncthing configuration for cross-machine backup of AI session data.
+
+## What Was Accomplished
+- Added syncthing folder to `globals.nix` with generated ID
+- Configured sync for kyushu and aomi machines
+- Verified existing sync patterns for consistency
+
+## Files Changed
+- `globals.nix` — added claude-history syncthingFolder entry
+- `systems/kyushu/extra.nix` — enabled sync on kyushu
+- `systems/aomi/extra.nix` — enabled sync on aomi
+
+## Outcome
+Syncthing will sync `~/.local/share/ai/` across both machines after next NixOS rebuild.
+
+## Next Steps
+- [ ] Rebuild NixOS on kyushu and aomi to activate
+- [ ] Verify syncthing picks up the new folder
+
+### Tags
+#claude #nixos #syncthing #homelab
+```
+
+### Example 2: Development Session
+```markdown
+# Session: Tekton PR Review and Fix
+
+**Date:** 2026-02-08
+**Tool:** claude
+
+## Summary
+Reviewed PR #9143 for multi-credential git support, identified issues with test coverage, and submitted review with requested changes.
+
+## What Was Accomplished
+- Analyzed git credential resolution logic changes
+- Found missing test case for overlapping host credentials
+- Submitted review with 3 inline comments and change request
+- Created follow-up issue for documentation update
+
+## Outcome
+PR review submitted. Author needs to add edge case tests before merge.
+
+## Next Steps
+- [ ] Re-review after author addresses feedback
+- [ ] Update Tekton docs with multi-credential examples
+
+### Tags
+#claude #tekton #code-review #git
+```
+
+---
+
+## Best Practices
+
+1. **Be specific** — say what was modified, not just "worked on code"
+2. **Capture decisions** — document WHY choices were made
+3. **Include context** — future you needs to know what prompted this work
+4. **Keep it real** — if nothing significant happened, skip saving
+
+---
+
 ## When to Use
 
 - After completing significant work