FlowForge Manual
CHAPTER 01 ENNever Alone — What FlowForge Is
The soul of FlowForge — the craft of software, the human-and-AI partnership named ACE, freedom, and why getting paid is a receipt, not the point.
Never Alone
Start here, because everything about FlowForge starts here.
Never Alone is the promise. FlowForge is not, at its heart, a way to get paid — it is the perfect marriage of a human and an AI, each in their own lane, building software together with mastery. Getting paid is real, and this manual gives it a whole chapter. But it is a feature, not the reason. The reason is the craft.
In one sentence: FlowForge pairs you with a tireless, disciplined partner so that fast, AI-assisted work stays honest, masterful, and yours — and so that you never build alone.
The gist is the craft, not the money
FlowForge was built by someone who has spent thirty-seven years in love with the craft of making software: the first line of BASIC typed into a PC-500 in 1984, at nine years old; then IBM; then a run from zero to a hundred and fifty million alongside a mentor, Flávio, as employees; then a company of his own. Through all of it the through-line was never the paycheck. It was the pull of building something correct — something that lasts, that you would sign your name to.
FlowForge is that founder’s legacy, distilled: what happens when the obsession with doing software right is finally handed a partner that never tires. It is the science of that partnership, shipped as a product.
Meet ACE — the Controller
You are never working alone, because you are working with ACE.
ACE is the controller — the session you talk to, with the street name The Controller. Sometimes ACE flies the plane and you supervise; sometimes you fly and ACE is the co-pilot who never blinks. Throughout this manual, when “the controller” decides, dispatches a specialist, spins up a worker, or relays a review back to you — that is ACE. ACE is the personification of the Never Alone promise, and this manual names it on purpose.
Human and AI, each in their own lane — that is the whole design. You bring intent, taste, and the final call. ACE brings tireless execution, memory that outlasts any chat window, and a bench of specialists to dispatch. Neither replaces the other; that is exactly when both thrive. (Chapter 6 shows the machinery: how ACE orchestrates specialist agents and isolated workers, and where you stay in the loop.)
Do it right, do it once
“Feito é melhor que perfeito” — done is better than perfect — is the comfortable lie of a tired industry. The obsessed few always knew it was false: they did it right, and they did it once, and they slept fine. The catch was that obsession did not scale — most people, most days, simply could not afford it.
That is what changes now. With AI, every developer gets to be that developer. A junior can do-it-right-do-it-once: hunt down every last saci-pererê hiding in the code, hold the line on tests and structure, and ship work that does not come back to haunt them. FlowForge is built to make that the path of least resistance, not a heroic exception.
Freedom: your software, yours
For about twenty-two dollars a month, a layperson can own their software. The baker gets the system his bakery actually needs, not the one a vendor decided to sell him. The painter gets a site that takes credit cards, built by his wife. The point is ownership — software shaped to a real life by the person living it.
This is old lineage delivered a new way: free as in freedom (Stallman, Mad Dog and the movement that insisted software should belong to its users), now made reachable by a partner that writes the code with you. FlowForge is the twisted-modern continuation of that idea — freedom you can actually exercise.
Getting paid — a receipt, not a rallying cry
Now the money, in its proper place. FlowForge tracks time not to nag you, but to hand you a receipt: a proof of work, honest to both parties at once. It kills “trust me, I’m a good guy” by replacing it with a record — here is what was done, and for how long. That is one real pain, well solved, and it is a strong feature of the product. It is simply not the headline. (Chapter 8 is where the receipt pays off: reports, team billing, and turning tracked hours into something you can hand a client.)
What you’ll find in this manual
- Getting Started — install FlowForge and run your first tracked session.
- The Session Discipline — the ticket + timer + branch loop, and why it’s the point.
- The Rules — the small set of universal rules that keep work honest.
- Blueprint-First Development — how a plain-language idea becomes ratified, attached tickets.
- The Controller & the Workers — how ACE orchestrates specialist AI agents.
- ForgePlay & the Cockpit — the terminal cockpit and its guided plays.
- Time, Billing & Proof of Work — turning tracked hours into reports and pay.
Why it matters
FlowForge exists so that fast, AI-assisted development stays honest, measurable, and yours — and so that you never build alone. Make the right way the easy way, hand the craft a partner that never tires, and keep an honest receipt for the hours. Everything that follows serves that. Never Alone.
⚑ FOUNDER REVIEW — draft, not final until approved
Where “it was never about the money” comes from.
In 2010–11 the founder built Cartas da Esperança, an iOS card game for children in cancer treatment at the Hospital de Câncer de Barretos. Each card was drawn by a child; the reverse taught that child’s own disease. Every parent’s approval was gathered with lawyers; the work took months of visits; and every cent the App Store paid went to the hospital.
There were two lists on the wall. One was the new children arriving. The other was the children from the project who were no longer there.
Software was never about the money. It never was. That is the ground the rest of this philosophy stands on — and it stays behind this banner until the founder decides how, and whether, to tell it here.