<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Claude Code on Grant Lucas</title>
    <link>https://grantlucas.com/tags/claude-code/</link>
    <description>Recent content in Claude Code on Grant Lucas</description>
    <generator>Hugo</generator>
    <language>en</language>
    <lastBuildDate>Wed, 18 Feb 2026 20:00:00 -0500</lastBuildDate>
    <atom:link href="https://grantlucas.com/tags/claude-code/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>I Built an App That&#39;s Only Useful Three Weeks a Year</title>
      <link>https://grantlucas.com/posts/2026/02/i-built-an-app-thats-only-useful-three-weeks-a-year/</link>
      <pubDate>Wed, 18 Feb 2026 20:00:00 -0500</pubDate>
      <guid>https://grantlucas.com/posts/2026/02/i-built-an-app-thats-only-useful-three-weeks-a-year/</guid>
      <description>&lt;p&gt;&lt;em&gt;How building from my phone exposed every point of friction in my workflow, and how I can make it better for all devices&lt;/em&gt;&lt;/p&gt;&lt;p&gt;Let me be upfront: the app I&amp;rsquo;m about to describe is useful for &lt;em&gt;maybe&lt;/em&gt; three&#xA;weeks out of the year. &lt;a href=&#34;https://sapcast.ca/&#34;&gt;It helps you figure out when to tap a maple tree for&#xA;sap.&lt;/a&gt; That&amp;rsquo;s it. The rest of the year it just sits there,&#xA;waiting for February to roll around again. I can&amp;rsquo;t think of much else targeting&#xA;such a specific, and time-limited, niche&amp;hellip;&lt;/p&gt;&#xA;&lt;p&gt;A year ago, I wouldn&amp;rsquo;t have built this. Not because it&amp;rsquo;s hard, but because the&#xA;return on investment is laughable. A few weeks of utility for evenings of&#xA;development time, if I finish it at &lt;em&gt;all&lt;/em&gt;, is not worth it. I&amp;rsquo;d just check the&#xA;weather forecast myself, squint at the overnight lows, and make a guess like I&#xA;did last year. The motivation simply wouldn&amp;rsquo;t survive contact with the reality&#xA;of actually sitting down to build it.&lt;/p&gt;&#xA;&lt;p&gt;At the end of the day or on the weekend, at this point in my life, I &lt;em&gt;just don&amp;rsquo;t&#xA;have the time or remaining brain cycles,&lt;/em&gt; to work through software side projects&#xA;when life&amp;rsquo;s already busy or I spent all day in meetings. But the cost of&#xA;producing code has changed. And that changes which ideas I can tackle in the&#xA;limited time I have available.&lt;/p&gt;&#xA;&lt;p&gt;With &lt;em&gt;many&lt;/em&gt; experiments, learnings, and changes to my flows over the past 6-8&#xA;months, I&amp;rsquo;ve produced more code than in the past 6 years since getting into&#xA;management. Finally a lot of the ideas I&amp;rsquo;ve had can see the light&#xA;of day as I can instead focus on the product/feature, secure deployments, smooth&#xA;DevEx, and architecture of the thing I&amp;rsquo;d like to see. And each time through this&#xA;process, whether at my computer, &lt;em&gt;or now at my phone,&lt;/em&gt; &lt;strong&gt;I find points of&#xA;friction I can smooth out so that &lt;em&gt;next time&lt;/em&gt; it&amp;rsquo;s just a bit easier.&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;the-spark&#34;&gt;The Spark&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#the-spark&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;I&amp;rsquo;d been having ongoing conversations with a family member about the impact of&#xA;AI on software engineering: what&amp;rsquo;s possible now, what&amp;rsquo;s overhyped, where it&amp;rsquo;s&#xA;actually headed. The kind of back-and-forth where you&amp;rsquo;re theorizing about the&#xA;future but don&amp;rsquo;t have a great concrete example to point at. I&amp;rsquo;d been thinking&#xA;about what simple, real app I could build to just &lt;em&gt;show&lt;/em&gt; what&amp;rsquo;s possible&#xA;instead of talking about it abstractly.&lt;/p&gt;&#xA;&lt;p&gt;Then, sitting at dinner, talking about tapping maple trees (because it&amp;rsquo;s that&#xA;time of year), the idea clicked. Last year I&amp;rsquo;d manually checked the forecast&#xA;every day, trying to figure out when the freeze-thaw cycle was right for sap&#xA;to flow. Lots of guessing, lots of doubt. Why not build something that does&#xA;that automatically?&lt;/p&gt;&#xA;&lt;p&gt;I pulled out my phone, opened the Claude iOS app, and started describing what&#xA;I wanted using &lt;a href=&#34;https://www.wispr.com/&#34;&gt;Wispr Flow&lt;/a&gt; for voice dictation. I&#xA;gave it the problem I was trying to solve, a high-level overview of my&#xA;understanding of how maple sap tapping works, and told it to do research so it&#xA;could cite its sources. Then I let it work.&lt;/p&gt;&#xA;&lt;p&gt;By the time I got home, maybe 20 minutes later, I ran &lt;code&gt;npm run dev&lt;/code&gt; and had&#xA;a working application. It detected my location, pulled a 7-day temperature&#xA;forecast, and graded each day as poor, fair, good, or excellent based on the&#xA;freeze-thaw cycle. It had information explaining how the cycle works, how the&#xA;ratings are calculated, and a full section of sources and further reading based&#xA;on the research it had done. Not a skeleton. A real app with real content.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;That was pretty eye opening. Was it perfect? Definitely not. Did I trust it&#xA;yet? Nope. Did it &amp;ldquo;work&amp;rdquo; and could I build from this? Oh yeah&amp;hellip; Let&amp;rsquo;s iterate.&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;blockquote&gt;&#xA;&lt;p&gt;&lt;strong&gt;Note:&lt;/strong&gt; This wasn&amp;rsquo;t my first attempt at building from my phone. I&amp;rsquo;d hit&#xA;some friction on a prior project that taught me a fair amount about the&#xA;workflow, like making sure your repo has a &lt;code&gt;main&lt;/code&gt; branch before Claude&#xA;tries to open PRs. I wrote up those learnings separately in &lt;a href=&#34;https://grantlucas.com/posts/2026/02/tips-for-starting-new-projects-with-claude-code-on-ios/&#34;&gt;Tips for&#xA;Starting New Projects With Claude Code on&#xA;iOS&lt;/a&gt;.&lt;/p&gt;&#xA;&lt;/blockquote&gt;&#xA;&lt;h2 id=&#34;getting-to-production&#34;&gt;Getting to Production&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#getting-to-production&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;Once I was home with the app running locally, the next step was getting it&#xA;deployed. I connected a Cloudflare Worker to my GitHub repo so that every&#xA;merge to &lt;code&gt;main&lt;/code&gt; triggers a production deploy, with preview URLs enabled for&#xA;pull requests. There were a couple of build issues to work through, and I had&#xA;Claude move the project from vanilla JavaScript to TypeScript, which is what&#xA;I would have preferred from the start. I just hadn&amp;rsquo;t caught it during that&#xA;initial phone session because everything was happening so quickly.&lt;/p&gt;&#xA;&lt;blockquote&gt;&#xA;&lt;p&gt;&lt;strong&gt;Sidenote:&lt;/strong&gt; That&amp;rsquo;s one of the trade-offs of the autonomous mode that Claude&#xA;Code on iOS runs in. It&amp;rsquo;s not asking for permission as frequently as it does&#xA;on desktop because it&amp;rsquo;s working in a sandboxed environment. The upside is&#xA;speed: it moves fast and gets a lot done. The downside is that it might make a&#xA;bunch of decisions and execute on them before you have a chance to review and&#xA;steer it in a different direction. Though once you &lt;strong&gt;do&lt;/strong&gt; steer it, it shifts&#xA;pretty easily, so I&amp;rsquo;m not sure it&amp;rsquo;s actually a drawback so much as something&#xA;to be aware of. 🤔&lt;/p&gt;&#xA;&lt;/blockquote&gt;&#xA;&lt;p&gt;I was watching the output, bouncing between the Claude app and GitHub on my&#xA;phone to see what commits were getting pushed. That back-and-forth between apps&#xA;is the closest thing to a &amp;ldquo;review loop&amp;rdquo; you get on the phone.&lt;/p&gt;&#xA;&lt;p&gt;One thing I made sure to do was have Claude create unit tests for the rating&#xA;logic. The app was &lt;em&gt;functionally&lt;/em&gt; showing me different ratings for different&#xA;days, but I wasn&amp;rsquo;t confident it was correct until I could read through test&#xA;cases. Once I could see &amp;ldquo;given this overnight low and that daytime high, the&#xA;rating should be X,&amp;rdquo; I had a lot more confidence that it would work in&#xA;reality.&lt;/p&gt;&#xA;&lt;blockquote&gt;&#xA;&lt;p&gt;Like a tale as old as time, good, clear unit tests, help enable an Agent to&#xA;prove its work and help us humans build confidence in the underlying code.&lt;/p&gt;&#xA;&lt;/blockquote&gt;&#xA;&lt;h2 id=&#34;the-iteration-loop-a-few-days-later&#34;&gt;The Iteration Loop, a Few Days Later&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#the-iteration-loop-a-few-days-later&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;A few days passed. I had more ideas. Season timing estimates based on&#xA;latitude, so if you haven&amp;rsquo;t had a good tapping window, you&amp;rsquo;d know when to&#xA;just tap anyway before you miss the season. A map showing your location.&#xA;Better error&#xA;handling if location services weren&amp;rsquo;t working. Analytics and a feedback widget&#xA;through &lt;a href=&#34;https://posthog.com/&#34;&gt;PostHog&lt;/a&gt; so I could get basic analytics and&#xA;collect feedback.&lt;/p&gt;&#xA;&lt;p&gt;By this point, the development flow was established. Here&amp;rsquo;s what the loop&#xA;looked like:&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;Open Claude on my phone&lt;/li&gt;&#xA;&lt;li&gt;Describe the change I want&lt;/li&gt;&#xA;&lt;li&gt;Claude writes the code, pushes a PR to GitHub&lt;/li&gt;&#xA;&lt;li&gt;Cloudflare builds a preview URL within seconds&lt;/li&gt;&#xA;&lt;li&gt;I review the changes in the preview on my phone&lt;/li&gt;&#xA;&lt;li&gt;If something&amp;rsquo;s off, I go back to Claude, request changes, and it pushes to&#xA;the same PR, and Cloudflare picks up the update automatically&lt;/li&gt;&#xA;&lt;li&gt;Merge the PR, Cloudflare deploys to production&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;Rinse and repeat. &lt;strong&gt;The whole thing, from idea to production, could happen in&#xA;minutes.&lt;/strong&gt; And because each change was isolated in its own PR with a preview&#xA;deployment, I could spin up multiple Claude sessions for independent changes and&#xA;review them in parallel: one adding Gitleaks scanning, another adding help docs&#xA;for location service issues, a third integrating PostHog.&lt;/p&gt;&#xA;&lt;p&gt;In this round of iteration, the &lt;em&gt;only&lt;/em&gt; thing I needed my laptop for was&#xA;setting a new secret variable in Cloudflare for the PostHog API key.&#xA;Everything else was done entirely through the feedback loop between Claude on&#xA;iOS, GitHub, and Cloudflare.&lt;/p&gt;&#xA;&lt;h2 id=&#34;what-went-well&#34;&gt;What Went Well&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#what-went-well&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;&lt;strong&gt;Voice-to-code is surprisingly effective for greenfield work.&lt;/strong&gt; Describing a&#xA;new application out loud, conversationally, maps well to how you&amp;rsquo;d explain a&#xA;feature to a colleague. I didn&amp;rsquo;t think about file structure or naming&#xA;conventions. I described the problem and the desired outcome and let Claude&#xA;sort out the implementation.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;The research was genuinely good.&lt;/strong&gt; I told Claude to research maple sap&#xA;tapping and cite its sources. The result was an app backed by real references:&#xA;academic papers, extension programs, established guides. For something I&amp;rsquo;m&#xA;still learning about myself, having that research done &lt;em&gt;and&lt;/em&gt; integrated into&#xA;the app was valuable.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;The phone-to-production cycle time was genuinely fast.&lt;/strong&gt; Once Cloudflare was&#xA;wired up, making a change and seeing it live took minutes. That&amp;rsquo;s competitive&#xA;with, or better than, a lot of traditional workflows where you&amp;rsquo;d context&#xA;switch to a terminal, run a build, push, wait for CI, and deploy. &lt;em&gt;This was&#xA;somewhat aided by Claude&amp;rsquo;s sandboxed, more autonomous mode.&lt;/em&gt;&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;PR-based workflow with preview URLs gave me confidence.&lt;/strong&gt; Every change went&#xA;through a PR. Every PR got a preview deployment behind Cloudflare Access. I&#xA;could see exactly what the change looked like in a real environment before&#xA;merging, and share preview URLs for feedback without exposing half-finished&#xA;work.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;Unit tests removed the doubt.&lt;/strong&gt; Asking Claude to write tests for the rating&#xA;logic helped the project go from &amp;ldquo;this &lt;em&gt;looks&lt;/em&gt; right&amp;rdquo; to &amp;ldquo;I&amp;rsquo;m&#xA;&lt;em&gt;pretty sure&lt;/em&gt; this &lt;em&gt;is&lt;/em&gt; right.&amp;rdquo; Being able to read through concrete test cases&#xA;grounded the whole thing.&lt;/p&gt;&#xA;&lt;h2 id=&#34;where-there-was-friction&#34;&gt;Where There Was Friction&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#where-there-was-friction&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;&lt;strong&gt;Greenfield setup from a phone has gotchas.&lt;/strong&gt; Repo creation, default&#xA;branches, missing config files. I covered these in detail in the &lt;a href=&#34;https://grantlucas.com/posts/2026/02/tips-for-starting-new-projects-with-claude-code-on-ios/&#34;&gt;companion&#xA;tips&#xA;post&lt;/a&gt;.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;The autonomous mode is a double-edged sword.&lt;/strong&gt; Claude on iOS moves fast and&#xA;doesn&amp;rsquo;t ask for permission as often. That&amp;rsquo;s great for momentum but means it&#xA;can make a batch of decisions before you&amp;rsquo;ve reviewed the first one. Bouncing&#xA;between the Claude app and GitHub to watch commits is the workaround, but it&amp;rsquo;s&#xA;not the same as the more interactive desktop experience. This is definitely a&#xA;pro &lt;em&gt;and&lt;/em&gt; a con at the same time.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;Secrets management breaks the flow.&lt;/strong&gt; Every time I needed to add a new API&#xA;key or environment variable in Cloudflare, I had to go to my laptop. This&#xA;happened for &lt;a href=&#34;https://pirateweather.net/&#34;&gt;Pirate Weather&lt;/a&gt; (a Dark Sky compatible&#xA;weather API) and again for PostHog. It&amp;rsquo;s a small interruption, but it breaks the&#xA;autonomy of the phone-based loop.&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;Infrastructure setup is still a laptop task.&lt;/strong&gt; Configuring the Cloudflare&#xA;Worker, setting up the custom domain, wiring up DNS, configuring Cloudflare&#xA;Access for preview environments. All of that was done on the laptop the first&#xA;night. It&amp;rsquo;s not a Claude Code limitation; it&amp;rsquo;s a &amp;ldquo;managing cloud&#xA;infrastructure from a phone browser&amp;rdquo; limitation.&lt;/p&gt;&#xA;&lt;h2 id=&#34;an-app-that-doesnt-really-need-to-exist-but-can&#34;&gt;An App That Doesn&amp;rsquo;t Really Need to Exist (But Can)&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#an-app-that-doesnt-really-need-to-exist-but-can&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;The result is &lt;a href=&#34;https://sapcast.ca/&#34;&gt;Sapcast&lt;/a&gt;. It takes your location, pulls&#xA;real forecast data, and tells you when conditions are right to tap your maple&#xA;trees. It rates each day, highlights the best tapping window, estimates season&#xA;timing based on your latitude, and includes educational content with cited&#xA;sources. All in a beginner-friendly way.&lt;/p&gt;&#xA;&lt;p&gt;Last year I was guessing. This year I have an app backed by research that I&#xA;can check in seconds. I&amp;rsquo;m also sharing it with other people who are into&#xA;tapping to get feedback. I&amp;rsquo;m not 100% confident in my own understanding of all&#xA;this, so getting real-world feedback matters.&lt;/p&gt;&#xA;&lt;p&gt;Does this app &lt;em&gt;need&lt;/em&gt; to exist? Honestly, no. People have been tapping maple&#xA;trees forever without issue. But a year ago, the effort-to-payoff ratio would&#xA;have killed this idea before I finished dinner. Now, the idea survived because&#xA;the cost of going from &amp;ldquo;that would be neat&amp;rdquo; to &amp;ldquo;it&amp;rsquo;s live at a URL&amp;rdquo; has&#xA;dropped to the point where three weeks of utility is &lt;em&gt;enough.&lt;/em&gt; I didn&amp;rsquo;t have&#xA;to carve out a weekend. I didn&amp;rsquo;t have to weigh it against other projects&#xA;competing for my limited free time. I described it out loud at dinner and had&#xA;something real by the time I got home.&lt;/p&gt;&#xA;&lt;p&gt;That shift, from &amp;ldquo;not worth building&amp;rdquo; to &amp;ldquo;why not,&amp;rdquo; is the thing I keep&#xA;coming back to. It&amp;rsquo;s not about this app specifically. It&amp;rsquo;s about all the&#xA;small, niche, only-useful-to-a-few-people ideas that now clear the bar.&lt;/p&gt;&#xA;&lt;h2 id=&#34;the-phone-is-just-a-litmus-test&#34;&gt;The Phone is Just a Litmus Test&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#the-phone-is-just-a-litmus-test&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;I don&amp;rsquo;t want to do all my development from my phone. That&amp;rsquo;s not the point.&lt;/p&gt;&#xA;&lt;p&gt;Building from a phone is an &lt;em&gt;extreme&lt;/em&gt; scenario, and &lt;strong&gt;extreme scenarios are&#xA;useful because they amplify every point of friction.&lt;/strong&gt; On a desktop, you can&#xA;work around a snag quickly enough that you don&amp;rsquo;t even register it as friction.&#xA;On a phone, there&amp;rsquo;s nowhere to hide. Every rough edge stops you cold. Each of&#xA;the friction points I listed above is a small inconvenience on a desktop but a&#xA;real blocker on a phone.&lt;/p&gt;&#xA;&lt;p&gt;That&amp;rsquo;s what makes it a useful experiment. If I can smooth out friction in an&#xA;environment where &lt;em&gt;any&lt;/em&gt; friction is hostile to the development flow, removing&#xA;that same friction in a more amenable environment becomes trivial.&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Template repos with sensible defaults&lt;/li&gt;&#xA;&lt;li&gt;Automated preview deployments&lt;/li&gt;&#xA;&lt;li&gt;PR-based workflows with visual review&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;All of that makes the desktop experience better too. The learnings transfer&#xA;directly.&lt;/p&gt;&#xA;&lt;p&gt;For me, this is a learning process I can apply back to my career. I&amp;rsquo;ve been&#xA;thinking a lot about developer experience and reducing the distance between&#xA;having an idea and seeing it running. The phone is just a litmus test. If&#xA;the workflow holds up there, it&amp;rsquo;ll hold up anywhere.&lt;/p&gt;&#xA;&lt;p&gt;The side benefit is that I can finally build some of the side projects I&amp;rsquo;ve&#xA;been sitting on. The cost of going from idea to working software has dropped&#xA;enough that even something useful for three weeks a year is worth doing.&#xA;And the next time someone asks me what&amp;rsquo;s &lt;em&gt;actually&lt;/em&gt; possible with AI and&#xA;software engineering, I won&amp;rsquo;t have to theorize. I&amp;rsquo;ll just show them.&lt;/p&gt;&#xA;</description>
    </item>
    <item>
      <title>Tips for Starting New Projects With Claude Code on iOS</title>
      <link>https://grantlucas.com/posts/2026/02/tips-for-starting-new-projects-with-claude-code-on-ios/</link>
      <pubDate>Wed, 18 Feb 2026 19:00:00 -0500</pubDate>
      <guid>https://grantlucas.com/posts/2026/02/tips-for-starting-new-projects-with-claude-code-on-ios/</guid>
      <description>&lt;p&gt;I&amp;rsquo;ve been experimenting with using Claude Code on iOS to build projects from&#xA;my phone. It&amp;rsquo;s been a great learning experience, and I wrote about the&#xA;broader experiment in &lt;a href=&#34;https://grantlucas.com/posts/2026/02/i-built-an-app-thats-only-useful-three-weeks-a-year/&#34;&gt;I Built an App That&amp;rsquo;s Only Useful Three Weeks a&#xA;Year&lt;/a&gt;. But&#xA;before that project went smoothly, I hit some friction that&amp;rsquo;s worth sharing&#xA;on its own.&lt;/p&gt;&#xA;&lt;p&gt;Most of these tips are specific to starting &lt;em&gt;greenfield&lt;/em&gt; projects from your&#xA;phone. If you&amp;rsquo;re making changes to an existing repo that already has the&#xA;right files in place, the experience is &lt;strong&gt;significantly smoother&lt;/strong&gt; from the&#xA;start.&lt;/p&gt;&#xA;&lt;h2 id=&#34;create-your-repo-with-a-default-readme&#34;&gt;Create Your Repo With a Default README&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#create-your-repo-with-a-default-readme&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;When you start a brand new project from your phone, you need a GitHub repo.&#xA;The GitHub iOS app doesn&amp;rsquo;t let you &lt;em&gt;create&lt;/em&gt; repos, so you&amp;rsquo;ll have to&#xA;authenticate into GitHub in the mobile browser to do it.&lt;/p&gt;&#xA;&lt;p&gt;Here&amp;rsquo;s the important part: &lt;strong&gt;have GitHub create a default README when you set&#xA;up the repo.&lt;/strong&gt; Not for the README content, but just to get a &lt;code&gt;main&lt;/code&gt; branch.&lt;/p&gt;&#xA;&lt;p&gt;Claude Code on iOS works in cloud-prefixed branches (starting with&#xA;&lt;code&gt;claude/&lt;/code&gt;). For reasonable security, it &lt;em&gt;can&amp;rsquo;t&lt;/em&gt; create or edit the &lt;code&gt;main&lt;/code&gt;&#xA;branch or any other non-&lt;code&gt;claude/&lt;/code&gt; branch. If there&amp;rsquo;s no &lt;code&gt;main&lt;/code&gt; branch when&#xA;Claude pushes its working branch, that branch &lt;em&gt;becomes&lt;/em&gt; the default branch&#xA;of your repo. There&amp;rsquo;s no easy way to create a &lt;code&gt;main&lt;/code&gt; branch from your phone&#xA;after the fact. Not from the GitHub iOS app, not from the mobile web. It&amp;rsquo;s a&#xA;mess to sort out, and Claude can&amp;rsquo;t help you fix it because of those same&#xA;branch restrictions.&lt;/p&gt;&#xA;&lt;h2 id=&#34;set-up-a-claudemd-early&#34;&gt;Set Up a CLAUDE.md Early&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#set-up-a-claudemd-early&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;A brand new repo won&amp;rsquo;t have a &lt;code&gt;CLAUDE.md&lt;/code&gt; or &lt;code&gt;AGENTS.md&lt;/code&gt; file. On desktop,&#xA;Claude Code has access to your global configuration file with your&#xA;preferences for things like commit message conventions. On iOS, it doesn&amp;rsquo;t.&#xA;So a new project has no context for how you like things done: commit style,&#xA;language preferences, TDD, commit frequency, any of it.&lt;/p&gt;&#xA;&lt;p&gt;On my first project from a phone, Claude defaulted to vanilla JavaScript when I&#xA;would have preferred TypeScript. I just didn&amp;rsquo;t catch it because everything was&#xA;moving so quickly in the autonomous mode. That&amp;rsquo;s the kind of thing a &lt;code&gt;CLAUDE.md&lt;/code&gt;&#xA;would have prevented.&lt;/p&gt;&#xA;&lt;h2 id=&#34;consider-a-template-repo&#34;&gt;Consider a Template Repo&#xA;  &lt;a class=&#34;heading-link&#34; href=&#34;#consider-a-template-repo&#34; title=&#34;Click to copy link&#34;&gt;&lt;i class=&#34;fas fa-link&#34;&gt;&lt;/i&gt;&lt;/a&gt;&#xA;&lt;/h2&gt;&#xA;&lt;p&gt;I&amp;rsquo;m pretty confident now that the right move is to set up a &lt;strong&gt;template repo&lt;/strong&gt;&#xA;with sensible defaults for phone-first development:&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;A &lt;code&gt;CLAUDE.md&lt;/code&gt; with your preferences (language, commit conventions, testing&#xA;approach)&lt;/li&gt;&#xA;&lt;li&gt;Basic &lt;a href=&#34;https://gitleaks.io/&#34;&gt;Gitleaks&lt;/a&gt; workflows for secret scanning&lt;/li&gt;&#xA;&lt;li&gt;Whatever project scaffolding makes sense for the kind of things you build&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;I haven&amp;rsquo;t built this yet, but it&amp;rsquo;s next on my list. The goal is to remove as&#xA;much of the initial setup friction as possible so that starting a new project&#xA;from my phone is as smooth as working on an existing one.&lt;/p&gt;&#xA;</description>
    </item>
  </channel>
</rss>
