Allan Career Hacks system wiki

A plain-English map of the noindexed wisdom collection, signup flow, quote bank, daily monitoring workflow, and maintenance steps behind wisdom.candidleap.com/allan.

What This Tool Does

Readable Collection

The main page shows Allan's Career Hack posts as a timeline and lets people search or filter by topic.

AI Advice Prompt

The Ask Allan tool copies a prompt for Codex or Claude Code and points models to a clean Markdown quote bank so advice can cite real Allan quotes.

Build Story

The How This Was Built page documents the human-directed AI process without publishing the raw transcript.

Subscriber Intake

The signup page sends name and email directly to Resend. There is no D1 subscriber database and no local raw PII store.

Architecture Map

This is the current shape of the system. The browser-facing pages are static files, while signup uses a Cloudflare Pages Function to talk to Resend.

Sources

LinkedIn and X posts from Allan are found manually and by the daily monitor skill.

Collection

public/allan/index.html stores the visual page and the post JSON used by the page.

Quote Bank

scripts/export-quotes.mjs generates quotes.md and quotes.json for AI and automation.

Cloudflare

Cloudflare Pages serves the static site and runs /api/subscribe.

Resend

Resend stores subscriber contacts in the Allan Career Hacks segment.

Public Routes

Route Purpose Backed By
/allan/ Main reading experience, filters, source links, Ask Allan prompt, and skill install link. public/allan/index.html
/allan/quotes.md Markdown quote bank for Codex, Claude Code, and other AI tools. scripts/export-quotes.mjs
/allan/quotes.json Structured quote data for scripts or future automation. scripts/export-quotes.mjs
/sign-up/ Signup form for people who want future Allan Career Hack updates. public/sign-up/index.html
/api/subscribe Validates signup input, creates or updates the Resend contact, and adds it to the segment. functions/api/subscribe.js
/allan/wiki/ This operational overview. public/allan/wiki/index.html
/allan/how-built/ Cleaned public build journal: human direction, AI execution, safety choices, and artifacts. public/allan/how-built/index.html

Subscriber Flow

Subscriber data goes directly to Resend. Cloudflare receives the request transiently, validates it, and forwards it to Resend using the encrypted Pages secret.

1. Visitor

Submits name and email on /sign-up/.

2. Pages Function

/api/subscribe normalizes the email, checks a honeypot, and rejects invalid input.

3. Resend

The contact is created or updated and placed in the Allan Career Hacks segment.

Current Status

  • Live: Main collection, noindex headers, Ask Allan prompt, quote bank, signup form, and Resend contact capture.
  • Live: RESEND_API_KEY is installed as an encrypted Cloudflare Pages production secret.
  • Recommended next: Add Cloudflare Turnstile before sharing the signup page broadly.
  • Recommended next: Connect the daily monitor to send public broadcasts through Resend when new quotes are added.

How To Update Quotes

  1. Find and verify the post. Use Allan's LinkedIn activity, X profile, and Google searches scoped to LinkedIn/X. Confirm the text, date, source URL, and whether it starts with "Career hack".
  2. Edit the source data. Add the new post to the postsData JSON inside public/allan/index.html. Keep newest posts first.
  3. Regenerate AI files. Run node scripts/export-quotes.mjs so quotes.md and quotes.json match the visual page.
  4. Verify locally by script. Parse the page script with Node, check quote count, and confirm the latest post appears in both the page and quote bank.
  5. Deploy. Run npx wrangler pages deploy public --project-name wisdom --branch main.
  6. Smoke test production. Check /allan/, /allan/quotes.md, /sign-up/, and a safe test request to /api/subscribe.

Daily Monitor

The Codex skill monitor-allan-career-hacks contains the search playbook for finding new Allan posts. The daily automation runs with high reasoning effort and should:

  • Search LinkedIn, X, and Google with the prescribed query families.
  • Deduplicate by source URL and activity ID.
  • Add verified new quotes to the site.
  • Regenerate the quote bank and deploy.
  • Email Hal when a new quote is found.

Important Warnings

  • Do not commit or print RESEND_API_KEY. Cloudflare can list that the secret exists, but it cannot reveal the value.
  • The entire subdomain is intentionally noindexed through public/_headers and page-level robots tags.
  • There is no D1 subscriber table. Resend is the source of truth for subscriber PII.
  • The signup endpoint logs only operational errors. Avoid adding request-body logging.
  • Resend's segment/contact API shape may change over time; test /api/subscribe after dependency or provider changes.

Useful Commands

node scripts/export-quotes.mjs
node --check functions/api/subscribe.js
npx wrangler pages secret list --project-name wisdom
npx wrangler pages deploy public --project-name wisdom --branch main
curl -sS https://wisdom.candidleap.com/allan/quotes.md | head
curl -sS -X POST https://wisdom.candidleap.com/api/subscribe \
  -H 'content-type: application/json' \
  --data '{"name":"Test User","email":"[email protected]","website":""}'
🌽