Files
Chronos/CLAUDE.md
T
Claude 83a54fb57b chore: bootstrap repository foundation
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
2026-10-02 08:59:40 +00:00

1.9 KiB

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].