AILmanac is a free, open documentation site that teaches anyone — absolute beginner to power user — how to get great results from Claude (the chat apps, Claude Code, and the API) and from AI tools in general. Every page is tagged by level, written in plain language, and stamped with a "last verified" date so you always know how fresh it is.

⚠️ Independent project. AILmanac is not affiliated with, sponsored by, or endorsed by Anthropic. "Claude" and "Anthropic" are trademarks of Anthropic. When AILmanac and the official docs disagree, the official docs win — and we link to them throughout.

⭐ If a page here saves you time, please star the repo. Stars are how more people find it — and they fund nothing but motivation.

Why AILmanac (and not just the official docs)?

The official docs, cookbooks, and "awesome" lists are excellent — AILmanac doesn't replace them, it connects and opinionates them. It's built to be the one place you can send a colleague regardless of their level:

What's inside

A full funnel from "what's a token?" to "harden an autonomous agent." Browse on the live site:

• Start Here — pick a track by level/role and get a guaranteed first win.
• AI Foundations — provider-agnostic mental models: tokens, roles, sampling, RAG, embeddings, evals, hallucinations.
• Prompting — universal patterns + Claude-specific techniques (XML tags, few-shot, a pattern library).
• Claude.ai & Apps · Claude Code · Claude API — the deep Claude core.
• Playbooks · Walkthroughs · Templates & Recipes — outcome-first, copy-paste-ready.
• Tools — in-browser cost calculator, CLAUDE.md generator, MCP config builder, Prompt Doctor.
• Security & Responsible Use · Frontiers · What's New · Contribute.

🤖 For AI agents & crawlers: a machine-readable index of every page lives at /llms.txt (the llms.txt convention).

Contributing

AILmanac stays complete and fresh because people add to it — fixing a typo, adding a glossary term, sharing a template, or translating a page all count. Start with Contribute in 10 Minutes (and CONTRIBUTING.md). Be kind — we follow the CODE_OF_CONDUCT.md.

Good first contributions: spot a stale lastVerified stamp, add a worked example to a thin page, or fill a coverage gap. Look for good first issue.

Run it locally

Requires Node.js (see .nvmrc).

npm install
npm run start     # dev server with live reload at http://localhost:3000
npm run build     # production build — FAILS on broken links (a feature)
npm run serve     # preview the production build locally

Regenerate the machine-readable index after adding pages:

node scripts/build-llms-txt.mjs   # rebuilds static/llms.txt

Deploy (GitHub Pages)

The site targets https://derob98.github.io/ailmanac/ (ORG is set in docusaurus.config.ts).

1. GitHub Actions: .github/workflows/deploy.yml builds and publishes on every push to main. Enable it once via Settings → Pages → Source = GitHub Actions. (Pushing the workflow file needs a token with the workflow scope.)
2. gh-pages branch (no special scope): run npm run build, then publish the build/ folder to a gh-pages branch and set Settings → Pages → Source = Deploy from a branch → gh-pages.

Using a custom domain? Set url to it, baseUrl to /, and add static/CNAME.

Cite AILmanac

Referencing AILmanac in a post, course, or paper? A citation file is included — see CITATION.cff. GitHub's "Cite this repository" button (top-right of the repo) generates APA/BibTeX for you.

Author & maintainer

Created and maintained by Gianluca De Robertis (@derob98). Contributions from the community are very welcome — see CONTRIBUTING.md.

License

Dual-licensed, so you can reuse both the words and the code:

• Prose / documentation: CC BY 4.0 — reuse with attribution.
• Code, examples & config: MIT.

See NOTICE for details.