initial commit; layout Plan for agentic development

README.md

@@ -0,0 +1,17 @@
+## Commands
+
+- Install: `uv sync`
+- Run app: `uv run python -m your_app`
+- Run tests: `uv run pytest`
+- Lint: `uv run ruff check .`
+- Format: `uv run ruff format .`
+
+## Engineering rules
+
+- Write tests before implementation
+- Prefer small PR-sized tasks
+- Keep business logic out of widgets where possible
+- Every screen must have empty/loading/error coverage
+- Every interactive feature needs at least one Pilot test
+- Visual changes should be covered by snapshot tests
+