Observe ZDNET: Add us as a most popular supply on Google.
ZDNET’s key takeaways
- Deal with the AI like one other developer, not a magic field.
- Encode design programs and person profiles in system prompts.
- Each fastened bug turns into a everlasting lesson discovered within the mission’s DNA.
Ever for the reason that days of punched playing cards, I’ve self-identified as a programmer and a pc scientist. The programmer facet is the sensible facet of my engineering id, the one that crafts code line by line. The pc scientist is the theoretician, the scientist, the strategist, and the planner.
Whereas I really like the speculation and science of computer systems, I’ve at all times loved the hands-on feeling of reducing code. I believe it is in all probability akin to how some woodworkers want hand instruments over energy instruments for the visceral really feel of working with wooden.
Additionally: Is Perplexity’s new Laptop a safer model of OpenClaw? The way it works
Sadly, I’ve by no means had a lot time to code. My day-to-day job has been as an organization govt, founder, educator, and author. I do love making software program merchandise, however I’ve by no means managed to get a couple of small product executed every year, utilizing little bits of obtainable nights and weekend time.
All that modified this previous September. That is after I began utilizing agentic vibe coding instruments, equivalent to OpenAI’s Codex and Claude Code.
Since September, I’ve constructed and shipped 4 main merchandise (WordPress safety add-ons), constructed a working iPhone app for managing 3D printer filament, and am near having a beta of an app my spouse requested for managing stitching patterns. These final two are being constructed concurrently for iPhone, iPad, Apple Watch, and Mac.
As a sole coder, agentic AI has been a drive multiplier of just about breathtaking functionality.
Additionally: I received 4 years of product growth executed in 4 days for $200, and I am nonetheless surprised
On this article, I will take you thru seven greatest practices I take advantage of. These practices assist me work with AI as a companion, and generate merchandise of a top quality appropriate for manufacturing use. On the finish, I am going to additionally share a bonus greatest follow that is useful extra usually than you may count on.
That is vibe coding. However it’s vibe coding with engineering self-discipline, and an underlying framework designed for robustness and product high quality. If you wish to use AI to construct your apps, observe these greatest practices.
Main follow: Written directions
The objects listed under are particular, deliberate practices. Every one comes from one thing I purposely constructed into my workflow.
The way in which I make these practices stick is I’ve added them to the “ini” recordsdata for the AIs, the CLAUDE.MD and AGENTS.MD recordsdata. I’ve additionally added different recordsdata used to doc the mission itself. I am going to describe these in additional depth as you learn the remainder of this text.
Additionally: 10 ChatGPT Codex secrets and techniques I solely discovered after 60 hours of pair programming with it
Let’s begin with my first greatest follow, codified when I discovered that agent habits in Xcode was unreliable for a number of parallel processes.
Undoubtedly preserve studying till the tip, as a result of the aforementioned bonus greatest follow is usually a actual game-changer.
1. Sequential visibility over parallel pace
The AI firms are touting the brand new capability to run a number of brokers in parallel. Nonetheless, it’s totally tough to handle a number of brokers operating in parallel, particularly when you may’t see what they’re all doing.
Worse, I discovered that this method causes crashes and hangs, leaving initiatives in limbo. Till this turns into a manageable and visual method, I solely wish to run one agent at a time.
Additionally: 10 issues I want I knew earlier than trusting Claude Code to construct my iPhone app
Manageability should take priority over pace, particularly when the AIs disguise a lot extra of what you’d usually see line by line in case you have been coding all of it your self.
My rule: “Do NOT use background brokers or background duties. Do NOT cut up into a number of brokers. Course of recordsdata ONE AT A TIME, sequentially. Replace the person frequently on every step.” On this rule, “the person” is me, because it’s an instruction to the AI about its personal utilization.
Why it is elite: I discovered this the exhausting approach. Claude appeared to love launching parallel brokers in Xcode. However after a couple of instances when a number of parallel brokers received caught, grew to become unresponsive, needed to be killed, and left the codebase adjustments half-finished and in an indeterminant state, I received fed up.
The precept: I selected slower however seen over quicker however opaque. Sure, I am going to admit that ready for the AI can get tedious. However I am going to take predictability and recoverability over rash pace each time.
2. Migration monitoring as a first-class artifact
My two Apple initiatives are being constructed for 4 platforms every: Mac, iPhone, Watch, and iPad. The capabilities and interfaces of those gadgets are fairly completely different, particularly for my apps that depend on NFC (obtainable solely on the iPhone) and different options which can be most applicable for various platforms.
For instance, within the stitching sample app, there is a very highly effective AI part for scanning and categorizing PDFs imported from the Mac’s file system, which is a workflow much less doubtless for use on an iPhone.
Additionally: AI brokers are quick, free, and uncontrolled, MIT research finds
The problem right here is that after I’m engaged on one platform, I do not wish to lose observe of adjustments for the others. So I’ve particulars about migrating platform-wide adjustments. These particulars are particularly encoded as an artifact that may be noticed, tracked, and referenced.
My rule: “Each time you make a change to an app that might additionally have to be utilized to iOS, iPad, Mac, or Watch apps, log it in Docs/IOS_CHANGES_FOR_MIGRATION.md. Embrace: date, recordsdata modified, which platforms it applies to, what particularly modified (previous to new values, code snippets if useful), any notes about platform-specific diversifications accomplished and/or wanted.”
Why it is elite: I do not belief myself (or the AI) to recollect adjustments throughout periods. Inside the AI, I constructed a structured change log that acts as a migration guidelines for bringing different platforms to parity. I take advantage of it as an operational device to forestall drift between platforms.
The precept: Each change generates a technical debt ticket for each platform it hasn’t reached but.
3. Persistent reminiscence with semantic group
Each the AI and I be taught tons when constructing these apps. Some strategies we attempt fail, and others change into greatest practices. As a part of the method, I’ve the AI construct a information base that’s full of these learnings. For higher classification and simpler entry, I’ve the AI set up the information base by matter reasonably than notes added to the underside of a log.
My rule: I’ve the AI preserve a MEMORY.md that persists throughout conversations, organized by matter (not chronologically), with separate matter recordsdata for detailed notes. I gave the AI this instruction: “Replace or take away recollections that turn into mistaken or outdated. Don’t write duplicate recollections.”
Why it is elite: AI periods are stateless by default, however I needed to retain state info. Simply dumping every little thing right into a log file would have been messy and inefficient. As an alternative, I had the AI construct and preserve a curated information base that the AI reads on startup. The information base has API signatures, scoring algorithms, structure measurements, and hard-won classes (tangible examples the place it took us some time to determine how one can make one thing work).
The precept: These classes and learnings may be utilized additional down the event path, or to sister initiatives that use the identical foundational construction. Do not reinvent the wheel.
4. Immediate logging as an audit path
In contrast, I additionally need the AI to log each instruction I give it chronologically. This method is a good way to reference what was labored on beforehand, particularly after I may not return to the mission for days and even weeks.
Additionally: From Clawdbot to OpenClaw: This viral AI agent is evolving quick – and it is nightmare gas for safety professionals
Moreover, this method permits us to return and see whether or not my immediate was insufficient or deceptive, or if another prompt-related issue might have brought about a fail or turned out to be a powerful win.
My rule: “Each session, after studying these directions, log every person immediate to PROMPT_LOG.md. Timestamp every entry with date and time.”
Why it is elite: This method offers me (and the AI) an entire, timestamped document of each instruction I’ve ever given the AI throughout all periods. This serves a number of functions:
- I can reconstruct what occurred when one thing goes mistaken.
- I can see how a function developed by prompts.
- The AI and I can decide up precisely the place we left off.
It is model management for my collaboration with the AI.
The precept: If we won’t replay the dialog, we won’t debug the collaboration. Extra to the purpose, the method permits each of us (the AI and me) to return to reference particular directions, replay sure actions, and proper points which will have come out of unclear or incorrect prompting.
5. Person profile as a design constraint
My two Apple apps use comparable options, however have radically completely different person profiles. The filament stock mission is supposed for technically robust people managing a pretty big set of 3D printers and filament varieties.
Additionally: I constructed an iOS app in simply two days with simply my voice – and it was electrifying
Then again, the stitching sample stock mission is meant for energetic sewists with a group of tons of and even hundreds of stitching patterns. Sewists are technically succesful with specialised stitching equipment, however they have an inclination to want extra intuitive app interfaces than the 3D printer geeks. They’re usually extraordinarily fussy in regards to the high quality of their collections and their info.
As a result of I usually flip to the AI for assist with design and implementation, I discover it advantageous for the AI to know the person profiles. When the AI does one thing completely different from what a typical person could be comfy with, I inform it, “remind me what the person profile is for the app.” This method forces the AI to do not forget that information and restate it to me. In doing so, the AI instantly updates its work whereas specializing in these necessities and constraints.
My rule: “My stitching sample stock customers are predominantly over 50. Many are grandparents. They usually have restricted technical abilities. They have an inclination to have massive collections with a powerful ‘received to maintain it’ collector mentality.”
I didn’t go into the nuances of the several types of machines these customers know, however saved it easy as a guise for the AI. The technical complexity of what sewists can produce is commonly astounding. And critically, the distinction: “The stitching app must be noticeably extra approachable than the filament app.” Sure, it is stereotypical. However stereotypical works fairly effectively with the AI’s coaching corpus. It will get the job executed.
Why it is elite: Since I used to be counting on the AI for design assist, I needed to offer it a psychological mannequin of the particular human utilizing the app. That person profile included age, technical consolation, and collector psychology, as a result of these components affect design selections. When the AI makes a design advice, it has a profile for the particular person the product is designed for. This setup echoes my general collaboration method — consider AI as simply one other developer on the opposite finish of a Slack channel.
The precept: Telling the AI who makes use of the software program helps it perceive how one can construct the software program.
6. Codified design system within the mission immediate file
As a former inventive director and designer, I understand how essential it’s to create a design language for an organization or a product. Whereas it’d look like Apple apps have their very own design language by advantage of being on Apple platforms, there’s nonetheless a lot of room for inconsistency.
Additionally: AI brokers are already inflicting disasters – and this hidden menace might derail your protected rollout
To mitigate this risk, I’ve encoded the design language for the initiatives proper in the principle mission instruction file, so the AI can at all times reference it when constructing out designs. This method supplies us with a really constant, enticing, and comprehensible interface that works with each replace or change throughout growth.
My rule: I embedded a complete iOS and macOS design system instantly within the CLAUDE.md predominant mission immediate file. These particulars embody particular font sizes (24pt daring for sheet titles, 15pt medium for record objects), actual shade RGB values, part patterns (card construction, icon badge sizing, button types), and named reference implementations.
Why it is elite: Each new view the AI creates routinely matches the prevailing ones as a result of the design tokens are within the system immediate and instantly obtainable to the AI. I haven’t got to inform it, “make it seem like the opposite views,” and hope the AI can determine what “the opposite views” seem like. The reference information means the AI has an in depth design language for all UI components.
The precept: Design consistency should not depend upon the AI’s reminiscence of what it constructed final time, or on its capability to derive design cues from earlier implementation code.
7. Arduous-won classes encoded as guidelines
There are numerous, some ways for software program to fail. One of many gotchas about coding for Apple is that you just generally must go exterior its canned interfaces and options. For those who do this (and even generally while you code on to its design), stuff breaks.
Additionally: True agentic AI is years away – here is why and the way we get there
Fairly than re-debug every little thing every time round, I’ve the AI encode classes discovered, particularly after a protracted session of attempting to determine what broke. This manner, we will make it work once more later. This method is especially highly effective if the AI decides to scrap a block of code and recreate it. With classes encoded as guidelines, the AI is aware of what to not do.
My rule: Scattered all through my AI instruction recordsdata are classes from issues that went mistaken, encoded as everlasting guidelines. On the finish of each session, I inform the AI to document its learnings. The result’s a sequence of reusable directions primarily based on our growth experiences.
Listed here are some examples.
- “By no means stack greater than 4 .sheet() modifiers on the identical view on macOS.” We discovered this when a PDF picker silently failed because the seventh stacked sheet.
- “NSOpenPanel.runModal() should not be referred to as from inside a sheet’s onAppear.” We discovered this from a crash.
- “NEVER use .secondary, .grey, or low-opacity white for textual content” on watchOS. Instructed the AI primarily based on OLED readability testing.
- “Navigation titles use system styling (grey) to protect again button performance.” Realized and instructed, when customized toolbar objects hid the again button.
Why it is elite: Many builders repair a bug and transfer on. My method is that after we repair a bug, we write it into the mission DNA as a lesson. Bug fixes change into pointers and restraints that the AI should observe for the lifetime of the mission. That approach, future periods do not expertise the identical issues. These solved issues change into encoded as growth guardrails.
The precept: Each AI mistake ought to solely occur as soon as, as a result of avoiding it turns into a guardrail rule.
Bonus greatest follow: Code evaluation
These seven greatest practices kind a system. The AI begins every session studying its reminiscence, its design system, its guidelines, and brings itself up to the mark on the migration tracker information and the learnings we rigorously encoded. The AI logs each immediate. It really works visibly, so it is not getting caught with a number of parallel brokers operating amok. It additionally is aware of how one can design for an actual particular person, encoded within the person profile.
Successfully, this method goes past the thought of vibe coding, the place you say stuff, and the AI makes what it needs. This method is a rigorously designed and engineered collaboration engine extra akin to conventional software program engineering administration practices.
Talking of software program engineering administration practices, here is a bonus: use the AI for code evaluation.
Additionally: 5 customized ChatGPT directions I take advantage of to get higher AI outcomes – quicker
Sometimes, I begin up a brand new session. However earlier than the AI reads all of the directions and notes, I inform it to research the mission and all its recordsdata. I ask it to flag points and issues. That approach, I get the equal of “recent eyes.” The AI usually finds little particulars that have to be addressed.
Highly effective. Straightforward to do. Enormously efficient. What’s to not love?
Have you ever adopted any structured practices when working with AI coding instruments, or are you continue to in full vibe-coding mode?
Do you run a number of brokers in parallel, or have you ever discovered that slower, extra seen workflows produce higher outcomes? Have you ever constructed persistent reminiscence recordsdata, migration logs, or immediate audit trails into your initiatives? If that’s the case, how has that modified your output high quality?
What about design constraints and person profiles? Are you explicitly educating your AI who it is constructing for? I might love to listen to the way you’re collaborating with AI, what’s labored, what’s backfired, and whether or not you suppose disciplined AI workflows actually do separate informal customers from elite builders. Remark under.
You’ll be able to observe my day-to-day mission updates on social media. You should definitely subscribe to my weekly replace e-newsletter, and observe me on Twitter/X at @DavidGewirtz, on Fb at Fb.com/DavidGewirtz, on Instagram at Instagram.com/DavidGewirtz, on Bluesky at @DavidGewirtz.com, and on YouTube at YouTube.com/DavidGewirtzTV.
Elevate your perspective with NextTech Information, the place innovation meets perception.
Uncover the newest breakthroughs, get unique updates, and join with a world community of future-focused thinkers.
Unlock tomorrow’s tendencies immediately: learn extra, subscribe to our e-newsletter, and change into a part of the NextTech neighborhood at NextTech-news.com

