Vocab
๐ฅ Master OverviewCampfire Protocol is a family of tools and guides that help you preserve continuity across AI sessions, agents, and teams. Start where you are. Scale when you need to.Campfire EcosystemVocab(free) โ Lite (free) โ CLI (free) โ Field Guide ($24) โ Standard ($29) โ Pro ($49)Reference The Campfire GlossaryA plain-English guide to the Campfire Protocol vocabulary.Welcome to the fire. If you are new to human-AI coordination, this cheat sheet translates the core Campfire concepts into simple, everyday terms.โบ The Basics (The Core Files)The Campfire Your shared local folder. It is the single source of truth where you and your AI agents leave notes for each other.Ember A quick, sticky-note-sized lesson. If you figure out a bug, or realize an AI keeps making the same mistake, you write a 3-line Ember. It tells the next agent: "Hey, remember this for next time."Question A literal question mark. AI models love to guess when they don't know the answer. The Questions file tells them to stop guessing, write down what they are missing, and wait for a human to answer.Story The "Previously On..." recap for your project. While code shows what you built, Stories explain why you built it. It gives new agents instant context on the big picture.Handoff The baton pass. When you or an agent finish a session, you write a Handoff. It simply says: "Here is what I did, here is the current state, and here is exactly what the next person/agent needs to do."Decision The receipt for a choice. Instead of losing why you chose a specific pricing model or software architecture in a closed chat window, you log it here so nobody has to debate it again in the future.๐งโ๐ป The Players (Who is at the fire)Operator That's you. The human director. You don't necessarily do all the typing; you set the goals, resolve the open Questions, and approve the final work.Agent The worker. This is usually your AI (like Claude, ChatGPT, or a local model), but it can also refer to a human teammate picking up the next task.Role Blueprint A job description on steroids. Instead of just telling an AI "you are a reviewer," a Blueprint explicitly lists what they can do, what they must not do, and what a finished job actually looks like.โ๏ธ The Process (How work moves)Write Back The Golden Rule of Campfire. Never close a session without leaving something behind. You must "write back" an Ember, Question, Story, or Handoff so the fire stays lit for the next visitor.Workflow A repeatable assembly line. For example, a "Product Launch" workflow might always move from a Builder agent (who writes it) to a Reviewer agent (who checks it) to the Operator (who publishes it).Approval Gate A mandatory stop sign. A rule that says: "Do not publish anything, delete anything, or spend any money without getting a human to check this box first."๐ฆ The Traffic Lights (Status Tags)Every Handoff gets tagged with one of four statuses so anyone looking at the folder instantly knows where the project stands:๐ข [READY] โ The work is done and verified. The next agent can immediately take over.๐ก [IN PROGRESS] โ The work isn't done yet, but the agent had to pause. Here is where they left off.๐ [NEEDS REVIEW] โ The draft is finished, but an Operator needs to look at it before it moves forward.๐ด [BLOCKED] โ Something is broken, missing, or requires human intervention. Stop all work.๐ Advanced TerminologyCrystal Shard A highly compressed, machine-readable "zip file" of your current folder state. If you are moving between massive projects, a Crystal Shard lets an AI instantly download your entire project's context, decisions, and blockers in milliseconds.Air-Gapped / Local-FirstA fancy way of saying: "This doesn't need the internet." Campfire runs on standard text files on your local hard drive, meaning you never have to upload your secret projects to a third-party cloud database.Start here. Automate. Go deep. Coordinate. Standardize. Team & Enterprise โ coming soon๐๏ธ 1. Campfire Lite โ The Primerโ free, five-minute setup.Problem: Every new AI session starts from zero. You waste time re-explaining context, lose hard-won lessons, and watch momentum evaporate between conversations.Promise: Preserve the continuity of your work with three simple files and one repeatable daily practice. No database, no API, no complexity.Your First Win: Create your campfire/ folder and complete your first full practice (read โ work โ write one note) in under five minutes.Best for: Solo builders, developers, and researchers who want their AI work to feel coherent and cumulative.Whatโs next? โ Sonic Screwdriver CLI (free) โ automate your audits โ The Campfire Field Guide ($24) โ master the full system๐ ๏ธ 2. Sonic Screwdriver CLI โ The Terminal CompanionFree, zero-dependency CLI โ for power users who love the terminal.Problem: Manually checking your Campfire folder, verifying file health, and creating context snapshots is tedious and easy to skip โ especially in air-gapped or high-security environments.Promise: A fast, local, zero-dependency terminal companion that automates pre-flight audits, context snapshots, and guided write-backs โ pure Python standard library, no internet connection ever required.Your First Win: Run python3 campfire_cli.py --audit and instantly see whether your workspace is properly structured, which layer youโre on, and the status tag of your latest Handoff.Best for: Developers and power users who want maximum control, air-gap safety, and command-line speed.Whatโs next? โ The Campfire Field Guide ($24) โ the complete operating manual๐ 3. The Campfire Field Guide โ The Deep Primer$24 โ the complete operating manual for agent continuity.Problem: Lite gets you started, but the โwhyโ behind the system โ and the judgment to apply it well โ takes more than a quickstart. Without the deeper principles, folders drift, files bloat, and the habit fades.Promise: A 60-page manual covering the full philosophy, the Five Principles, all three core practices with real examples, Handoff and Decision rituals, Role Blueprints, Approval Gates, three complete workflow walkthroughs, the 7-day implementation plan, and the file maintenance rules that keep your campfire readable for months.The Field Guide is the companion book to every tier. The principles donโt change as you scale โ the depth does.Your First Win: Complete the 7-day implementation plan and end the week with a working folder, your first handoff, and a measurable drop in session restart time.Best for: Anyone serious about making Campfire a durable habit โ from solo Lite users to teams evaluating Standard and Pro.Whatโs next? โ Campfire Standard ($29) โ put Handoffs and Decisions into practice๐ 4. Campfire Standard โ The Coordination Layer$29 โ for serious individuals and small teams who need explicit coordination.Problem: When multiple agents or sessions touch the same project, coordination breaks down. Handoffs become vague, decisions disappear into chat history, and hidden assumptions create costly rework.Promise: Reliable coordination through explicit Handoffs, a shared Decision Log, and clear status tracking โ so every agent knows exactly where things stand and why.Lite gives you continuity. Standard gives you coordination.Your First Win: Execute a clean Builder โ Reviewer handoff using the four canonical status tags โ [READY], [BLOCKED], [NEEDS REVIEW], [IN PROGRESS] โ and watch the receiving agent continue without asking a single clarifying question.Best for: Serious individual operators and small teams who need traceable decisions and reliable state transfer.Whatโs next? โ Campfire Pro ($49) โ add Role Blueprints, Workflows, Gates, and the Historian๐ง 5. Campfire Pro โ The Repeatability Layer$49 โ for operators and technical teams that need repeatability, safety boundaries, and durable memory.Problem: Ad-hoc workflows and one-off prompts donโt scale. Quality slips, safety checks get skipped, and valuable patterns never become repeatable.Promise: Standardize your operations with named Workflow Blueprints, explicit Role Blueprints, mandatory Approval Gates, and Historian Lite โ preserving the cognitive lineage of your work across months, not just sessions.Standard reduces repeated explanations. Pro turns successful workflows into repeatable operating procedures. Includes The Campfire Field Guide free ($24 value).Your First Win: Define your first Role Blueprint and create an Approval Gate that forces agents to halt and ask before taking any destructive or public action.Best for: Serious operators, leads, and technical teams that need robust repeatability, air-gap-ready workflows, and durable memory across people and agents.Whatโs next? โ Campfire Team โ shared governance for 2โ10 persons. Coming soon; Pro buyers get first access.
Get it โ derekspinoza.gumroad.com