42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# Project Profile
|
|
|
|
Use this profile when project-specific guidance is missing.
|
|
If the repo has `AGENTS.md` or equivalent, that file overrides this profile.
|
|
|
|
## Default Engineering Style
|
|
|
|
- Prefer clean separation of concerns.
|
|
- Keep reusable logic in standalone modules.
|
|
- Keep adapters/wrappers thin and obvious.
|
|
- Favor simple, direct control flow over clever abstractions.
|
|
|
|
## Naming Defaults
|
|
|
|
- Functions/methods: `snake_case`
|
|
- Variables: `camelCase`
|
|
- Classes/types: `PascalCase`
|
|
|
|
## Accessibility Defaults
|
|
|
|
- Prefer NVGT accessibility APIs and native screen-reader paths.
|
|
- Avoid unnecessary visual-only coupling in interaction flows.
|
|
- Ensure keyboard navigation is complete and trap-free.
|
|
|
|
## Audio/UI Defaults
|
|
|
|
- Use stable folder conventions for project-owned assets.
|
|
- Keep menu and notification sounds configurable by path.
|
|
- Support `.ogg` first and allow `.wav` fallback where practical.
|
|
|
|
## Refactor Rules
|
|
|
|
- Extract only behavior used across multiple modules/projects.
|
|
- Do not extract heavily game-loop-specific orchestration.
|
|
- Preserve behavior first; optimize structure second.
|
|
|
|
## Delivery Expectations
|
|
|
|
- Provide concise decisions with concrete file references.
|
|
- Explicitly state assumptions when source evidence is incomplete.
|
|
- Prefer incremental, verifiable changes over large rewrites.
|