← All guides

GitHub 101: Getting Started (For People Who Don't Code)

GitHub explained for non-developers: what it is, why it's the best free home for an AI-readable second brain, and your first 30 minutes, step by step.


GitHub has a reputation problem: everyone thinks it's only for programmers. I run my entire agency out of it, and the amount of code I write is zero. My meeting notes live there. My client strategies live there. The rules my AI follows live there. This is the plain-English starter I wish someone had handed me.

What GitHub actually is

GitHub is a home for folders of plain files, with three superpowers that matter for us:

  • Version history. Every time you save, GitHub keeps a record of exactly what changed, when, and why. You can look at (or restore) any earlier version of any file, forever. Delete a paragraph on Tuesday, want it back in October? It's there. Nothing is ever accidentally gone, which changes how brave you can be with your own files.
  • AI tools read it natively. Claude connects to GitHub cleanly, and Claude Code (the surface I use most) is genuinely built for working inside repositories. If you're building a second brain your AI can read, this is the most AI-fluent home it can have.
  • It's free. Unlimited private repositories on a free account. Your entire business brain costs nothing to store.

The only vocabulary you need

GitHub's interface is full of engineer words. You can ignore nearly all of them. Learn these four and you're fluent enough:

  • Repository ("repo"): a project folder. Your second brain is one repo.
  • Commit: a save, with a note attached describing what changed ("added July meeting notes"). Those notes are what make the history readable later.
  • README: the file at the top of a folder that explains what's inside. GitHub displays it automatically when you open the folder, like a welcome mat.
  • Markdown (.md): plain text with light formatting (headers, bold, lists). It's what you'll write files in. If you can type an email, you already know 90% of it.

Branches, pull requests, forks, actions? Real things, all ignorable for this use case, possibly forever.

Your first 30 minutes, step by step

  1. Create a free account at github.com. Pick a handle you don't mind a client seeing.
  2. Create your first repository. Click New repository. Name it something like business-brain. Set it to Private (only you and people you invite can see it; double-check this toggle, it matters). Check "Add a README" and create.
  3. Write the README. Click the pencil icon on the README and describe what this repo is in a paragraph: "This is the operating brain for [business]. One folder per client, shared rules in /rules." Then commit the change (green button; the note autofills, or write your own).
  4. Build your folder skeleton. From the repo home: Add file → Create new file. Type clients/acme/README.md as the filename and GitHub creates the folders for you (the slashes make folders). Repeat for rules/README.md and meetings/README.md. That's the trick nobody tells beginners: folders are created by naming files into them.
  5. Upload real files. Add file → Upload files, and drag in a batch: notes, strategy docs, whatever starts the brain. Commit.
  6. Edit in the browser. Any file, pencil icon, edit, commit. For a starter setup you may never need more than the website.
  7. Connect your AI. Add the GitHub connector in Claude, point it at your repo, and ask it to read the README back to you and summarize the structure. When it answers correctly, your brain is live.

The workflow that makes it stick

The failure mode isn't the setup. It's week three, when files stop arriving. Two habits prevent that:

Give everything a home before you need it. The folder structure (one folder per client, same subfolders inside each) is decided once, so filing is never a decision again. The full architecture, including the README template that teaches your AI how to use each folder, is in the second-brain guide.

Let your AI do the filing. Here's the compounding trick: once Claude Code can work in your repo, you stop doing GitHub chores yourself. "File these meeting notes in the right client folders and commit with a clear message." "Create a folder for my new client with the standard structure." The tool that reads your brain also maintains it. My commits have messages like a well-run changelog, and I didn't write most of them.

Why I picked it over prettier options

My second brain is plain text files, and GitHub never traps them. If a better tool shows up next year, I point it at the same repo and keep moving; I could download the entire thing as a zip file today and lose nothing. Notion is nicer to look at, and its lock-in is real. Google Drive is easier, and AI tools read it less cleanly. GitHub's on-ramp is the steepest of the four, and it buys total portability and the cleanest AI access. (The honest four-way comparison lives in the second-brain guide.)

The caveat, said plainly: GitHub looks like it was built for engineers, because it was. You will see menus you never touch and words you never learn. That's fine. You need about 10% of what's on the screen, and this page just taught you that 10%.

Mistakes to avoid

  • Making the repo public by accident. Private is a creation-time toggle and a settings toggle. Check it twice; your client notes are in here.
  • Uploading huge media files. GitHub is built for text. Keep video and big design files in Drive or Dropbox, and put a link to them in your markdown notes instead.
  • Vague commit messages. "Update" tells future-you nothing. "Added Q3 strategy from June planning call" is a sentence now and a searchable history later.
  • Creating five repos when you need one. One business-brain repo with folders inside beats a scatter of tiny repos. Split only when something genuinely separate emerges (like a website codebase).
  • Waiting until you're "organized enough" to start. Messy files in version control beat perfect files in your head. Upload, then tidy.

FAQ

Do I need to know how to code to use GitHub? No. If you can manage folders in Google Drive, you can run a GitHub repo from the website alone. The coding features can sit unused forever.

Is GitHub free? Free accounts include unlimited private repositories. This whole use case costs nothing.

What's the difference between GitHub and Google Drive? Drive stores documents in Google's formats and syncs them. GitHub stores plain files with a complete change history and a note on every save, and AI tools read plain files more cleanly. Drive is easier on day one; GitHub is more portable and more AI-fluent every day after.

Can my team use it with me? Yes. Invite them as collaborators on the repo (Settings → Collaborators) and everyone works from the same files, with history showing who changed what.

Do I need to install anything? Not to start. The website covers creating, uploading, and editing. If you later want your repo living on your computer as regular folders, GitHub Desktop is the friendly way, and by then you'll be comfortable enough to want it.