A structured workflow protocol for AI-augmented software development — separating Design AI (architecture & planning) from Implementation AI (coding & execution), with the human as the bridge.
Born from real project failures and refined through building Bridgiron and ExitWatcher (an Android app built in 4 days with zero Android experience).
This repository releases protocol components alongside a dev.to article series. Each article ships a usable piece of the protocol.
| Component | Description | Status |
|---|---|---|
| Vol.1 Generator | Interview prompt that creates your personal AI collaboration profile | ✅ Available |
| Vol.2-3 Quickstart | Minimal workflow definition to get started | 🔜 Coming (Article 3) |
| Vol.4 Example | Project handover template with implementation skeleton | 🔜 Coming (Article 4) |
| Full Package | Complete protocol bundle | 🔜 Coming (Article 5) |
The most impactful single piece of the protocol. A profile document that tells any AI who you are, how you think, and how to collaborate with you.
- Download
vol1-generator/vol1_generator_prompt.md - Open a new chat in your preferred AI (Claude, ChatGPT, Gemini, etc.)
- Type the following message and attach the downloaded file:
Follow the instructions in the attached file and begin the interview.
- Answer the AI's questions (about 10 minutes). Voice input strongly recommended — you'll get a richer, more natural profile.
- When the interview is complete, the AI outputs your personal profile as Markdown.
- Save the output as a
.mdfile (e.g.,HandOver_Vol.1_YourName_Profile_r1_gen.md)
When typing, people unconsciously compress their thoughts — stripping away context, habits, and nuances that are critical for good AI collaboration. Voice input removes that friction. Ramble freely. The AI will organize everything.
- A web browser (Chrome, etc.)
- Any chat AI that accepts file attachments (Claude.ai, ChatGPT, Gemini, etc.)
- Desktop or mobile
Your profile isn't a one-time thing. After completing a project with AI, ask your Design AI: "Based on our work together, what should I add to my profile?" The AI has observed your thinking patterns and decision-making habits. Feed that back into your profile, and it gets sharper with every project.
| # | Title | Link |
|---|---|---|
| 1 | I Built an Android App in 4 Days With Zero Android Experience | dev.to |
| 2 | The Protocol Was Born from Wreckage | Coming soon |
| 3 | Bridgiron — The Tool Behind the Protocol | Planned |
| 4 | Why V-Model Thinking Works for AI Development | Planned |
| 5 | Four Weeks of AI-Augmented Development | Planned |
Created by Raio — a control systems engineer with 15 years in motorcycle ECU development, currently exploring AI-augmented development workflows.
MIT