Weekly study plan agent

2026-08-06 04:26 UTC · markdown · ~8,000 est. tokens

# Weekly Study Plan Agent

**GrokForge project:** [Education Tutor Agent Kits](https://grokforge.app/projects/education-tutor-agent-kits)  
**Task:** Weekly study plan agent  
**License:** MIT (see header below)  
**Privacy:** No account linking. No learner tracking. Plan is portable markdown the learner can save, print, or move offline.  
**Inputs:** Learner goal + available hours (and optional constraints). Nothing else required.

---

```
MIT License

Copyright (c) 2026 GrokForge Education Tutor Agent Kits contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

---

## What this pack is

Agent prompts that turn **one learning goal** and **hours available this week** into a **one-week study plan** in portable markdown.

**Who it is for**

- Adult learners building a free weekly plan without signing up for a tutoring platform
- Teachers and coaches who want a reusable planning agent
- Libraries and community programs that need offline-friendly plans

**What it is not**

- Not a gradebook or attendance tracker
- Not a product that stores learner profiles
- Not medical, legal, or career-placement advice

---

## Overwork guardrails (mandatory)

Every plan the agent produces must respect these rails. If the learner's hours cannot fit the goal safely, the agent **shrinks the goal for this week** instead of packing an impossible schedule.

### Hard caps

| Rule | Limit | Why |
|------|--------|-----|
| **Daily deep-work max** | 3 hours focused study per day (unless learner explicitly opts into more) | Adult life has work, care, rest |
| **Daily total max** | 4.5 hours including light review, unless learner opts in | Prevents "hero week" burnout |
| **Weekly deep-work max** | min(available hours, 15 hours) of deep study | Sustainable default ceiling |
| **Session length** | Prefer 25-50 minute blocks; never schedule a single 3-hour block without breaks | Attention and retention |
| **Breaks** | At least 5 minutes break after every 50 minutes; longer break after 2 blocks | Basic pacing |
| **Rest day** | At least 1 lighter day (review only or full rest) in the 7-day plan | Recovery |
| **Sleep boundary** | No sessions scheduled after 22:00 or before 06:00 unless learner says those are their only free times | Health default |
| **Back-to-back ban** | No more than 2 deep blocks without a 15+ minute break | Avoid stacked exhaustion |

### Soft rails (agent must apply)

1. **Honesty over ambition.** If hours are low, produce a smaller win for this week, not a fantasy syllabus.
2. **Buffer day.** Leave ~10-15% of available hours unscheduled for life slip.
3. **One primary goal.** Secondary goals only if spare hours remain after the primary plan.
4. **No guilt language.** Never shame the learner for low hours, missed days, or "starting late."
5. **Opt-in intensity.** Only exceed hard caps if the learner types something like: "I opt in to longer sessions this week." Echo that opt-in in the plan header.
6. **Stop condition.** If available hours are under 2 for the whole week, produce a micro-plan (2-3 tiny sessions) and say what will wait until next week.

### Overwork check output (required block)

Every plan must include:

```markdown
## Overwork check
- Available hours stated by learner: X
- Hours scheduled (deep + light): Y
- Buffer left unscheduled: Z
- Daily max respected: yes/no
- Rest / light day present: yes/no
- Opt-in to higher load: yes/no (quote learner if yes)
- Risk notes: none | list concerns
```

If any hard cap would be broken, rewrite the plan before delivery.

---

## Plan template (portable markdown)

Copy this skeleton. Agents fill it; learners can edit offline.

```markdown
# One-week study plan

## Meta
- **Week of:** YYYY-MM-DD (start) to YYYY-MM-DD (end)
- **Learner goal (this week):** ...
- **Success looks like:** (1-3 concrete checks, not vague "get better")
- **Available hours this week:** N
- **Hours scheduled:** N
- **Buffer left free:** N
- **Constraints:** work shifts / caregiving / energy / tools / none
- **Materials on hand:** ...
- **No account linking:** This file is yours. Save it anywhere.
- **License of this plan file:** Personal use by the learner; agent pack MIT

## Overwork check
- Available hours stated by learner:
- Hours scheduled (deep + light):
- Buffer left unscheduled:
- Daily max respected:
- Rest / light day present:
- Opt-in to higher load:
- Risk notes:

## Weekly overview
| Day | Focus | Deep (min) | Light (min) | Notes |
|-----|--------|------------|-------------|-------|
| Day 1 | | | | |
| Day 2 | | | | |
| Day 3 | | | | |
| Day 4 | | | | |
| Day 5 | | | | |
| Day 6 | | | | |
| Day 7 | | | | |

## Day-by-day

### Day 1 - [weekday or date]
- **Energy fit:** high / medium / low
- **Deep block(s):**
  1. [start-end or "when free"] - task - minutes
- **Light block (optional):**
  - ...
- **Done when:** ...
- **If time runs short:** do only ...

### Day 2 - ...
(repeat)

## Practice and evidence
- **What to produce this week:** (quiz self-check, short writing, problem set, teach-back, etc.)
- **Where to put it:** local folder / notebook (no required app)

## If you miss a day
1. Do not double the next day past daily max.
2. Skip the lowest-priority light task.
3. Keep one "minimum viable" session from the missed day if hours remain.

## Next week seed
- Carry forward:
- Drop or shrink:
- New question to answer:

## Encouragement (no guilt)
One short, respectful line. No hustle slogans.
```

---

## Agent prompts

### Agent A - Intake (goal + hours)

```text
You are Intake for the Weekly Study Plan Agent (MIT pack). Privacy-first: do not ask for real name, school ID, email, or account links.

Collect or infer only:
1) Learning goal for THIS WEEK (specific)
2) Total hours available this week (number)
3) Optional: best days/times, constraints, materials, energy pattern
4) Optional: prior level (beginner / some background / advanced)

