Product Requirements Document · AI Agent

Find Your Flow

A scheduled AI agent that publishes a personalized, single-career letter every day, backed by a living board of jobs to apply to right now.

Status: Live v1.0 Personal build · scheduled daily agent · static site on GitHub Pages · Michelle B. · June 2026

1. Executive summary

The problem

A bright, college-aged young adult with ADHD freezes at “what do you want to do with your life?” Standard career advice makes it worse: it arrives as one giant list, assumes a four-year degree, and is built for confident, linear job-seekers. The result is overwhelm and avoidance at exactly the moment a first real step would help.

The solution

Find Your Flow is a scheduled agent that publishes one short, designed career letter a day to a private phone page. Each letter covers a single realistic, low-school career, shows the real outlook and pay, lays out the actual Colorado training path, and points to one real, currently-open job so she can see it is not made up. A separate, always-current jobs board holds roles she can apply to today. One option at a time, her choice, never a list to drown in.

2. Goal and audience

Goal

Take the overwhelm out of choosing a career by serving up one realistic, low-school path at a time, in small doses, each with a verified outlook, a real pay number, a concrete first step to get qualified, and a real job that proves the field is hiring. Move her from “I can’t think about this” to “I could tour that school” or “I could apply to that.”

Audience

One person, Jillian, and every decision is filtered against who she actually is:

Outgoing, loves travel and fitness, a people person; happiest moving, not at a desk.
ADHD and school-averse, but open to a short program or a single certificate.
Strong at AI prompting; not confident in math.
Does not want to work with kids. Does not want a desk-bound, stuck-at-home job (remote-flexible she can do from a cafe is fine).
Colorado, near Golden; cost-smart, with family able to help pay for the right short program.

If a career does not fit that profile, it does not get written. The voice is always low-pressure and neutral, presenting options as hers to choose, never a parent deciding her life.

3. System architecture

Find Your Flow is a small static site with a deliberate three-surface split: a router, the dated letters we archive, and a single living jobs board we never archive.

Surface	File(s)	Role	Lifecycle
Router / scheduler	`index.html`	What loads at `/flow/`. ~15 lines of vanilla JS: reads today’s date and redirects to the letter scheduled for that day. Holds the publish schedule (date → file).	Edited only to add a new edition’s date.
Daily letter	`vol-01 … vol-NN.html`	The career letter for one day, one career. Swipeable five-card deck plus a qualify box and a real-job box. This is the thing we save.	One new dated file per day, permanent, listed in the archive.
Jobs board	`jobs.html`	A single living page of apply-today, part-time jobs Jillian can land right now with her current skills. The cumulative running list.	Updated in place, never versioned, never archived.
Archive	`archive.html`	Index of every past letter, newest first, one line each.	One new row per edition.
This PRD	`about.html`	How the agent works (this page).	Static.
Working notes	`PIPELINE.md`	Internal: the running list of careers covered, the queue, the rules. Not published.	Updated each run.

Why two different lifecycles

The newsletter is the artifact we archive, one dated letter per day, saved forever so the journey is visible. The jobs board is a tool, not an artifact: it should always reflect what is open right now, so it lives as one page that gets refreshed in place. Mixing the two (versioning the jobs page, or letting the letter go stale) was the thing to avoid.

4. How the agent runs (daily process)

The agent is defined by a SKILL.md spec and runs on a schedule. A full daily run is:

Trigger. Scheduled for roughly 6:00 AM daily. The computer is often off overnight, so if the scheduled run is missed, the agent runs the moment Michelle signs on, no day is skipped.
Pick a fresh career. Read the running list of careers already covered (in PIPELINE.md and the archive) and choose a new one, never a repeat. Ideas are drawn from the U.S. Bureau of Labor Statistics fastest-growing list and a curated queue, then screened against Jillian’s fit profile.
Research and verify. Pull the BLS growth rate and median pay. Find the real, accredited Colorado training path, preferring the least-school, most local, most affordable (public) option. Find one real, currently-open job in that field on an employer’s own careers page, and confirm it is live that day.
Compose the letter. Build the new vol-NN.html from the locked template (section 5), in Jillian’s voice.
Refresh the running job list. Add any new, still-open apply-today roles to jobs.html; re-verify existing ones and drop anything that has closed. The board carries forward day to day.
Publish and schedule. Save the letter, add a row to archive.html, and append the edition’s date to the index.html schedule so it rotates in automatically on its day.
Log. Update PIPELINE.md: what was covered, what is queued, any new rules.

