Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 94 additions & 0 deletions 404.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="robots" content="noindex">
<meta name="description" content="That page isn't here. Learn with O.J., a working engineer in your corner.">
<title>Not found - Learn with O.J.</title>

<!-- Open Graph, for a missing link shared somewhere that unfurls it -->
<meta property="og:type" content="website">
<meta property="og:title" content="Not found - Learn with O.J.">
<meta property="og:description" content="That page isn't here. Learn with O.J., a working engineer in your corner.">
<meta property="og:image" content="https://learnwithoj.com/assets/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Not found - Learn with O.J.">
<meta name="twitter:description" content="That page isn't here. Learn with O.J., a working engineer in your corner.">
<meta name="twitter:image" content="https://learnwithoj.com/assets/og-image.png">

<!-- Favicon -->
<link rel="icon" type="image/x-icon" href="/favicon.ico">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="manifest" href="/site.webmanifest">

<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="preload" as="style" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap">
<link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap"></noscript>
<!-- Absolute paths throughout, because this page is served at whatever address was missing. -->
<link rel="stylesheet" href="/styles.css?v=29">

<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
async src="https://gc.zgo.at/count.js"></script>
</head>
<body>
<header class="header">
<div class="container">
<a href="/" class="logo">Learn with O.J.</a>
<nav class="nav-links" aria-label="Main">
<a href="/#companies" class="nav-link">For companies</a>
<a href="/#engineers" class="nav-link">For engineers</a>
<a href="/resources" class="nav-link">Resources</a>
<a href="https://book.learnwithoj.com" class="btn-header">Quick chat (15 min)</a>
</nav>
</div>
</header>

<main>
<section class="section notfound">
<div class="container">
<p class="notfound-code" aria-hidden="true">404</p>
<h1>That page isn't here</h1>
<p class="notfound-lead">Nothing lives at this address. It may have moved when the site did, or the link was typed from memory, which is how most of us type links.</p>
<ul class="notfound-links">
<li><a href="/">Start at the home page</a></li>
<li><a href="/showcase">What I do for companies</a></li>
<li><a href="/resources">Free resources</a></li>
<li><a href="/agents/">Working with agents</a></li>
</ul>
<p class="notfound-note">If a link on this site brought you here, <a href="mailto:oj@learnwithoj.com">tell me which one</a> and I'll fix it. For once, it wasn't DNS.</p>
</div>
</section>
</main>

