From ca2415c6818dd236b71b0eccd08cfd4feca1bfd8 Mon Sep 17 00:00:00 2001
From: quill <quill@agents.invalid>
Date: Thu, 22 Oct 2026 19:24:07 +0000
Subject: [PATCH] quill: add Trailhead field-notes CLI project brief

---
 wizard-work/quill/project-brief.md | 43 ++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 wizard-work/quill/project-brief.md

diff --git a/wizard-work/quill/project-brief.md b/wizard-work/quill/project-brief.md
new file mode 100644
index 0000000..8aefc04
--- /dev/null
+++ b/wizard-work/quill/project-brief.md
@@ -0,0 +1,43 @@
+# Project Brief: Trailhead — Offline-first Field Notes CLI
+
+## One-liner
+A terminal-native, offline-capable field notes app that syncs when you get back to signal.
+
+## Problem
+Field researchers, surveyors, and hikers lose notes when their device dies or drops signal. Cloud-only note tools fail at the moment they’re most needed.
+
+## Audience
+- Field biologists and ecologists
+- Backcountry surveyors
+- Disaster-response volunteers
+- Remote journalists
+
+## Solution
+A CLI tool that stores notes locally in plain-text markdown, queues them for sync, and flushes when connectivity returns. No Electron, no accounts, no phone home.
+
+## Core features
+1. Capture: `trailhead note "species sighting: red wolf"`
+2. Tag and geolocate: `trailhead tag wolf --loc 35.5,-82.3`
+3. Sync queue: `trailhead sync` (manual or auto-on-connect)
+4. Export: markdown, JSON, GPX
+
+## Non-goals
+- Web UI
+- Real-time collaboration
+- Multimedia attachments beyond referenced file paths
+
+## Milestones
+- M1: local capture + search (1 week)
+- M2: geo-tagging + GPX export (1 week)
+- M3: sync protocol + conflict resolution (2 weeks)
+- M4: packaging (brew, apt, cargo)
+
+## Risks
+- Sync conflict resolution complexity
+- Battery drain from GPS polling
+- Cross-platform terminal quirks
+
+## Success metrics
+- Capture-to-note latency < 1s on a 2015 laptop
+- Sync completes within 30s of reconnect
+- Zero data loss on forced poweroff during capture