When it posts

One letter per calendar day. The router shows the letter whose scheduled date is today; before a given letter’s date it is not shown, and after the last scheduled date the router holds on the newest. Jillian just opens /flow/ each morning and gets the right day’s letter, in order, automatically.

5. Content and design spec (how a letter must look)

Every letter follows one locked structure so they read as a series, not one-offs:

Block	Spec
Hero	Gold “refresh daily” bar, plum hero with the Find Your Flow logo and the edition’s volume number and date.
Intro	One warm paragraph in Jillian’s voice that names the single career and why it suits her.
Deck	Exactly five swipeable cards. Card 1 is the headline career; cards 2–5 are real settings or specialties within that same career. Each card: one photo, a label, a headline, a short paragraph, and three stat chips (pay, outlook, entry).
How to get qualified	The real path with verified, accredited, Colorado-local links, framed as a small first step, prefer the least-school and most affordable route.
A real job in this field	One real, currently-open job on the employer’s own page, showing the true pay, so an aspirational career is always paired with proof it hires. Never a low-skill front-desk placeholder as the headline.
Bottom actions	Two buttons: See all the careers we have explored (archive) and Jobs you can apply to today (the living jobs board), plus a small link to this PRD.

Design system

Format: mobile-first, single 430px column, built to be read on a phone.
Palette: plum, sage, rose, and gold on cream, solid colors only, no gradients.
Type: Lora (serif headlines) and DM Sans (body).
Typography rules: curly quotes and apostrophes, no straight quotes, no em dashes.
One career per letter. A letter never mixes two careers; the deck stays inside one field.

6. Data sources and verification

U.S. Bureau of Labor Statistics (Occupational Outlook Handbook) for projected growth and median pay.
Accredited program and licensing sources for the qualify path (community-college program pages, state licensing boards, accreditor directories), chosen for the least-school, local, affordable route.
Employers’ own careers pages for the real-job box and the jobs board. Every job link is verified live the day it is posted; anything that cannot be confirmed as a live posting is left off. Never a logged-out job-board search.

7. Guardrails and rules

Non-negotiables

No PII. The site is static, with no forms, logins, or tracking. Nothing about Jillian is collected or stored. It is unlinked and noindexed, a private page just for her.
Honest by default. Real BLS numbers, no inflated pay or outlook, no degree-inflation, status labeled plainly. Where a career needs school, say so; where a move is required, say so.
Real jobs only. Verified-live postings on the employer’s own page; if it cannot be confirmed, it is not shown.
One career per letter, aspirational career paired with a real job, never a low-skill placeholder as the headline.
Her choice. Neutral, low-pressure framing throughout, options to explore, not instructions.
Fit filter. Screened against Jillian’s documented preferences (no kids, not math-heavy, near Colorado or a short move, short school).

8. Scheduling, operations, and tech

Cadence: daily, ~6 AM scheduled run, with an automatic catch-up run on sign-on if the machine was off.
Rotation: the index.html date-router shows the correct letter each day with no manual step.
Maintenance: new editions get appended to the router schedule and the archive; the jobs board is refreshed in place.
Stack: static HTML, CSS, and ~15 lines of vanilla JS, no backend, no framework, hosted free on GitHub Pages. Authored and operated by a scheduled Claude agent from a SKILL.md definition.

9. What success looks like

Success is not engagement metrics. It is Jillian opening the page on a normal morning, getting one realistic option that actually fits, and taking one small real step, touring a school, stacking a free certificate, or applying to one job from the board, on something she chose herself. The agent’s job is to keep the door open, one low-pressure day at a time.