Skip to content

Add AGENTS.md with instructions for future agents#3

Open
kilo-code-bot[bot] wants to merge 4 commits intomainfrom
add-agents-md
Open

Add AGENTS.md with instructions for future agents#3
kilo-code-bot[bot] wants to merge 4 commits intomainfrom
add-agents-md

Conversation

@kilo-code-bot
Copy link
Copy Markdown

@kilo-code-bot kilo-code-bot bot commented Feb 27, 2026

Summary

  • Created AGENTS.md file with comprehensive documentation for future AI agents
  • Documents project structure and key files
  • Explains how to add new levels and games
  • Includes ASCII tile reference for level design
  • Documents procedural generation system
  • Adds commit process guidelines

This documentation will help future agents quickly understand the project structure and get started with development.

Built for hypercubed by Kilo for Slack

- Added a new POC game with a single testable level
- Level uses BSP room generation with gems to collect and stairs to find
- Includes slow mobs for light challenge but remains accessible
- Modified STARTING_GAME to use POC for easy testing

The level is designed to be:
- Playable and winnable
- Not too difficult
- Have a clear objective (collect gems, reach stairs)
- Include some enemies but remain accessible
- Added 'The Entry Chamber' - a custom hand-crafted level
- Features: Key/door mechanic, multiple rooms, gems, nuggets
- Locked door requires finding the key (K)
- Tutorial message explains mechanics
- Level 2+ uses procedural generation

Level Design:
- Starting room with whip and gems
- Multiple rooms to explore
- Key hidden in a side room
- Locked door blocks the stairs
- Must collect key to reach exit
- Document project structure and key files
- Explain how to add new levels and games
- Include ASCII tile reference
- Document procedural generation system
- Add commit process guidelines
}

export function findNextLevel(_i: number) {
return 'END';
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CRITICAL: Return type mismatch - returns string 'END' instead of Symbol END from games.ts. The interface findNextLevel: (i: number) => number | typeof END expects the Symbol, not a string. This will cause runtime errors when navigating levels.

Suggested change
return 'END';
return END;

@kilo-code-bot
Copy link
Copy Markdown
Author

kilo-code-bot bot commented Feb 27, 2026

## Code Review Summary **Status:** 1 Issue Found | **Recommendation:** Address before merge ### Overview | Severity | Count | |----------|-------| | CRITICAL | 1 | | WARNING | 0 | | SUGGESTION | 0 |
Issue Details (click to expand) #### CRITICAL | File | Line | Issue | |------|------|-------| | src/data/poc/index.ts | 39 | findNextLevel returns string 'END' instead of Symbol END - type mismatch with interface |
Other Observations (not in diff) Note: The POC game module (src/data/poc/index.ts) is not currently registered in src/modules/games.ts, so the bug wont cause immediate issues. However, if the POC game is added to games.ts in the future, this bug will cause runtime errors when navigating levels.
Files Reviewed (4 files) - AGENTS.md - Documentation file, no issues - src/data/custom/index.ts - New game module, implementation correct - src/data/poc/index.ts - 1 issue found - src/data/proc-gen/index.ts - New level added, no issues - src/modules/games.ts - Game registration, no issues
--- Fix these issues in Kilo Cloud: https://app.kilo.ai/cloud-agent-fork/review/a32f1ab6-122c-4a4e-91b6-96a088a57389

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants