Skip to content

Add Slack integration recipe#14

Open
jeffsheltren wants to merge 2 commits into
mainfrom
recipe/slack-scanning
Open

Add Slack integration recipe#14
jeffsheltren wants to merge 2 commits into
mainfrom
recipe/slack-scanning

Conversation

@jeffsheltren

@jeffsheltren jeffsheltren commented Apr 2, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a recipe for reliable Slack scanning during the morning routine, addressing two common failure modes: stale data from unfiltered channel reads and missed DMs from unreliable to:me search
  • Solves stale data with timestamp-gated slack_read_channel calls anchored to the Dashboard's last-updated date (with a 4-hour overlap buffer)
  • Solves missed DMs with a two-pronged approach: to:me search as a broad net plus direct DM channel reads for frequent contacts
  • Includes guidance on subagent delegation, dedup against Dashboard, thread context handling, and known connector quirks

Changes

  • New: docs/src/recipes/slack.md — full recipe with embedded vault file
  • Modified: docs/src/SUMMARY.md — added to table of contents
  • Modified: docs/src/recipes/index.md — added to recipes table
  • Modified: template/Knowledge/Jesse-Guidelines/Start-of-Day-Routine.md — added Slack scanning pointer in the "Scan messaging" step

Test plan

  • Verify mdbook build succeeds with the new recipe
  • Review recipe content for accuracy against Slack MCP connector behavior
  • Confirm vault file instructions are clear and self-contained

Adds a recipe for reliable Slack scanning during the morning routine,
addressing two common failure modes with Slack MCP connectors:

1. Stale data in channel scans — solved by timestamp-gating
   slack_read_channel calls to the previous session's Dashboard date
   (with a 4-hour overlap buffer, defaulting to 96h for long weekends).

2. Missed DMs — solved by a two-pronged approach: to:me search as a
   broad net plus direct DM channel reads for frequent contacts.

Also includes guidance on subagent delegation, dedup against Dashboard,
thread context handling, and known connector quirks.

Files changed:
- New: docs/src/recipes/slack.md (recipe with embedded vault file)
- Modified: docs/src/SUMMARY.md (added to table of contents)
- Modified: docs/src/recipes/index.md (added to recipes table)
- Modified: template/Start-of-Day-Routine.md (short Slack pointer in
  Scan messaging step)
slack_read_channel with oldest only returns top-level messages,
missing thread replies on older parent messages even when they
contain new @mentions. Document the gap and the fix (to:me mention
search pass) in the vault file template, How It Works, Known Quirks,
and Tips and Gotchas sections.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant