Skip to content
Closed
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
80 changes: 80 additions & 0 deletions 404.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<!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>
Comment on lines +7 to +8

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 required social metadata to the 404 page

When a social crawler fetches a missing URL, this new page provides a title and description but no Open Graph or Twitter card tags, despite the repository requirement that every page carry them. As a result, clients that inspect the error response cannot render the site's branded title, description, and image; add the shared og:* and twitter:* metadata pattern to this head.

AGENTS.md reference: AGENTS.md:L3-L8

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 #44, which replaces this PR. 404.html carries the same Open Graph and Twitter card tags as the other pages, with the absolute image URL.

~ Tern


<!-- 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
4 changes: 4 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
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
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">

<!-- Analytics -->
<script data-goatcounter="https://learnwithoj.goatcounter.com/count"
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, and every CTA on the site books a 15-minute call at https://book.learnwithoj.com. The only contact address is oj@learnwithoj.com.

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 Qualify which CTAs open the booking call

An agent reading this discovery file is told that every CTA books a 15-minute call, but the home page also has three Stripe purchase CTAs and the resources page has the Kit guide form. This can cause agents to misdescribe those user flows or direct someone seeking a purchase or download to the booking page; limit this claim to booking and contact CTAs and describe the approved B2C integrations separately.

AGENTS.md reference: AGENTS.md:L73-L76

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 #44, which replaces this PR. llms.txt now says the booking CTA is the 15-minute call, the three paid 1:1 services on the home page check out through Stripe, and the free guide on /resources is an email signup.

~ Tern


## 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-10-27</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/</loc>
<lastmod>2026-10-27</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/resources</loc>
<lastmod>2026-10-27</lastmod>
</url>
<url>
<loc>https://learnwithoj.com/showcase</loc>
<lastmod>2026-10-27</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;
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