MyJackfruit

Help
Browse topics · Development

Development

← Back to My app shows an error. What do I do?

How do I tell my AI about a fault so it can fix it?

Short answer

In the same chat, say what you did, what you expected, what happened instead, and the exact words of any message on the screen.

Deeper

Also asked:

How do I tell my AI about a fault I found? Tell it in plain words, in the same chat: what you did, what you expected, what happened instead, and the exact words of any message on the screen.

How do I describe a problem so my AI can fix it? Say where it happened and what you clicked or typed, what you expected, what happened instead, the exact words of any message, whether it happens every time, and which computer and browser you used.

A fault, often called a bug, is anything in your app that does not do what it should. Tell it to your AI in plain words, where you talk to it: in the terminal, the window where you type commands, where Claude Code or Codex runs, or in GilbApp's chat if your AI works there. You do not need technical words.

A good fault report says:
Where it happened: which screen or page, and what you clicked or typed, step by step.
What you expected to happen.
What happened instead.
The exact words of any message on the screen, typed or copied as shown.
Whether it happens every time, and whether it worked before.
Which computer or phone and which browser you used, and, if your app signs people in, which account you were signed in with.

For example: On the order page I typed 3 in the amount and pressed the save button. I expected the total to show 30. It shows 0, and a red line under the button says the order could not be saved. It worked yesterday.

What your AI does with it. Agent.Coder, the agent that writes your app's code, works on the fault; its written procedure has each piece of work tested before it hands it back, by Agent.Tester, the agent that tests what others built, or, if it cannot start one, by itself, marked self-QA. An agent is your AI following one written procedure, its standing instructions, for one kind of work. Agent.Coder's instructions say to read the browser's error messages, the page and what it sent and received itself, with its browser tools, and not to ask you to copy them from the browser; it asks only if no tool works. On a FAIL it fixes and tests again, and it stops after three different failures it cannot fix without more scope or your input, and tells you what failed and what it tried.

Once a change is live, Kai-Zen, the planning agent, asks you to check it live. What you send back then is fixed and put live again with your yes, and you are asked again, until you approve.

A fault or a change? If the app does what was agreed but you want it different, that is a change to the product. Say so: Kai-Zen asks its questions in one round, asks for your go once, and has only that change built. The answer How do I change the product while a project runs? shows how.

If your AI keeps making the same mistake, or does not understand you, see My AI does not do what I ask. What now? If the fault seems to be in GilbPlatform or GilbApp rather than in your app, write to [email protected]: what you did, what happened, and at what time.

This answer is written for a computer screen.

Source: Standards read from GilbPlatform on 13 November 2026: Agent.Coder (Browser: "use your runtime's browser tools to read console messages, the rendered page and network requests ... Do not ask the requester to copy from the browser. Ask only if no tool works"; AfterIncrement: Agent.Tester, "On FAIL: fix what the report lists and test again ... Stop after three distinct failures ... Report each attempt: what failed and what you tried."), Kai-Zen.HumanCheck (Ask; Fix: Fix what they send back, put it live again, and ask again, until they approve.), Kai-Zen.GoLive, Kai-Zen.Update (Shape: one round of questions; Go: Ask the requester for go once; Build: Build only this change). GilbApp 49b1ae53 (https://gilb.com/app/version.json, read 13 November 2026): src/components/agent/AgentChat.tsx (the chat; with Claude Code connected it can code in a chosen folder, changes/gilbapp/546-code-in-a-folder.md). Live help pages, sentences shared: How do I change the product while a project runs?; My AI does not do what I ask. What now? (write to [email protected]: what you asked, what the AI did, and at what time); How do I build an app with an AI coder?

Checked against GilbApp d529620.