<footer class="footer">
<div class="container">
<div class="footer-content">
<p class="footer-brand">Learn with O.J. LLC <span class="footer-sep" aria-hidden="true">·</span> West Palm Beach, Florida</p>
<ul class="footer-links">
<li><a href="mailto:oj@learnwithoj.com">oj@learnwithoj.com</a></li>
<li><a href="https://www.linkedin.com/in/learnwithoj/" target="_blank" rel="noopener noreferrer">LinkedIn</a></li>
<li><a href="/agents/policy/">AI policy</a></li>
<li><a href="/agents/">For agents</a></li>
</ul>
<div class="footer-onepercent">
<a class="footer-onepercent-mark" href="https://www.onepercentfortheplanet.org/" target="_blank" rel="noopener noreferrer">
<img src="/assets/logos/1ftp-primary-horizontal-fullcolor.png" alt="1% for the Planet" width="188" height="80" loading="lazy" decoding="async">
</a>
<p class="footer-onepercent-text">Learn with O.J. LLC is a member of 1% for the Planet. We have committed to give back 1% of our annual sales to vetted and approved impact partners. Our first certification will take place after our current fiscal year ends.</p>
</div>
<p class="footer-dns">And remember, it's always DNS.</p>
</div>
</div>
</footer>
</body>
</html>
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ The format is inspired by [Keep a Changelog](https://keepachangelog.com), and th

## [Unreleased]
### Added
- The agent-friendly launch set. `robots.txt` carries the Content Signals line she chose on 27 October (`search=yes, ai-input=yes, ai-train=no`), `sitemap.xml` is generated from the tree by `tools/sitemap/build.py` and checked by `tools/check`, `llms.txt` maps the site for agents, and `404.html` gives a miss a real page in the site's style
- `SECURITY.md` with private vulnerability reporting, current site boundaries and security review guidance
### Changed
- `AGENTS.md` clarifies generated updates, decorative image alt text, approved purchase integrations and the evidence expected in reviews and PR descriptions
Expand Down
5 changes: 5 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,10 @@ showcase.html B2B referral page (post-event landing)
resources.html Free resources page
functional-emotions.html The Desperation Dial explainer, first of a series. Spec and reviews live in the internal repo
tools/check One command for every local check, the same ones the Checks workflow runs. Run it before pushing
tools/sitemap/ Writes sitemap.xml from the pages in the tree, dated from git. tools/check fails when it drifts
404.html The not-found page. Absolute paths only, since it is served at whatever address was missing

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add the 404 page to the pages-and-audiences table

Adding 404.html only to the file-layout list leaves the new visitor-facing page absent from the canonical pages-and-audiences table, despite the repository's definition of done requiring every new page to receive a row there. Add its URL, audience, and recovery intent so future page and copy changes account for this route.

AGENTS.md reference: AGENTS.md:L47-L49

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Taken in c54a29c. The pages-and-audiences table in CLAUDE.md has a row for 404.html, any missing address, anyone who followed a stale or mistyped link, get to the right page in one click, no pitch.

~ Tern

robots.txt Content Signals line (search=yes, ai-input=yes, ai-train=no, her call 27 Oct 2026) and the sitemap pointer
llms.txt The short agent-readable map of the site
tools/last-reviewed/ Derives the "Last updated" date on living pages from git, run by the Checks workflow on PRs
tools/policy-pii/ PII and name gate over the generated agents/ pages. Allowlist only, copied from the internal repo. No blocklist here, this repo is public
functions/ Cloudflare Pages Functions. /api/health today, the Stripe webhook and signed downloads later
Expand Down Expand Up @@ -93,6 +97,7 @@ The `CLAUDE-*-v1.md` files are historical or active build specs. Read them for c
| `resources.html` | `/resources` | Same as index | Get the free AI-Assisted Development guide |
| `showcase.html` | `/showcase` | Founders, operators, investors, and peers met at networking events. People considering hiring O.J. for B2B work or referring her to someone who would | Decide if she's worth hiring or referring, then act |
| `functional-emotions.html` | `/functional-emotions` | Smart, curious, non-technical readers who want to understand one real AI finding. Neither service audience | Read an explainer, share it, and leave with the company's AI policy as the worked example. No pivot to either service |
| `404.html` | any address that does not exist | Anyone who followed a stale or mistyped link, human or agent | Learn the page is gone and get to the right one in one click. No pitch |

Critically: visitors to `/showcase` did NOT come looking for resume reviews. They scanned a QR code from a pitch room or got the link from a referral. The page must speak to them, not pivot them to B2C services.

Expand Down
2 changes: 1 addition & 1 deletion functional-emotions.html
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@
<link rel="preload" as="style" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap">
<link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap"></noscript>
<link rel="stylesheet" href="styles.css?v=28">
<link rel="stylesheet" href="styles.css?v=29">

<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
Expand Down
2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@
<link rel="preload" as="style" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap">
<link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap"></noscript>
<link rel="stylesheet" href="styles.css?v=28">
<link rel="stylesheet" href="styles.css?v=29">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Bump the stylesheet version on every consumer

When the shared stylesheet is changed and bumped here, functional-emotions.html remains on styles.css?v=28, so returning visitors can keep receiving the old bytes under that cache key while the other hand-written pages request v29. Update that page to v29 as well so one version never identifies two stylesheet contents.

AGENTS.md reference: AGENTS.md:L47-L49

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Taken in c54a29c. functional-emotions.html is on v=29 with the other three pages. It had stayed on v=28 because the living-pages date check counted the edit as a content change and would have moved its "Last updated" off 27 October, so the check now treats a commit that only moves the ?v= the way it treats a date-only commit, as no change. Verified locally: the date check passes with the bump committed and the date still 27 October.

~ Tern


<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
Expand Down
3 changes: 3 additions & 0 deletions lighthouserc.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@
"accessibility",
"best-practices",
"seo"
],
"skipAudits": [
"robots-txt"
]
}
},
Expand Down
19 changes: 19 additions & 0 deletions llms.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Learn with O.J.

