diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7c6198d..0fac27c 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -1,3 +1,5 @@
+fail_fast: true
+
 repos:
   # Built-in hooks for basic file validation
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -18,7 +20,9 @@ repos:
     rev: v4.4.0
     hooks:
       - id: pretty-format-json
-        args: [--autofix, --indent=2]
+        # --no-sort-keys preserves author-controlled ordering (notably the
+        # `openapi` field position); we only normalize indentation.
+        args: [--autofix, --indent=2, --no-sort-keys]
         files: ^docs\.json$
 
   # Local hooks for Mintlify-specific validation