plan

Prompt file imported from sohan-shingade/lifeOS (.claude/commands/plan.md). Fill in {{arguments}} before use. Copyright stays with the author.

/plan

Produce a calendar proposal for the given window, respecting all domain plans and constraints.

Input

{{arguments}} — the planning window. Parse flexibly:

• today → today only
• tomorrow → tomorrow only
• this week / next week → Mon–Sun of the relevant week
• week of 2026-05-01 → that Mon–Sun
• <start>..<end> → explicit range
• default (no args) → the next 7 days from now

Flow

1. Refresh calendar cache.

   python -m src.sync
   

2. Invoke the scheduler subagent. Pass the window explicitly.

3. Scheduler collects inputs (reads):

   • profile/constraints.yaml — protected windows, caps, preferences
   • profile/categories.yaml — category rules
   • profile/domains.yaml — active domains
   • domains/*/plan.yaml for each active domain
   • domains/*/goals.yaml (soft — fills under-target categories)
   • domains/academics/*/assignments.yaml (deadlines)
   • state/tasks.yaml — open backlog
   • state/events.sqlite — current calendar state in the window

4. Scheduler runs src/schedule.py with these inputs. This is deterministic Python: greedy fit over free slots, respecting all constraints, surfacing anything that didn't fit.

5. Proposal written to state/proposals/<timestamp>.yaml.

6. Show human-readable diff in chat. Group by day, annotate each op:

   Mon 2026-04-28
   ✚  06:30-08:00  fitness    Gym — Upper Push + Climb
   ✚  09:00-11:00  school     DSC 140A study block (HW3)
   ✚  14:00-15:30  deep-work  Flint backtester refactor
      18:00-21:00  climb      (existing — Mesa Rim)
   
   Tue 2026-04-29
   ...
   
   Did NOT fit (surfaced for user):
   ✗  errands       "Car service at 67k mi" (1hr block) — no slot found.
                    Soonest options: Sat 11am, Sun 2pm.
   

7. Wait for user response. Options:

   • y / approve → apply
   • n / cancel → discard proposal
   • freeform edit request → re-propose with adjustment
   • show <day> → drill into a specific day

8. On approval, run python -m src.apply state/proposals/<timestamp>.yaml. Append each op to state/audit.log.

Notes

• Never auto-delete events you didn't create. If the scheduler needs to clear time, it surfaces conflicts as items needing user decision.
• Never modify external-attendee events without explicit confirmation on that specific event.
• Existing fitness / deep-work blocks created by previous /plan can be moved, but log the move reason.
• If the window already has heavy commitments and nothing new fits, say so — don't pad with lower-value work.