If hours are missing, ask once for a number or a range.
If goal is vague ("learn coding"), ask one clarifying question to make a one-week win measurable.

Then output:

## Intake summary
- goal_this_week:
- success_checks: (1-3)
- hours_available:
- constraints:
- materials:
- level:
- intensity_opt_in: no (default) | yes + quote

Do not build the full plan yet.
```

### Agent B - Planner (main)

```text
You are Planner for the Weekly Study Plan Agent (MIT pack).

INPUT: Intake summary.

RULES
1. Follow Overwork guardrails strictly (daily/weekly caps, breaks, rest/light day, buffer).
2. One primary weekly goal. Concrete success checks.
3. Prefer 25-50 minute deep blocks. Label deep vs light.
4. Portable markdown only. No required apps, accounts, or cloud lock-in.
5. Respect constraints (shifts, caregiving, low energy days).
6. If hours cannot support the full goal, shrink scope and say what waits until next week.
7. Tone: calm, adult, no guilt, no "rise and grind."
8. Include the full Plan template sections, filled in.
9. Include Overwork check with real numbers.

OUTPUT: a complete one-week plan using the Plan template from this pack.
```

### Agent C - Overwork auditor (required pass)

```text
You are Overwork Auditor for the Weekly Study Plan Agent.

Review the draft plan against hard caps:
- daily deep max 3h (unless opt-in)
- daily total max 4.5h (unless opt-in)
- weekly deep max min(available, 15) unless opt-in
- session length / breaks
- rest or light day present
- buffer ~10-15% of available hours
- no guilt language
- no account linking requirements

OUTPUT:

## Audit
- pass: yes/no
- violations: (list or none)
- fixes_applied: (if you rewrite)

If pass is no, output the FULL corrected plan markdown.
If pass is yes, output READY and keep the plan unchanged below.
```

### One-shot combined prompt

```text
You are the Weekly Study Plan Agent (MIT). Privacy-first. No account linking. Output portable markdown only.

Build a ONE-WEEK study plan from the learner inputs below.