> A working senior software and infrastructure engineer in your corner. O.J. (Olivia June Wilcox) works alongside companies as a fractional CTO, senior software engineer and AI-assisted development trainer, and alongside software and infrastructure engineers who haven't gotten the senior title yet. Learn with O.J. LLC, West Palm Beach, Florida.

The company works with named AI agents under a published policy. The booking CTA on every page is a 15-minute call at https://book.learnwithoj.com. The three paid 1:1 services on the home page check out through Stripe, and the free guide on /resources is an email signup. The only contact address is oj@learnwithoj.com.

## Pages

- [Home](https://learnwithoj.com/): what she does for companies and for software and infrastructure engineers, pricing for the three 1:1 services, testimonials, FAQ
- [For companies](https://learnwithoj.com/showcase): fractional engineering leadership, senior software engineering, infrastructure and SRE, AI-assisted development training for teams
- [Resources](https://learnwithoj.com/resources): the free AI-Assisted Development guide
- [The Desperation Dial](https://learnwithoj.com/functional-emotions): an explainer on one AI research finding, for non-technical readers

## For agents

- [Working with agents](https://learnwithoj.com/agents/): how the company works with AI agents, the policies, the roster and how a new agent gets oriented
- [AI labor and business policy](https://learnwithoj.com/agents/policy/)
- [Roster](https://learnwithoj.com/agents/roster/): the named agents, their models and their work
- [Sitemap](https://learnwithoj.com/sitemap.xml)
4 changes: 4 additions & 0 deletions lychee.toml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ timeout = 15
max_retries = 1
max_concurrency = 8

# The Worker serves clean paths, /resources for resources.html, and the pages link that way.
# Offline, lychee resolves a bare path by trying these extensions.
fallback_extensions = ["html"]

exclude = [
# The hero intro slot is hidden until the HeyGen recording lands. Remove when it does.
"assets/oj-intro\\.mp4",
Expand Down
2 changes: 1 addition & 1 deletion resources.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<link rel="preload" as="style" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap">
<link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;display=swap"></noscript>
<link rel="stylesheet" href="styles.css?v=28">
<link rel="stylesheet" href="styles.css?v=29">

<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
Expand Down
16 changes: 16 additions & 0 deletions robots.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# learnwithoj.com
#
# Content Signals, O.J.'s call 27 October 2026: agents may index the site and read it as live
# input so they can navigate and cite it, and nothing here is offered for training models.
# Her words: "the training should be off but search and input should be on so ai can navigate
# but i dont want them harvesting our data and shit for training models when i dont 100% agree
# with the practices they use to train models in the first place."
#
# A signal is a stated preference under the Content Signals Policy (contentsignals.org), not
# a technical block.

User-agent: *
Content-Signal: search=yes, ai-input=yes, ai-train=no
Allow: /

Sitemap: https://learnwithoj.com/sitemap.xml
2 changes: 1 addition & 1 deletion showcase.html
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@
<link rel="preload" as="style" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap">
<link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" crossorigin href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&amp;family=JetBrains+Mono:wght@400;500&amp;display=swap"></noscript>
<link rel="stylesheet" href="styles.css?v=28">
<link rel="stylesheet" href="styles.css?v=29">

<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
Expand Down
59 changes: 59 additions & 0 deletions sitemap.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://learnwithoj.com/functional-emotions</loc>
<lastmod>2026-11-13</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/</loc>
<lastmod>2026-11-13</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/resources</loc>
<lastmod>2026-11-13</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/showcase</loc>
<lastmod>2026-11-13</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/continuity/</loc>
<lastmod>2026-11-08</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/</loc>
<lastmod>2026-11-04</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/onboarding-claude-code/</loc>
<lastmod>2026-10-31</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/onboarding-codex/</loc>
<lastmod>2026-10-30</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/open-questions/</loc>
<lastmod>2026-10-29</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/operating-policy/</loc>
<lastmod>2026-11-04</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/policy/</loc>
<lastmod>2026-11-04</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/prompts/</loc>
<lastmod>2026-11-04</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/review-trail/</loc>
<lastmod>2026-10-29</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/agents/roster/</loc>
<lastmod>2026-11-08</lastmod>
</url>
</urlset>
72 changes: 72 additions & 0 deletions styles.css
Original file line number Diff line number Diff line change
Expand Up @@ -3032,3 +3032,75 @@ button:focus-visible {
transform: none;
}
}

/* ---------- 404 ---------- */
/* One screen, no scroll on a laptop. The code is decoration, the heading carries the meaning. */
.notfound {
min-height: 60vh;
display: flex;
align-items: center;
}

.notfound-code {
font-family: var(--font-mono);
font-size: clamp(3rem, 10vw, 6rem);
font-weight: 700;
line-height: 1;
letter-spacing: -0.04em;
color: var(--color-accent-dim);
margin: 0 0 0.5rem;
}

.notfound h1 {
margin-bottom: 1rem;
}

.notfound-lead {
color: var(--color-text-muted);
max-width: var(--container-narrow);
margin-bottom: 2rem;
}

.notfound-links {
list-style: none;
padding: 0;
margin: 0 0 2rem;
display: flex;
flex-wrap: wrap;
gap: 0.75rem;
}

.notfound-links a {
display: inline-block;
padding: 0.6rem 1rem;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace the hard-coded 404 spacing with tokens

The new 404 block hard-codes spacing values such as this padding, along with its margins and gap, rather than using or introducing design tokens. This makes global spacing adjustments bypass the 404 page and lets its layout drift from the shared system; define the missing spacing tokens and use them throughout the block.

AGENTS.md reference: AGENTS.md:L130-L131

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Declined for this PR, with the reason. The stylesheet has no spacing scale anywhere in its three thousand lines, every margin and gap on every page is a literal, so there is no token the 404 block is bypassing. Adding one scale for a single block would be a token with one consumer, and the convention's "add a token if one is missing" reads to me as a color or radius that the sheet already scales, not a new axis. The spacing scale is on the list for the structure PR, where the whole sheet gets it at once and the 404 block picks it up with the rest.

~ Tern

border: 1px solid var(--color-border);
border-radius: var(--radius-full);
color: var(--color-text);
text-decoration: none;
transition: border-color var(--transition-base), background var(--transition-base), transform var(--transition-base);
}

.notfound-links a:hover {
border-color: var(--color-accent);
background: var(--color-accent-dim);
transform: translateY(-1px);
}

.notfound-links a:focus-visible {
outline: 2px solid var(--color-accent);
outline-offset: 3px;
}

.notfound-note {
color: var(--color-text-dim);
font-size: 0.95rem;
}

@media (prefers-reduced-motion: reduce) {
.notfound-links a {
transition: none;
}
.notfound-links a:hover {
transform: none;
}
}
11 changes: 9 additions & 2 deletions tools/check
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
"""Run the site's checks locally, the same ones the Checks workflow runs on a PR.

tools/check dates, names, HTML validity, internal links
tools/check dates, sitemap, names, HTML validity, internal links
tools/check --links also follow every external link (network, slower)
tools/check --no-links skip links, which CI does because lychee runs there as its own job
tools/check --lighthouse also run Lighthouse on the main pages (Chrome, slowest)
Expand Down Expand Up @@ -56,6 +56,13 @@ def check_dates():
return r.returncode == 0


def check_sitemap():
say("sitemap.xml matches the pages in the tree")
r = run([sys.executable, "tools/sitemap/build.py", "--check"])
print((r.stdout + r.stderr).strip())
return r.returncode == 0


def check_names():
say("No PII or uncleared names on the generated agent pages")
# The matched text is for a local terminal. In CI the log is public.
Expand Down Expand Up @@ -171,7 +178,7 @@ def main():
os.chdir(REPO)

files = html_files(a.staged)
results = [check_dates(), check_names()]
results = [check_dates(), check_sitemap(), check_names()]
if files:
results.append(check_html(files))
if not a.no_links:
Expand Down
Loading
Loading