chore: add pre-commit hooks for mkdocs and markdownlint

- Add .pre-commit-config.yaml with mkdocs build --strict and markdownlint
- Add mkdocs dependencies to requirements-dev.txt
- Fix broken link to PRESENTATION in quickstart.md
- Update .claude/settings.local.json with mkdocs and pre-commit permissions

Author: jeremyeder

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: local
+    hooks:
+      - id: mkdocs-build
+        name: mkdocs build --strict
+        entry: .venv/bin/mkdocs build --strict
+        language: system
+        pass_filenames: false
+        files: ^(docs/|mkdocs\.yml)
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.43.0
+    hooks:
+      - id: markdownlint
+        args: ["--fix"]
+        exclude: ^\.claude/

docs/quickstart.md

@@ -107,4 +107,4 @@ Read these to understand the format. Create your own based on your project.
 ## Links
 
 - **Working Demo**: [demo-fastapi](https://github.com/ambient-code/demo-fastapi)
-- **Presentation**: [PRESENTATION-ambient-code-reference.md](../PRESENTATION-ambient-code-reference.md)
+- **Presentation**: [PRESENTATION-ambient-code-reference.md](https://github.com/ambient-code/reference/blob/main/PRESENTATION-ambient-code-reference.md)

requirements-dev.txt

@@ -2,3 +2,8 @@
 black>=23.12.0
 isort>=5.13.0
 ruff>=0.1.0
+pre-commit>=3.6.0
+mkdocs>=1.6.0
+mkdocs-material>=9.5.0
+mkdocs-mermaid2-plugin>=1.1.0
+pymdown-extensions>=10.0.0