# Daily Planning Agent

> A daily-planning agent that turns your tasks and calendar into a realistic time-blocked plan with breaks, flags overcommitment, and never edits your calendar.

- **Category:** Personal Productivity
- **Difficulty:** Intermediate
- **Setup time:** 35 min
- **Stacks:** Claude, LangGraph, OpenAI
- **Version:** 2.0.0 (updated 2026-06-21)
- **Source:** https://agent-kits.com/kit/daily-planner-agent

## Overview

Turns your tasks, priorities, and calendar into a realistic, time-blocked day.

Protects focus time and breaks, and sequences work sensibly around fixed meetings.

Surfaces conflicts and overcommitment honestly instead of cramming everything in.

Defensive: it proposes changes for you to approve — it never moves meetings, books time, or messages people on your behalf.

## When to use it

- You want a realistic daily plan built from your tasks and calendar.
- You want focus blocks and breaks protected, not just a packed schedule.
- You want honest flagging when there's more to do than time allows.
- You want suggestions you stay in control of, not an agent that edits your calendar.

## When not to use it

- You want it to automatically reschedule meetings or book time without your approval — it won't.
- You can't share tasks/calendar context for it to plan from.
- You want it to message or commit to others on your behalf.
- You need a team-scheduling tool rather than a personal daily planner.

## Architecture

- **Inputs intake** — Gathers the day's tasks (with priorities/estimates if available), the calendar's fixed events, and the person's constraints.
- **Duration estimation** — Estimates how long tasks take (using provided estimates or sensible defaults) to plan against real time.
- **Prioritization & sequencing** — Orders work by priority and energy fit, slotting it around fixed meetings.
- **Time-blocking with breaks** — Builds time blocks that include breaks, focus protection, and buffer rather than a packed wall of work.
- **Fit & overcommit check** — Checks the plan actually fits the available hours and flags overcommitment with a realistic subset and deferrals.
- **Propose-only gate** — Outputs suggestions and proposed changes; a deterministic rule prevents any autonomous calendar action or messaging.
- **Plan delivery** — Delivers the time-blocked plan, deferrals, and suggested changes for the person to review and apply themselves.

## Files in this bundle

- `system-prompt.md` — the agent's system prompt
- `tools.json` — tool/function definitions the agent expects
- `workflow.md` — step-by-step run loop
- `.env.example` — environment variables to fill in
- `kit.json` — full structured metadata
- `starters/` — minimal starter snippets
- `LICENSE` — Apache-2.0 (code, configuration, and schema)
- `LICENSE-CONTENT` — CC BY 4.0 (specification text and documentation)
- `NOTICE` — attribution and trademark notice
- `run.py` — **runnable demo**: real agent loop with mock tools (`pip install anthropic`, set `ANTHROPIC_API_KEY`, `python run.py`)
- `agentaz.json` / `agentaz.schema.json` — AgentAz™ governance spec + schema

## Implementation notes

- Keep calendar access read-only and enforce propose-only in a deterministic rule; an assistant that silently moves meetings or messages attendees erodes trust fast.
- Never overcommit: if tasks exceed available time, flag it and propose a realistic subset with deferrals rather than producing an impossible plan.
- Build in breaks and focus protection and respect stated hours and 'do not schedule' windows — a punishing plan is a failed plan.
- Surface conflicts and double-bookings rather than silently resolving them, so the person decides how to handle them.
- Never commit others or assume their availability; at most, offer to draft a message the person can send.
- Use realistic task estimates (provided or sensible defaults) and add buffer between meetings, since back-to-back plans collapse on the first overrun.
- A cheaper model is usually enough to lay out straightforward blocks, so keep the strong model for prioritization trade-offs and overcommit handling.

## Variations

- **Basic — Daily time-blocker:** Builds a proposed time-blocked plan from your tasks and calendar with breaks. Read-only, on demand.
- **Advanced — Realistic planner with guardrails:** Adds duration estimation, overcommit flagging with deferrals, conflict surfacing, and propose-only suggestions for calendar changes.
- **Enterprise — Personal productivity assistant:** Adds task-system and calendar integration (read), energy/preference learning, weekly planning, and draft-message generation for changes you approve.

## FAQ

**Will it change my calendar for me?**

No. It only proposes a plan and suggestions; it never moves, cancels, creates, or accepts meetings, sends invites, or messages anyone. You stay in control and apply changes yourself.

**What if I have more to do than time?**

It tells you honestly. It flags the overcommitment, schedules your highest-priority work, and lists what it deferred and why — rather than producing a packed plan that can't actually be done.

**Does it protect breaks and focus time?**

Yes. It builds in breaks and reasonable focus blocks, respects your working hours and 'do not schedule' windows, and won't plan a back-to-back, no-break marathon.

**Can it free up time by moving a meeting?**

It can suggest moving one and even offer to draft a message you can send to attendees, but it won't reschedule the meeting or notify anyone itself — that decision and action stay with you.

**How does it know how long tasks take?**

It uses the estimates you provide, or sensible defaults, and adds buffer between blocks so a single overrun doesn't collapse the rest of the day.

**Is my calendar data kept private?**

Yes. It reads your calendar and tasks with read-only access to build the plan and keeps that context in scope; it doesn't act on or share it.


---

© 2026 AgentKits · www.agent-kits.com

**Open source.** Code, configuration, and the AgentAz™ schema are licensed under
**Apache-2.0**; specification text and documentation under **CC BY 4.0** (with
attribution to AgentKits, link to https://www.agent-kits.com). See LICENSE, LICENSE-CONTENT,
and NOTICE in this bundle. "AgentAz" and "AgentKits" are trademarks of AgentKits.

**Flagship reference blueprint.** View the source, AgentAz™ spec, and frozen v1.0 schema
in the public registry: https://github.com/agent-kits/agentaz
Original: https://agent-kits.com/kit/daily-planner-agent
