← Chapter Guide
Chapter Guide · Working with AI

Working with your AI assistant

The big shift: you don't learn how your website works — your AI assistant does, automatically. Here's how that works and what to expect.

It learns your site, not you

We recommend Claude Code. To get going, you just open it inside your chapter's project folder:

cd lunatechs-chapter-yourcity
claude

That's it. Claude Code automatically reads the guidance that ships with your site and immediately knows how everything works — your events format, how pages are built, the brand voice, and what's off-limits. You don't configure anything; you just start asking.

For example

“Add next week's event,” “make a recap from these photos,” “change the hero tagline.” It already knows where everything goes.

Mac or PC? Lunatechs was built by Mac developers, so our examples assume a Mac. On Windows everything works the same way — now and then a command looks a little different (and your AI assistant can translate it for you on the spot). We don't keep separate PC instructions, but it's close and easy to adapt. Hit a Windows-specific snag? Email info@lunatechs.social and we'll help.

The guidance lives in plain text files

Your site comes with a few Markdown files — plain-English notes the assistant reads. The main one is CLAUDE.md. It explains the rules and how your site is put together, so the AI follows them without you having to.

CLAUDE.mdThe house rules + how your site works. Claude Code reads this first, every time.
README.mdA short overview of your repo for any human (or agent) who opens it.

You can even add your own preferences to CLAUDE.md — just write them in plain English and the assistant will follow them from then on.

e.g. add lines like

“Always use our brand purple for buttons. Keep event summaries to two sentences. Sign recaps off with ‘— the [City] crew.’”

Tools & skills

Your site ships with the essentials:

These arrive in the kit automatically — run ./dev.sh once and your assistant picks them up. We're adding more (a photo resizer, event-poster helpers); more coming soon.

Using a different coding agent?

Claude Code is what we recommend — it reads the guidance files on its own and has the smoothest setup. You're welcome to use another agent (Cursor, etc.), but it may not pick up the guidance automatically — just point it at your CLAUDE.md first.

Stuck getting your agent working? Don't wrestle with it — email info@lunatechs.social and we'll help you get set up. We can also grant access to your repo or anything else you need.