feat: standardize on ISO 8601 for dates, add utility functions, and document design decisions.

README.md

@@ -16,6 +16,7 @@ Built with [FastMCP](https://github.com/jlowin/fastmcp) and the [MCP Python SDK]
 - 🤖 **Agent-First Design** — includes specific instructions for LLMs on handling European date formats (DD.MM.YYYY)
 - 🌐 **Streamable HTTP transport** for broad client compatibility (SSE)
 - 🔒 **Read-only** — no write operations, safe to use with AI agents
+- 📝 **Design Decisions** — documented architectural choices in `docs/DESIGN_DECISIONS.md`
 
 ---
 
@@ -29,6 +30,7 @@ Built with [FastMCP](https://github.com/jlowin/fastmcp) and the [MCP Python SDK]
 - [Connecting with MCP Clients](#connecting-with-mcp-clients)
 - [MCP Primitives](#mcp-primitives)
 - [Project Structure](#project-structure)
+- [Design Decisions](#design-decisions)
 - [CI/CD (Gitea Actions)](#cicd-gitea-actions)
 - [Known Strava API Limitations](#known-strava-api-limitations)
 - [Troubleshooting](#troubleshooting)
@@ -76,6 +78,17 @@ uv run server
 uv run auth
 ```
 
+### Run on the fly with `uvx` (No git clone required)
+
+You can run the server directly from the repository without cloning it manually by using `uvx`:
+
+```bash
+# Set up your .env file in the current directory first!
+uvx --from git+https://git.hnrx.net/hnrx/strava-mcp-server.git server
+```
+
+*(If you are already inside the cloned directory, you can also just run `uvx --from . server`)*
+
 ---
 
 ## Strava API Setup
@@ -142,6 +155,13 @@ Add to `claude_desktop_config.json`:
 
 ---
 
+## Design Decisions
+
+For a detailed list of architectural choices, unit standardizations, and LLM-specific optimizations, please refer to:
+👉 **[docs/DESIGN_DECISIONS.md](docs/DESIGN_DECISIONS.md)**
+
+---
+
 ## CI/CD (Gitea Actions)
 
 Our pipeline (`.gitea/workflows/cicd.yml`) is fully automated: