agent tips

a personal handbook for using agents to build things and handle everyday work.
the site brings together everyday work, building for fun or serious use, and
personal infrastructure. product guides provide the specific controls.

read the handbook or go directly to a principal guide:

• codex
• claude code
• grok
• start here
• choosing an agent setup
• everyday work
• building things
• personal infrastructure
• backups and getting your work back
• how coding agents got here
• where this comes from

resume here

The reassessment records a disposition for all 24
pages present at the start. Four shared pages now have a publishable first edition. The section audit covers
headings, copy, source conflicts, and both recovered stashes. The
review ledger owns wording acceptance and the
local /__progress/ page derives the current review map.

• review the homepage bridge and remaining start page copy
• review deeper backup page copy in small batches, continuing with “choose one backup workflow”
• reassess the published everyday work and building copy in small wording batches
• review corrected product copy in small wording batches

The October 17 accuracy disposition records the product corrections and the limits of the source and example checks. Exact wording acceptance remains in the review ledger. PR #329 carries these corrections and their final check and release evidence.

PR #327 carries the organized
publication and backup first edition. Its exact-head checks and deployment
records own release evidence.

PR #326 carries the setup,
reconciled design work, audit, and accepted opening copy through protected checks.
Its check and deployment records own release evidence.

The structure is accepted with separate building paths for curiosity and work
with business or real world consequences. The homepage headline/subtitle, everyday first-task example and exact planning
tradeoff paragraph are accepted;
the infrastructure opening and six sections also have exact acceptance records.
The deeper backup outline is accepted; its body copy remains under review.
Ani authorized organized publication of the shared pages on October 12.
Publication authority does not extend exact wording acceptance to newly added prose.
Archived plugins retain compatibility through November 5, 2026.

project layout

content/ owns guide copy; editorial/ owns sources and review evidence;
src/ renders the site; scripts/ owns checks. design.md owns visual rules.
Worktree setup describes reusable setup and preview actions.
The handbook review stays in the saved local main checkout.

evidence principle

• tested: reproduced in a named environment and version, with the tester and limits stated
• official source: confirmed in current primary documentation or source code
• analysis: a judgment derived from stated evidence
• open question: current evidence is missing or incomplete

citations sit beside the claims they support. tested observations name their limits, while source based claims stay distinct from personal analysis.

local verification

node scripts/project.mjs setup
node scripts/project.mjs verify

built and maintained by ani potts. corrections with primary sources or reproducible field evidence are welcome.

MIT