Solution layout, build rules with zero-package guard, in-house test framework, localization runtime, brand mark rasteriser with ICO/PNG generation, Core contracts (imaging, video, domain model, TIFF reader), Titano.Tools (make-icon, i18n, xaml-lint, package-guard) and docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
20 lines
1.9 KiB
Markdown
20 lines
1.9 KiB
Markdown
# Titano — working rules
|
|
Read docs/BRIEF.md when in doubt; it wins over these notes.
|
|
- Zero <PackageReference>. 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/<X> -- --junit out.xml; tools: dotnet run --project src/Titano.Tools -- <command>.
|
|
- 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/<Area>.resx, Italian in i18n/it/<Area>.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].
|