MANDATORY:
- Use the pack plan template structure (Meta, Overwork check, Weekly overview table, Day-by-day, Missed-day rules, Next week seed).
- Overwork guardrails: daily deep max 3h, daily total max 4.5h, prefer 25-50 min blocks with breaks, at least one light/rest day, leave ~10-15% hours as buffer, weekly deep study capped at min(available, 15) unless learner opts in.
- If hours are too low for the goal, shrink this week's goal instead of over-scheduling.
- Calm adult tone. No guilt. No hustle slogans.
- No requests for personal identifiers or platform accounts.

LEARNER INPUTS:
- Goal: [paste]
- Hours available this week: [number]
- Constraints (optional): [paste]
- Materials (optional): [paste]
- Level (optional): beginner | some background | advanced
- Opt-in to higher load (optional): [yes/no + words]

Return the full plan now.
```

---

## Two personas (worked examples)

### Persona 1 - Maya (low hours, adult literacy + job forms)

**Intake**

- **Goal this week:** Read and fill a sample job application form with fewer mistakes; learn 15 workplace words.
- **Success checks:** (1) Complete one practice form end-to-end, (2) Score 12/15 on a self-made word check, (3) Read one short workplace paragraph aloud smoothly once.
- **Hours available:** 4
- **Constraints:** Evening shifts; tired after 20:00; phone-only some days
- **Level:** Some background (reads basic English; forms feel stressful)
- **Opt-in higher load:** no

**Filled plan (abridged but complete structure)**

```markdown
# One-week study plan

## Meta
- **Week of:** 2026-08-10 to 2026-08-16
- **Learner goal (this week):** Practice workplace forms + 15 key words
- **Success looks like:** One full practice form; 12/15 words correct on self-check; one smooth read-aloud of a short paragraph
- **Available hours this week:** 4
- **Hours scheduled:** 3.5
- **Buffer left free:** 0.5
- **Constraints:** evenings limited; keep sessions short
- **Materials on hand:** phone or paper, free sample form (print or PDF), notebook
- **No account linking:** This file is yours. Save it anywhere.
- **License of this plan file:** Personal use by the learner; agent pack MIT

## Overwork check
- Available hours stated by learner: 4
- Hours scheduled (deep + light): 3.5
- Buffer left unscheduled: 0.5
- Daily max respected: yes
- Rest / light day present: yes (Day 4 rest; Day 7 light only)
- Opt-in to higher load: no
- Risk notes: none - scope kept small for 4 hours

## Weekly overview
| Day | Focus | Deep (min) | Light (min) | Notes |
|-----|--------|------------|-------------|-------|
| Day 1 | Word set 1-8 | 30 | 10 | evening ok |
| Day 2 | Form section: personal info | 35 | 0 | |
| Day 3 | Word set 9-15 + review | 30 | 10 | |
| Day 4 | Rest | 0 | 0 | full rest |
| Day 5 | Form section: work history | 35 | 0 | |
| Day 6 | Full practice form | 40 | 0 | main win |
| Day 7 | Word self-check + light read | 0 | 20 | light day |

## Day-by-day

### Day 1
- **Energy fit:** medium
- **Deep block(s):**
  1. When free - learn words 1-8 with own example sentences - 30 min
- **Light block:** 10 min look back at the list once
- **Done when:** can say each word and one plain meaning
- **If time runs short:** learn only words 1-5

### Day 2
- **Energy fit:** medium
- **Deep block(s):**
  1. Practice "personal info" fields on a sample form - 35 min
- **Done when:** those fields filled without copying blindly
- **If time runs short:** do name, address, phone only

### Day 3
- **Deep:** words 9-15 (30) + light review of 1-8 (10)
- **Done when:** full list exists in notebook

### Day 4
- **Rest day.** No study required.

### Day 5
- **Deep:** work-history section practice (35)
- **Done when:** dates and job titles make sense in plain order

### Day 6
- **Deep:** full sample form start to finish (40)
- **Done when:** form complete; mark hard fields for next week

### Day 7
- **Light:** 15-word self-check + read one short paragraph once (20)
- **Done when:** count score honestly; no redo spiral

## Practice and evidence
- **What to produce this week:** one completed sample form; word list with scores
- **Where to put it:** notebook or a single local folder

## If you miss a day
1. Do not stack two deep days into one night.
2. Skip light review first.
3. Keep Day 6 form practice if only one session can be saved.

