# AGENTS.md

## Project Mission

Build Steam Backlog Helper, a small cross-platform Tauri desktop app that helps Steam users with large backlogs pick a game to play now.

The MVP is a picker, not a full library manager.

## Naming

- Official app name: Steam Backlog Helper.
- Repository name: `steam-backlog-helper`.
- Package ID: `com.boris.backloghelper`.
- Internal slug: `backlog-helper`.
- Avoid putting `steam` in package IDs, bundle IDs, database names, or internal crate/package names unless an external integration specifically requires it.

## Confirmed Stack

- Tauri
- Rust
- Svelte/SvelteKit
- TypeScript
- SQLite

## Product Constraints

- Support Windows 10+, macOS 26+, and Linux AppImage.
- Keep all user data local.
- Use user-provided API keys.
- Include free-to-play games.
- Exclude demos, tools, soundtracks, and DLC from recommendations by default.
- Do not build private-profile fallback import for the MVP.
- Do not build import/export, recommendation history, accepted/rejected tracking, mood tagging, installed-game detection, or manual metadata editing for the MVP.

## Development Rules

- Prefer small, direct changes over broad refactors.
- Keep recommendation logic testable outside UI components.
- Add tests for featureful scoring, parsing, persistence, and integration code.
- Do not chase coverage on empty scaffolding.
- Use strict TypeScript.
- Keep Rust commands narrow and typed.
- Never commit real Steam, HowLongToBeat, or other provider API keys.
- Do not log secrets.
- Make setup and recommendation flows keyboard accessible.

## Documentation Rules

- Update `docs/implementation-plan.md` when milestone scope changes.
- Update `docs/architecture-decisions.md` when a meaningful technical decision changes.
- Update `SECURITY.md` when credential handling changes.

## Release Assumptions

- Gitea is the primary forge.
- Gitea runners should handle x86 builds where practical.
- arm64 builds may be produced locally.
- GitHub publication may happen later, so avoid Gitea-only assumptions in application code.