chore: add pre-commit hooks for mkdocs and markdownlint (#13)

* 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

* fix: add adr/README.md to mkdocs nav

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)

mkdocs.yml

@@ -73,7 +73,9 @@ nav:
       - Foundation:
           - Security Patterns: patterns/security-patterns.md
           - Testing Patterns: patterns/testing-patterns.md
-  - ADR Template: adr/template.md
+  - ADR:
+      - About ADRs: adr/README.md
+      - Template: adr/template.md
 
 extra:
   social:

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