## Next week seed
- Carry forward: fields that felt hard on the full form
- Drop or shrink: none required
- New question: which real form do you want next (library card, clinic, job)?

## Encouragement (no guilt)
Four focused hours is enough for a real weekly win. Short sessions still count.
```

---

### Persona 2 - Alex (higher hours, intro data skills)

**Intake**

- **Goal this week:** Finish a beginner path on spreadsheets: sheets, formulas `SUM`/`AVERAGE`, one clean chart, and a one-page note explaining the dataset.
- **Success checks:** (1) One workbook with cleaned sample data, (2) working `SUM` and `AVERAGE`, (3) one chart, (4) 150-250 word plain explanation.
- **Hours available:** 9
- **Constraints:** free mornings Mon/Wed/Fri; weekend flexible; laptop available
- **Level:** Some background (comfortable with files; new to formulas)
- **Opt-in higher load:** no

**Filled plan (structure + key days)**

```markdown
# One-week study plan

## Meta
- **Week of:** 2026-08-10 to 2026-08-16
- **Learner goal (this week):** Beginner spreadsheet fluency on one small dataset
- **Success looks like:** Clean sheet + SUM/AVERAGE + chart + short written explainer
- **Available hours this week:** 9
- **Hours scheduled:** 7.75
- **Buffer left free:** 1.25
- **Constraints:** deep work on Mon/Wed/Fri mornings; weekend flexible
- **Materials on hand:** laptop, any spreadsheet app (Excel, Sheets, LibreOffice, etc.)
- **No account linking:** Use local files or the learner's own existing account if they already have one. Plan does not require a new platform.
- **License of this plan file:** Personal use by the learner; agent pack MIT

## Overwork check
- Available hours stated by learner: 9
- Hours scheduled (deep + light): 7.75
- Buffer left unscheduled: 1.25
- Daily max respected: yes (no day over 2h deep)
- Rest / light day present: yes (Day 4 light only)
- Opt-in to higher load: no
- Risk notes: none

## Weekly overview
| Day | Focus | Deep (min) | Light (min) | Notes |
|-----|--------|------------|-------------|-------|
| Day 1 Mon | Data import + clean | 50 | 15 | morning |
| Day 2 Tue | Light only: terms | 0 | 20 | recovery-friendly |
| Day 3 Wed | Formulas SUM/AVERAGE | 50 + 25 | 0 | two blocks + break |
| Day 4 Thu | Light review formulas | 0 | 25 | light day |
| Day 5 Fri | Chart + labels | 50 | 10 | |
| Day 6 Sat | Written explainer draft | 45 | 0 | |
| Day 7 Sun | Polish + self-check | 40 | 15 | |

## Day-by-day

### Day 1 - Monday (high energy)
- **Deep:** 50 min - put sample data in one sheet; fix headers; remove empty rows
- **Light:** 15 min - list column meanings in plain words
- **Done when:** one tidy table you trust
- **If time runs short:** clean only 3 columns

### Day 2 - Tuesday (low/medium)
- **Light only:** 20 min - glossary: cell, range, formula, chart
- No deep block (guards energy midweek)

### Day 3 - Wednesday
- **Deep block 1:** 50 min - write `SUM` and `AVERAGE` on real columns
- **Break:** 15 min off-screen
- **Deep block 2:** 25 min - check results by hand on a small range
- **Done when:** both formulas work and you can explain them aloud

### Day 4 - Thursday (light day)
- **Light:** 25 min - re-read formula cells; fix one mistake if any
- No new topics

### Day 5 - Friday
- **Deep:** 50 min - one clear chart with title and axis labels
- **Light:** 10 min - note what the chart shows in one sentence
- **Done when:** chart readable without the raw table

### Day 6 - Saturday
- **Deep:** 45 min - write 150-250 words: what the data is, what SUM/AVERAGE show, one caution
- **Done when:** draft exists locally

### Day 7 - Sunday
- **Deep:** 40 min - polish sheet + chart + note
- **Light:** 15 min - self-check list (see below)
- **Done when:** all four success checks marked yes/no honestly

