Claude Code โข Firebase โข Git โข NPM โข Docker โข Cloud Run โข Terminal
npm install if dependencies changed.
VITE_USE_FIREBASE=true, localhost still hits live Firestore โ only the UI is local. Anything needing a new rule/function fails here until you deploy it (step 5).
dist/ (what Hosting serves). If it fails, fix before deploying โ nothing reached live.
hosting.
.web.app URL. Confirm it works live โ sometimes it passes locally but not in prod.
npm run dev won't see .env changes (like flipping VITE_USE_FIREBASE) until you restart it (Ctrl+C โ rerun). Broke the live site? Roll back instantly in Firebase Console โ Hosting โ release history. Functions need "node": "20" or "22" in functions/package.json (not 24).
--dangerously-skip-permissions = "YOLO mode". It auto-approves every file write, shell command, and network call with no prompts. Only run it in a trusted repo where git is your undo button โ commit before you start so you can roll back. Equivalent to --permission-mode bypassPermissions.
claude -r.
default, acceptEdits, plan, auto, bypassPermissions.
opus, sonnet, haiku) or a full model ID for this session.
--dangerously-skip-permissions for fully headless runs.
claude isn't recognized in CMD at all.
claude auth login to sign in, claude auth logout to switch.
cc.bat in a folder that's on your PATH (e.g. C:\Windows or a personal C:\bin):
cc in any project folder to launch in skip-permissions mode. The %* passes through anything extra, so cc "fix the build" works too.
They point at each other: RUNBOOK.md points to CLAUDE.md for the stack, commands, and rules โ and CLAUDE.md points to RUNBOOK.md for the current tasks.
IDEAS / LATER if you're not building it yet) โ never straight into the code.You're setting me up on a brand-new project and I want you to explain things simply. Do these
steps IN ORDER and DON'T build any features until I approve.
1) Look at anything already in this folder. Then ask me up to 4 short questions to learn: what
I'm building, who it's for, the main features I want to start with, and any tools I already
use. Wait for my answers.
2) Recommend the SIMPLEST tech stack that does the job (no over-engineering). Explain it in
plain English, name the exact tools and where it will be deployed, and give one main pick
plus one simpler alternative. If the tools I already use fit, say so. Then wait for me to
say "go".
3) After I approve, create two Markdown files that reference each other:
- CLAUDE.md: the permanent project brain. Most important rules at the top. Include the
stack, the exact install/run/build/deploy commands, folder + code conventions, and a
"Hard Rules" section. End with: "Current tasks and progress live in RUNBOOK.md."
- RUNBOOK.md: the living task list. Start with a "RESUME HERE ->" line. Turn the features I
named into small, independently testable slices in build order; each slice gets a
checkbox, a one-line goal, the files it touches, and how I'll verify it. Tag slices
P1/P2/P3. Add an "IDEAS / LATER" section. Near the top put: "Stack, commands, and rules
live in CLAUDE.md - read it first."
4) Tell me in one sentence: from now on any new feature or idea goes into RUNBOOK.md (under
IDEAS / LATER if we're not building it yet) - never straight into the code.
5) Show me both files and the single next thing to do. Don't build yet - wait for my go.
This is a project I've already built. Create a CLAUDE.md so you have context every session without me re-explaining. First actually read the project - main files, config, package.json / firebase.json if present, and the folder structure. Don't guess; base it on what's really here. Then create CLAUDE.md in the root, most important rules at the top, including: what this project is (1-2 plain sentences), the real stack you found, the exact run/build/deploy commands from the config, the folder layout and conventions I follow, and a "Hard Rules" section with a couple of blank bullets for me to fill in. End with: "Current tasks live in RUNBOOK.md." Show me the file and flag anything you weren't sure about so I can correct it.
Read CLAUDE.md and RUNBOOK.md, then follow the "RESUME HERE" line. Plan the next unchecked P1 slice only (tell me the files and approach first), then build just that slice and show me it working. Once I confirm, check it off in RUNBOOK.md with a one-line note, then commit with a clear message, push, and deploy. Then stop and tell me the next slice.
Add this to the "IDEAS / LATER" section of RUNBOOK.md so we don't forget it, but don't build it now: [describe the feature]. If it's something we should do next, turn it into a proper slice with a checkbox, goal, files, and how I'll verify it - otherwise just log it.
firebase use --add to create aliases like "prod" or "dev".
firebase use prod.
git add.
docker ps.
lsof or ps aux.
hostname -I instead.
Ctrl+R in terminal to reverse-search your command history.
Press Tab to autocomplete paths and commands. Chain commands with && (runs next only if previous succeeds).