Beginner overview
This guide is for people who aren’t full-time developers. It’s built to walk you, one step at a time, from setting up your environment with /start, to writing your first post in natural language, to publishing it on Blogger. If you get stuck along the way, keep troubleshooting open in a side tab and look for the same symptom.
Who this was written for
Section titled “Who this was written for”Quite a few people picking up this base aren’t full-time developers. So the tone is hand-holding. There is one assumption about your starting level, though.
The assumption that you’ve opened a terminal at least once and have experience working with AI. It spells out commands one line at a time, but it doesn’t explain from scratch “what a terminal is,” “what git is,” or “why Python is needed.” That’s not what this manual teaches; for that, keep free learning material open in a side tab (a git/terminal intro on YouTube, MDN, Anthropic’s Claude Code quickstart).
It assumes these three things.
- You know the names and rough uses of the terminal, git, and Python. Commands are spelled out one line at a time on top of that.
- The first run doesn’t need a Blogger connection. The end of the first step is
/startverifying your environment and capturing your blog identity. The actual publishing connection starts at the publish step. - AI does the writing. This guide uses Claude Code. You only need to know what topic you want to write about.
If parts are already familiar, skim those steps. Still, it’s worth running your eyes over each one once, because when you hit something that behaves differently than expected, it helps to know where to come back to.
Step guide
Section titled “Step guide”| Step | What you do | Rough time |
|---|---|---|
| 1 prerequisites | Install Python, pip, git, Claude Code; a Google account and Blogger; OAuth credentials | 40–60 min the first time |
| 2 clone-and-install | Get the base and install the publish-script dependencies | 5–10 min |
| 3 first-run | Verify the environment and capture the blog identity with /start | 20–40 min |
| 4 write-first-post | Write your first post in natural language (research and drafting) | 30 min–1 hr |
| 5 bilingual | Make the Korean and English versions at once | 10–20 min |
| 6 publish | Connect Blogger and the first publish (dry-run first) | 30 min–1 hr |
| 7 automated-safety-net | Understand the two pre-publish gates and the hooks | 10 min |
| 8 when-ai-gets-stuck | Unblock the AI workflow itself | only when needed |
| 9 troubleshooting | A collection of common sticking points | only when needed |
| 10 promote (optional) | Spread the post on X and Reddit after publishing | 30 min+ |
| 11 staying-up-to-date (optional) | Bring base updates into your blog | 10–30 min per cycle |
If you’re already comfortable with running a blog and automated publishing, the expert manual covers the same base at a shorter pace.
When you’re stuck
Section titled “When you’re stuck”The first place to look is troubleshooting. The spots you commonly hit on a first run are almost all collected there.
If the same symptom isn’t there, copy the error message verbatim, paste it into Claude Code, and ask “how do I fix this?” A next move to try usually follows.
If it still doesn’t resolve, open a GitHub issue or post in the team Slack. Write down three things together.
- Where you got stuck (which step, which command)
- The full error message
- Environment info (operating system, Python version)
The first run is the slowest. Once the environment is set up, you skip steps 1 and 3 wholesale for the next post, and the path from “write a post about this” to publishing gets noticeably shorter.
How far the manual goes, where the base begins
Section titled “How far the manual goes, where the base begins”What this step table covers is what the base handles automatically — the pre-publish AI-smell gate and AdSense gate, simultaneous Korean–English publishing, AI-SEO, context recovery, and other differentiators. The manual text is free, and you keep it open in a side tab as you follow along.
The actual base code and the full .claude/ set (agents, skills, hooks) will be released soon as a license plus an update channel. When pricing and the payment channel are set, it’ll be announced here and on the landing.