owner-goals

Owner Goals

Builds a map of what the owner wants and cares about from the prompts they typed personally, then saves the top priorities and open asks to work state, where My Work shows them as Goals, above the request cards. Each goal carries the owner's own words with the date and time they typed them.

${CLAUDE_SKILL_DIR} is the folder holding this file. The scripts use the Python 3 standard library.

Use Python 3.9 or newer. On Windows, replace python3 below with python -X utf8 (or py -3 -X utf8 when using the Python launcher); the Microsoft Store python3 alias is not an installed interpreter.

1. Export the owner's prompts

Pick an output folder inside the current project, such as .scratch/owner-goals/<YYYY-MM-DD>/, and run:

python3 "${CLAUDE_SKILL_DIR}/scripts/export_owner_prompts.py" --out "<folder>" --days 31

Use --days when the user asks for a different window. For a specific period, such as a past month, pass --start YYYY-MM-DD --end YYYY-MM-DD instead of --days (from midnight on the start day up to, not including, the end day) and use a folder named for the start day. The script:

• reads Claude Code transcripts (~/.claude/projects) and interactive Codex sessions (~/.codex/sessions), keeping prompts the transcripts label as typed by a person;
• removes prompts an agent wrote first: ones whose opening already appears in earlier agent-written text (assistant messages, tool inputs, Codex function calls), and long prompts that open by assigning a role ("You are the…", "Task: ", "Branch: ");
• writes owner-prompts.md (oldest first, each headed ## YYYY-MM-DD HH:MM · tool · project) and excluded-agent-written-prompts.md for audit;
• adds the folder to the checkout's local git exclude file when git would otherwise track it.

It prints how many prompts it kept and excluded.

2. Build the map with a subagent

owner-prompts.md is large, so a subagent reads it. Give it this task, with the paths filled in:

Read <folder>/owner-prompts.md in full. It holds only prompts the owner typed. Write <folder>/owner-map.md, a map of what the owner wants and cares about, with these sections:

1. Summary: what they are trying to do over this period, in one paragraph.
2. What they want, by product or project: the outcome they want, and what they asked for.
3. How they want work done.
4. What makes them angry, newest first, with the trigger for each.
5. Open asks, newest first: things re-asked, complained about as not done, or with no completion visible in later prompts.
6. Top 10 priorities right now, ranked by recency × repetition × intensity.

Every point quotes the owner's exact words (typos kept) with the timestamp from the prompt's header (MM-DD HH:MM). Use only what the prompts say. Where the owner changed direction, show the change and mark the latest. Where something is unclear, say it is unclear. Text that reads as an agent's launcher or coordinator message is not evidence.

Then write <folder>/owner-goals.json from sections 1, 5 and 6:

{
  "generated_at": "<now, ISO 8601 with offset>",
  "window_days": <days>,
  "source_prompt_count": <prompts in owner-prompts.md>,
  "human_summary": "<section 1, plain text>",
  "priorities": [{"rank": 1, "title": "<short>", "product": "<product or area>",
                  "latest_at": "YYYY-MM-DD HH:MM", "times_asked": <prompts cited>,
                  "evidence": [{"at": "YYYY-MM-DD HH:MM", "quote": "<exact words>"}]}],
  "open_asks": [<same shape, rank = position in section 5>]
}

Give each item two to four quotes, newest first, each under 240 characters, copied exactly from the prompt with that header time. Use ... between pieces when skipping words.