# Titano — working rules Read docs/BRIEF.md when in doubt; it wins over these notes. - Zero . Anything not in the .NET BCL / Microsoft shared frameworks / OS APIs is written here. - No external processes at runtime (no ffmpeg, exiftool, powershell). Only OS dialogs listed in BRIEF §8.6. - Titano.Core / Data / Protocol / Server target net10.0 and build on Linux; Windows-only code lives in *.Windows or the desktop apps. - English identifiers, comments, commits (Conventional Commits). Prototype in docs/reference is Italian: port algorithms, not language. - Every UI string is a resource (en source, it translation). Labels ≤ 3 words; explanations only in tooltips; every actionable control has a tooltip; no helper paragraphs. - Destructive operations: dry-run plan first, hash verification, explicit user action. - When the brief is silent: choose the simplest safe option, log it in docs/DECISIONS.md, continue. Ask only at phase gates or before irreversible choices. - Definition of Done per phase: green on windows-latest + ubuntu-latest, tests green, no new warnings, DECISIONS + CHANGELOG updated, i18n check green, phase report with "how to try it". - Build: dotnet build -c Release; tests: dotnet run --project tests/ -- --junit out.xml; tools: dotnet run --project src/Titano.Tools -- . - Current phase and next steps: see docs/STATUS.md (update at every gate). ## Repository specifics - Visual target: docs/ui/DESIGN.md (tokens, controls) and docs/ui/mockups/*.html. Looks: mockup wins; behaviour: brief wins. - Code conventions and module ownership: docs/ARCHITECTURE.md. - Localization: keys `Area.Group.Name` in i18n/en/.resx, Italian in i18n/it/.it.resx. C# `Loc.L("Key")`, XAML `{l:Loc Key}`. - Checks run in CI: `Titano.Tools package-guard`, `i18n check`, `xaml-lint`. - Linux builds the Windows projects for compile checking (EnableWindowsTargeting); Windows-only tests carry [WindowsOnly].