ai-for-dummies/README.md

AI For Dummies

A lightweight, presentation-style field guide to AI-assisted engineering.

It explains how to combine a strong planning/review model with faster workers, reusable skills, subagent handoffs, Git worktrees, and explicit verification. An interactive field kit compares common behavior skills such as ponytail-lite, caveman, unlazy, research, debugging, and review. The skill-forge workflow covers discovery, triggers, package anatomy, progressive instructions, structural validation, and behavioral iteration. The hands-on lab provides a tiny starter project and copy-ready baseline and skill-enabled prompts for a short side-by-side exercise. An interactive model gearbox separates capability tier from reasoning effort across OpenAI, Claude, and Gemini, and every featured skill links to a pinned source with an approval-first installation prompt.

Run locally

This is a dependency-free static site:

python3 -m http.server 4173

Then open http://localhost:4173.

Verify the content and interaction contracts with:

npm run verify

Project structure

• index.html — presentation content and semantic structure
• styles.css — editorial visual system and responsive layout
• app.js — bilingual workflow, repository-tree, routing, and skill interactions
• responsive.css — interactive diagrams and Full HD-to-4K adaptations
• docs/references/ — bundled research sources and notes
• docs/operations-guide.md — canonical SilverBullet operations and skills guide
• hands-on/starter/ — dependency-free Tiny Tasks exercise
• GATES.md — acceptance ledger for the project

Publishing

The Gitea instance has a Pages Server configured to publish a repository’s pages branch under pages.marcospaulo.dev.br. The intended site address is:

https://netcracker.pages.marcospaulo.dev.br/ai-for-dummies/

If the URL is not available yet, verify that the pages branch exists and that the repository’s pages branch exists. Gitea itself does not provide a built-in Pages server; this setup uses the instance’s separate Pages Server and Actions deployment path.

For the complete authoring, verification, publication, rollback, worktree, and skill workflow, see docs/operations-guide.md.

Research

See docs/references/README.md for official Claude, Codex, and Git documentation. The additional reading path bundles 12 verified articles and guides, including Medium and practitioner sources. See model routing for current provider controls and verified skill sources for commit-pinned provenance.