Changelog — The Craft

Notable changes to The Craft doctrine. Versioning is semantic (MAJOR.MINOR.PATCH). Entry date = publication day — when the version was deployed to thecraft.jakub.solutions and ready to download.

MAJOR — a rule or chapter reworked or removed (a breaking change to how things were understood). MINOR — a new chapter or a significant new rule. PATCH — a clarification, an example, a fix.

1.0.1 — 2026-07-06

Lessons from a real reference project, folded into existing chapters (no change to the chapter list — hence a PATCH). The core: the doctrine is written for one developer working with AI, where “solo” still means several parallel Claude sessions on one repo — and it’s those, not a human team, that force the discipline of coordination.

intro — “Who this is for”. A single developer plus AI as a pair; “solo” already means many writers (parallel agent sessions), so coordination rules matter from the second open session.
05 — coordinating parallel work. Team work reframed as parallel Claude sessions: review the diff before merging to the deploy branch, mind the origin-vs-local trap (a deploy ships origin, so check your push first), boot-check on the target before reloading, and a full deploy dress rehearsal dev → preprod → prod.
04 — absolute paths at tool boundaries (/tmp means different things in Git Bash, Python — A popular, readable programming language — The Craft’s default for scripts, data and the back end. A proven default: lots of ready tools and libraries, easy to drive with AI. and PowerShell) and a rehearsal of a mass data change on a copy of production.
13 — mobile: the viewport is a moving target. 100dvh instead of 100vh, elements above the keyboard anchored to visualViewport, and measuring real DOM geometry instead of trusting the emulator.

1.0.0 — 2026-06-19

The first public release — the complete The Craft doctrine, ready to drop in as docs/rules/ in a new project. From the first commit to production: how to build with Claude so the project stays understandable, safe to change and worthy of trust.

17 chapters in two languages (EN canon + PL — the same chapters, the same anchors): the Decalogue (00) + core (01–08) + depth (09–16) — from documentation, tests, Git and deployments, through law, SEO and the data model, to performance, operational resilience, Scraping — Automatically gathering data from websites with a program instead of copying by hand. Powerful for acquiring data, but it needs manners: respect others’ rules (robots.txt), don’t overload the server./AI and driving Claude.
An HTML reader in the pack — renders the .md files from a double-click (file://), light/dark mode, EN/PL switch.
The website thecraft.jakub.solutions — a friendly wrapper with a download.