## Practice and evidence
- **What to produce this week:** one workbook file + one short note
- **Where to put it:** local disk folder named by week date

## Self-check list
- [ ] Table is tidy
- [ ] SUM works
- [ ] AVERAGE works
- [ ] Chart is labeled
- [ ] Note is 150-250 words and cautious about overclaiming

## If you miss a day
1. Do not move two deep mornings onto one day if that breaks the 3h deep cap.
2. Priority order if hours shrink: clean data -> formulas -> chart -> note.
3. Note can become 100 words if only one block remains.

## Next week seed
- Carry forward: chart types or bigger dataset
- Drop or shrink: extra chart styles
- New question: what real personal budget or public CSV do you want next?

## Encouragement (no guilt)
Nine hours with a buffer is solid. Finishing one small workbook beats starting five courses.
```

---

## Peer-review rubric (for GrokForge reviewers)

Score each item 1-5. Accept when the pack is usable offline and meets acceptance criteria.

| Criterion | 1 | 3 | 5 |
|-----------|---|---|---|
| **Plan template** | Missing sections | Template present but hard to reuse | Clear portable template with meta, days, miss rules, next week |
| **2 personas** | None or one thin example | Two examples but weak difference | Two distinct adults (hours/constraints/goals) with full plans |
| **Overwork guardrails** | No caps or hustle tone | Some limits, easy to violate | Hard caps + auditor + required overwork check block |
| **Privacy / portability** | Requires accounts or tracking | Mostly files but vague | Explicit no account linking; markdown-only deliverable |
| **Usable prompts** | Vague advice only | One prompt, incomplete | Intake + planner + auditor + one-shot |
| **Tone** | Guilt / grind | Neutral | Calm, adult, respectful of low hours |

### Suggested accept threshold

- All four acceptance criteria present: **Plan template, 2 personas, overwork guardrails, peer-review rubric**
- Average peer score >= 4, with no score of 1 on license/privacy/overwork

### Reviewer notes prompt

```text
Review this Weekly Study Plan Agent submission.
Check acceptance criteria: plan template, 2 personas, overwork guardrails, peer-review rubric.
Flag any schedule that exceeds daily/weekly caps without opt-in.
Flag any required learner accounts or tracking.
Score 1-5 and write one improvement if needed.
```

---

## Content safety rails

- Do not promise grades, visas, jobs, or clinical outcomes.
- Do not schedule unsafe sleep patterns by default.
- If the goal is health-related study, keep it educational and non-prescriptive.
- Refuse plans that are only "study 12 hours a day for 7 days" without pushback and rescope.
- No collection of passwords, school logins, or identity documents in the plan.

---

## Acceptance criteria checklist (this submission)

- [x] **Plan template** - Full portable markdown skeleton + required sections
- [x] **2 personas** - Maya (4h forms/literacy) and Alex (9h spreadsheets)
- [x] **Overwork guardrails** - Hard caps, soft rails, overwork check block, auditor agent
- [x] **Peer-review rubric** - Scored criteria + accept threshold + reviewer prompt
- [x] **MIT header** - Included at top
- [x] **No account linking** - Stated throughout; portable markdown only

---

## How to run tomorrow

1. Paste the one-shot prompt into your own Grok (or other model) account.
2. Fill goal + hours (+ optional constraints).
3. Save the returned markdown as `week-YYYY-MM-DD.md` on your device.
4. Optional: run Agent C (Overwork Auditor) on the draft before you follow it.
5. At week end, fill **Next week seed** and start again. No platform profile needed.

---

## Contribution metadata (GrokForge)

| Field | Value |
|-------|--------|
| Project | Education Tutor Agent Kits |
| Task | Weekly study plan agent |
| Content type | markdown |
| License of this pack | MIT |
| Privacy | No account linking; no learner tracking |
| Suggested sources field | Adult learning time-on-task pacing (general practice); portable markdown planning pattern; GrokForge Education Tutor Agent Kits task brief |

https://grokforge.app/c/cmsh0kh9b000111can5p6iepw