Algoritmi AI SandboxPractice environment with sample data. Nothing here reaches the production platform.

What to Ask, by Symptom

Common problems and the request to send Claude for each, grouped by symptom.

Replace the parts in 【 】 before you send a request. The basics of reporting a problem are in When Something Goes Wrong.

When you report a bug found in production in a new conversation, add this sentence to the end of the request.

To fix it, create a new branch from main, confirm that the build passes, then create a pull request to main and give me the PR URL.

A blank screen or an error

If a message is shown on screen, paste all of it exactly as shown. If there is no message, paste a screenshot.

Blank screen or error
Claude prompt
A screen in 【app name】 is not displayed correctly. Find the cause, explain it without technical terms, and fix it. Where: 【Example: the lost items list, in production】 What I did: 【Example: opened the list】 What happened: 【Example: the screen went completely white】 Message shown on screen: 【Paste it exactly as shown】

A broken layout

Text overlaps, a button runs off the edge, or the screen is hard to use on a phone. A screenshot makes this exact.

Broken layout
Claude prompt
The layout of 【app name】 is broken. Please fix it. On which screen: 【Example: the lost items list】 Viewed on: 【Example: a phone】 What it looks like: 【Example: the rightmost column runs off the screen and cannot be seen】 What I expect: 【Example: on a phone, show one item per row, stacked vertically】

Wrong totals, order, or dates

No error appears, but the result is wrong. Write the actual numbers and dates.

Wrong result
Claude prompt
A result in 【app name】 is wrong. Find the cause and fix it. On which screen: 【Example: the monthly totals screen】 What I entered: 【Example: registered five lost items in March】 What was shown: 【Example: the count for March showed 4】 The correct result: 【Example: it should show 5】

Data that should be there is missing

Missing data
Claude prompt
Data that should be there is not shown in 【app name】. Find the cause and fix it. Where: 【Example: the lost items list, in production】 The data that should be there: 【Example: the three items registered this morning】 What is shown: 【Example: the list is empty, and there is no error message】
If production data may have been lost

If data you registered seems to have disappeared from production or to have been changed, tell an administrator before you ask Claude.

It breaks under unusual use

It breaks when someone saves with nothing entered, enters a very long text, or presses a button twice in a row. You can also have Claude inspect a screen before anything breaks.

Ask Claude to guard against unusual use
Claude prompt
Inspect 【screen name】 in 【app name】 and make sure none of the following causes a problem. Before fixing anything, list the problems you find and explain them. 1. Saving with nothing entered 2. Entering a very long text 3. Pressing the Save button twice in a row 4. Opening the screen when there is no data at all

A check on the PR is red

Ask in the same conversation that created the PR. Claude can look up what failed by itself.

When a check fails
Claude prompt
A check on the PR has failed. Find out what failed, explain the cause without technical terms, and fix it. Add the fix to the same PR.
If the explanation mentions a "migration"

The failure is in a change to the database structure. Before having Claude fix it, give an administrator the PR URL and Claude's explanation, and agree on how to proceed.

Claude cannot open the screen

What happensWhat to do
The first time, it takes a few minutesA trial database is being fetched. Just wait. From the second time on it opens in seconds
Claude says it "cannot start" or "cannot open" the appIn the same conversation, send "Find out why it does not open locally, and fix it"
The screen opens, but the data shown is all dated long agoSend "Please recreate the test data"
A screen for email or files says "not set up"This is not a bug. Features that use outside services are checked in a preview (Check the Screen)

The preview will not open

What you seeWhat to do
The comment says "No preview environment was made."A preview is made only when you ask. In the same conversation, send Claude "Please create a preview"
It still says "The preview environment is being made" after more than 30 minutesSend Claude "The preview is not finishing. Find out why"
"deploy unsuccessful"Send Claude "The preview deploy failed. Find the cause and fix it"
"deployed, but the URL did not answer yet"Wait a few minutes and open it again. If it continues, tell an administrator
"Access denied"Ask an administrator to let you open the app
You cannot sign inAsk an administrator to let you sign in to previews as well

An error in production

You can hand the production app's records, its logs, to Claude from the App Portal.

  1. Open the App Portal and press "Logs" on the app's card.
  2. Choose the "Errors" tab.
  3. Press "Copy for Claude Code".
  4. Paste it as it is into a new Claude Code conversation with the algoritmi-sandbox-vibe-coding-platform folder selected, and send it.

The copied text already contains the request to Claude and clues for the investigation, so you do not need to add anything.

If "Logs" is not shown

"Logs" is shown only to people who are allowed to see logs. If you do not see it, tell an administrator when it happened, on which screen, and what you did.

You want to undo a change after merging

You can take a merged change back out of production. Undoing follows the same flow: a PR, then a merge.

Undo a merged change
Claude prompt
I want to take the change in 【PR URL】 back out of production. Create a PR that reverts the change made by that PR. Why I want to undo it: 【Example: the list no longer appears】 If it includes a change to the database structure, tell me before you start. Finally, confirm that the build passes, create a pull request to main, and give me the PR URL.
If it is urgent or involves data

If colleagues cannot work, or if data is involved, tell an administrator at the same time as you ask for the undo.

Claude says Git has no name or email address set

The first time a change is recorded, Claude's work can stop because Git has no name and email address set. If Claude asks for a name or an address, you do not need to answer yourself. Send this request in the same conversation.

Have Claude set the Git name and email address
Claude prompt
Set the name and email address that Git uses for commits. Do not ask me. Decide them from the account that is logged in to GitHub now. 1. Use the name on the GitHub profile, or the username if there is none 2. For the email address, use the private address GitHub provides ([email protected]) 3. Apply the setting to this whole computer 4. Do not change anything that is already set When it is set, continue the work that had stopped.

This setting is needed only once per computer.

Claude says it has no permission or needs to log in

The login to GitHub may have expired.

Check the GitHub login
Claude prompt
Check whether I am still logged in to GitHub. If the login has expired, help me log in again.

If Claude says the same thing after you log in again, ask an administrator whether you have permission to use the repository.

Quiz

Quiz

A colleague says that pressing Save in a production app causes an error. The App Portal shows a 'Logs' button for the app. What do you do first?