scout-work

Scout Work Session

Run an interactive Scout work session to knock items off today's action items list.

Unlike /scout-briefing, /scout-consolidation, /scout-dream, and /scout-research (which run as background processes), this runs in the current conversation. You present actionable items one at a time with a recommended action ready to go, and wait for approval before executing.

The goal: the user decides, Scout drafts and executes. Never send a message, merge a PR, create a meeting, or take any externally-visible action without explicit approval.

---

Phase 1: Load & Filter

1. Get today's date in the user's timezone. Read scout-config.yaml for the timezone field (default America/New_York if missing):

   TZ=<timezone> date '+%Y-%m-%d'
   

2. Read today's action items file: <SCOUT_DIR>/action-items/action-items-YYYY-MM-DD.md

   • If it doesn't exist, tell the user: "No action items file for today. Run /scout-briefing or /scout-consolidation first to generate one."
   • Stop here if no file.

3. Parse the file and collect all unchecked items (- [ ]) from these sections:

   • 🔴 Urgent / Time-Sensitive
   • 🟡 To Do
   • Personal

4. Skip items from the 🟢 Watching section — those are monitoring, not actionable.

5. Skip items explicitly described as blocked by another item (e.g., "Blocked by PROJ-2630", "Waiting on Legal review").

6. Present a numbered summary:

   Found N actionable items:
   - X urgent
   - Y to do
   - Z personal
   
   Ready to start?
   

Wait for the user to confirm before proceeding.

---

Phase 2: Work Loop

Process items in priority order: Urgent first, then To Do, then Personal.

For each item, do the following:

Step 1: Triage — classify the action type

Use the user's connected tools to determine what kind of action this is. The matrix below is a starting point — use judgment when an item spans multiple categories.

Type	Tools to use	Signals in the item
GitHub	gh CLI (pr view, pr merge, pr review)	PR #, merge, reviewer, CI, GitHub URL
Slack	Slack MCP (slack_send_message, slack_read_channel, etc.)	Slack DM, reply, post, thread, channel name
Calendar	Google Calendar MCP (create_event, list_events)	Schedule, meeting, invite, calendar
Linear	Linear MCP (save_issue, get_issue)	Linear issue ID, status update, create issue
Email	Gmail MCP (create_draft, send_message)	Email, reply, draft, follow-up with an email address
Research	WebSearch, WebFetch	Research, look up, find out, investigate, compare
Compound	Multiple of the above	Item needs several steps in sequence