Purpose
Add a GUI flow that lets a non-technical writer open an external folder, review detected projects, and enter a Workspace Map without needing to understand Git, YAML, repository roots, or scanner internals.
This should build on the read-only scanner and workspace manifest work.
Desired flow
- User chooses “Open Workspace”.
- User selects a folder.
- TRURL scans it read-only.
- TRURL shows detected projects as writer-facing cards.
- User can review warnings and labels.
- User enters a Workspace Map.
- Optional manifest generation can come later, after review.
Writer-facing vocabulary
Use friendly terms by default:
- Git status → Estado de cambios
- Commit → Guardar versión
- Branch → Línea de trabajo
- Diff → Qué cambió
- Stash → Guardar aparte
- Pull/push → Sincronizar
- YAML/frontmatter → Datos del texto
- Path → Ubicación
- Repo → Proyecto versionado
- LLM prompt → Encargo a asistente
- Agent run → Trabajo asistido
Acceptance criteria
Product principle
TRURL should feel like a calm local writing studio, not a VS Code skin or a Google Docs clone with AI. Git and agents should remain inspectable underneath, but should not dominate the writer's first experience.
Purpose
Add a GUI flow that lets a non-technical writer open an external folder, review detected projects, and enter a Workspace Map without needing to understand Git, YAML, repository roots, or scanner internals.
This should build on the read-only scanner and workspace manifest work.
Desired flow
Writer-facing vocabulary
Use friendly terms by default:
Acceptance criteria
Product principle
TRURL should feel like a calm local writing studio, not a VS Code skin or a Google Docs clone with AI. Git and agents should remain inspectable underneath, but should not dominate the writer's first experience.