Shipped
May 2026
Jones and AI website
Built by me, using an agentic development process. This personal website and publishing system powered by Next.js, MDX content, Vercel, Beehiiv newsletter capture, repo-level instructions, local skills, and a working log that keeps the build process visible.
The Jones and AI website is the public home for working notes, projects, and reusable resources for your AI toolkit. The architecture is intentionally simple: Next.js App Router for pages, file-based MDX collections for content, Vercel for deployment, a server action for Beehiiv newsletter capture, and static HTML guides for the brand system and homepage concept.
The site is also the test bed for the design system itself, including light/dark theme tokens, project and toolkit collections, and a publishing workflow that aligns with my Obsidian knowledge system. It serves two purposes: a portfolio of my AI journey and a working environment for learning how to build with agents in public.
Local setup
The local repo is set up so agents can pick up context without a long handoff. CLAUDE.md is the source of truth for project conventions, writing style, git workflow, accessibility rules, and where content should live. AGENTS.md stays intentionally small and points back to that file. docs/design.md holds the visual system, while docs/activity-log.md and docs/backlog.md preserve session history and parked work.
Content lives in repo-backed collections under content/. Working notes, projects, and toolkit items are all MDX files with frontmatter, so an idea can start as a short entry and grow into a fuller page without moving systems.
Skills and agents
The repo includes local skills for repeatable work: frontend design, website audits, Playwright testing, security checks, Supabase/Postgres guidance, and skill discovery. I also keep planning and review skills nearby for sharper product and engineering passes. The point is not to automate taste. It is to give agents a better operating surface when the work needs critique, verification, or a specific domain workflow.
Claude Code and Codex both work against the same repo rules. Claude is useful for longer writing, critique, and broad implementation passes. Codex is useful for focused code changes, local verification, browser checks, and keeping the workspace moving without losing track of files.
Workflow
Most sessions follow a simple loop: pull latest main, read the project instructions, inspect the relevant content or code, make the smallest useful change, verify it locally, update the activity log, then commit and push. For bigger changes, the loop adds a design pass, a browser pass, and a build pass before publishing.
That workflow matters because the site changes from multiple machines and tools. The activity log gives future agents a short memory of what changed, what was decided, what still needs review, and where the next person should start.