draugnorak/skills/nvgt-engine-dev/references/project-profile.md

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.