{"version":"https://jsonfeed.org/version/1.1","title":"Projects on crlzff.xyz","home_page_url":"https://crlzff.xyz/","feed_url":"https://crlzff.xyz/tags/projects/feed.json","items":[{"id":"https://crlzff.xyz/2026/claude-code-playbook/","title":"claude_code_playbook","content_html":"<p><a href=\"https://github.com/crlzff/claude-code-playbook\">claude_code_playbook</a> is my opinionated way of running software projects with Claude Code.</p>\n<p>It comes in two parts:</p>\n<ul>\n<li><strong>spec-driven-dev</strong> is a skill that settles <em>what</em> to build: SPEC, ROADMAP, CLAUDE.md, decisions and a log, before any code is written.</li>\n<li><strong>playbook</strong> is a plugin that runs <em>how</em> the work happens: a per-project profile, a fixed task routine (<code>/task</code> → <code>/ship</code> → <code>/done</code>), git hooks, CI, and milestone reviews.</li>\n</ul>\n<p>The main decisions behind it:</p>\n<ul>\n<li>Spec first, one task per conversation, every task with its acceptance criteria and the test that proves it.</li>\n<li>Red/green TDD: the failing test is committed on its own before the code.</li>\n<li>Review by fresh eyes: three read-only reviewers in parallel, plus a security pass on sensitive code.</li>\n<li>The main branch only takes PRs, and nothing merges before CI is read.</li>\n<li>The autopilot is experimental and opt-in. It works through approved ROADMAP tasks while I&rsquo;m away, one fresh session per task in its own worktree. It never merges anything on its own.</li>\n</ul>\n<p>The playbook owes a lot to <a href=\"https://addyosmani.com\">Addy Osmani</a>&rsquo;s <a href=\"https://addyosmani.com/blog/\">blog</a> on working with AI coding agents. Its core comes from three ideas found there: the spec comes before the code, each task stays small enough for a test to prove it, and human review is the step that actually sets the pace.</p>\n<blockquote>\n<p>It&rsquo;s MIT-licensed, experimental, and comes with no warranty: read what it does before you trust it.</p>\n</blockquote>\n","date_published":"2026-10-25T11:40:00+01:00","url":"https://crlzff.xyz/2026/claude-code-playbook/","tags":["claude-code","projects"]}]}