From 8a752c98c72235677e06f17be2f7a22776c0f74e Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 15 May 2026 22:20:28 +0000 Subject: docs(agent): record user context, storage resilience, and logging preferences https://claude.ai/code/session_01DNjbYxiC1cco83dArNGW3G --- .agent/preferences.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to '.agent') diff --git a/.agent/preferences.md b/.agent/preferences.md index 6d1c4bb..c0c76da 100644 --- a/.agent/preferences.md +++ b/.agent/preferences.md @@ -6,6 +6,12 @@ Living record of user preferences for the Nav project. - **Safety First:** Cautious and deliberate action. - **Checkpoint Model:** Research -> Strategy -> GO. +## 3. User Context +- **Solo developer who is also the sole user.** The user is both the target audience and the developer. Optimize for their experience as a sailor, not for a hypothetical general public. +- **Reinstall resilience is non-negotiable.** All persistent data (tracks, settings) must survive app uninstall/reinstall. Never use `getExternalFilesDir()` or other app-private storage for user data. +- **Pragmatic about implementation quality.** One-off solutions and temporary hacks are acceptable — just flag them clearly and ensure they get cleaned up in a follow-up. +- **Debug logging:** The in-app debug log (`NavLogger`) is the primary debugging tool. ADB (`adb logcat`) is occasionally available but should not be assumed. Log anything useful to `NavLogger`, not just to Android's `Log`. + ## 2. Repository Conventions — NON-NEGOTIABLE - **Default branch is `main`.** Always has been, always will be. - When the user says "main", "master", or "the default branch" they all mean `main`. -- cgit v1.2.3