Loading image...Kiro

Product

  • About Kiro
  • IDE
  • CLI
  • Web
  • Mobile
  • Crew
  • Pricing
  • Downloads

For

  • Enterprise
  • Startups
  • Students

Community

  • Overview
  • Ambassadors
  • Discord
  • Events
  • Powers
  • Shop
  • Showcase

Resources

  • Docs
  • Blog
  • Changelog
  • FAQs
  • Report a bug
  • Suggest an idea
  • Billing support

Social

Site TermsLicenseResponsible AI PolicyLegalPrivacy PolicyCookie Preferences
Loading image...Kiro
  • CLI
  • Web
  • Enterprise
  • Pricing
  • Docs
SIGN INDOWNLOADS
Loading image...Kiro

Get Started

InstallationAuthenticationYour first project

Models

OverviewAvailable modelsReasoning effort

Features

How Kiro works
Specs
Steering
Hooks
MCP
Permissions
Custom agents
Agent Skills
Powers
Cloud sessionsCompactionKiroignoreCheckpoints and rewind
Built-in tools
Configuration scopes

IDE 1.x

What's new in 1.0
Setup & First Run
Editor
Chat
Experimental
Troubleshooting0.x reference

CLI

What's new in 3.0
Setup & First Run
Terminal UI
Chat
Voice modeHeadless modeACPAuto complete
Experimental
2.x reference

Crew

Quick startInstallationRunning 24/7
Chat
Agent Capabilities
Features
Interfaces
Apps
ConfigurationSecurityTroubleshooting

Web - Preview

Setup & First RunIdentity Center
Connect your repositories
Working with the agent
Autonomous modeAutomationsMemory
Sandbox

Mobile - Preview

Overview

Commands and Reference

CLI commandsSlash commandsBuilt-in toolsExit codesSettings

Billing

OverviewManaging your subscriptionUpgrading your planDowngrading your planCancelling your planPurchasing add-on creditsManaging your paymentsManaging usage notificationsManaging your taxesContacting billing supportDeleting your accountRelated questions

Enterprise

ConceptsOnboarding quickstart
Connecting your identity provider
Subscribe your teamManage subscriptions
Governance
Monitor and track
SettingsManaged updatesBillingIAMSupported regions

Privacy and Security

OverviewData protectionCode referencesCompliance validationInfrastructure securityIAM permissionsFirewalls, proxies, and data perimetersVPC endpoints (AWS PrivateLink)

Guides

Overview
Language support
Learn by playing
Setup dev environment and launch the game
Steering Kiro, and improving the game homepage
Fixing a subtle physics bug
Fixing an interactions bug across several files
Vibe refactoring is 50% of vibe coding
Using specifications for complex work
Managing game assets with agent hooks
Extending Kiro with MCP
Conclusion

Migration

Migrating from Q DeveloperMigrating from VSCodeUpgrading from Q CLI
  1. Docs
  2. Guides
  3. Learn by playing
  4. Fixing a subtle physics bug
View as Markdown

Investigating and fixing a subtle bug with physics

View as Markdown

This module assumes you have already launched the game locally, by following the setup instructions.

In the previous module we completed a simple task to improve the game's home page, but this was mostly just HTML and CSS task. Let's try working with some more complex JavaScript code that is part of the game engine core.

1

Understand the problem

Players of the game report that sometimes game physics go haywire and items bounce really high. One player has provided the following recording:

View transcript: Recording of the game physics bug

2

Ask Kiro to investigate

Try a prompt that describes the issue in as much detail as you can:

When something is moving or colliding, and the player tabs out then back in, the items do a tremendous bounce. Players report "items go haywire".

Kiro will start investigating project files, and will identify the cause. For example:

The problem is in the physics-system.ts file. When a user tabs out and back in, the lastTimestamp value becomes stale, and when the animation frame resumes, the calculated deltaTime can be extremely large (several seconds instead of milliseconds). This large delta is then used in physics calculations, causing objects to move much farther than they should in a single frame, resulting in the "haywire" behavior.

3

Dig deeper

Based on your initial description, Kiro probably coded a basic fix right away. However, we aren't done yet.

Try asking Kiro:

What other potential solutions or mitigations should I consider?

You may be surprised to see the AI come up with many additional potential fixes beyond what it originally implemented.

4

Explore even deeper

Now that you have the model into a specific latent space of exploring potential improvements to the game's physics system it is a great time to ask a question like:

Do you see anything else that looks like it could be improved?
Info

Large language models contain an incredible breadth of knowledge. However, they require a human to push the model a bit further to unlock the true potential. Don't stop prompting on the first answer. Ask questions like "why?", "what else?", and "what then?"

In this module we learned one key AI engineering concept:

Don't just treat AI as a task solving machine. Use the AI's depth and breadth of knowledge to explore gaps in your own knowledge.

Let's move on to the next task:

Fixing an interactions bug across several files

Page updated: August 11, 2026
Steering Kiro, and improving the game homepage
Fixing an interactions bug across several files