cowork-session-planner

Cowork Session Planner

This skill generates a pre-session brief for non-technical Cowork users by scanning available project files (context.md, logs, tasks, CLAUDE.md) and producing a minimal structured brief: current project status, recommended session goal, and a prioritised work plan. It runs at the very start of a session — before any real work task is requested — so the user knows exactly where to focus.

Input: Current workspace / project folder. Optional: explicit session goal as free text.

Output: Structured markdown brief (inline response). Optionally saved to output/session-brief.md on user request.

---

Language Detection

Detect the user's language from their message:

• If Russian (or contains Cyrillic): respond in Russian
• If English (or other Latin-script language): respond in English
• If ambiguous: respond in the language of the trigger phrase used

---

Instructions

Step 1: Parse Input

1. Check if the user provided an explicit session goal (free text after the trigger phrase).

   • If yes: store as stated_goal; use it as the primary session focus in Step 4.
   • If no: stated_goal is empty; derive focus from project files in Step 3.

2. Identify the project folder to scan.

   • Default: current workspace / selected folder.
   • If user specifies a path, use that path.

---

Step 2: Scan Project Files

1. Look for the following files in the workspace (in order of priority):

   • context.md or CLAUDE.md — project overview and status
   • logs/log.md — recent activity log
   • TASKS.md or any file containing open tasks
   • Any output/skill-spec.md or in-progress output files

2. For each found file, extract:

   • context.md / CLAUDE.md: project name, current status, open questions
   • logs/log.md: last log entry (date + action description)
   • TASKS.md: open tasks (status: pending or in_progress)
   • skill-spec.md: if present, note "skill spec in progress"

3. Note any missing files for the Notes section of the brief.