docs: fix pymarkdown violations in agent-guidance files

.github/workflows/docs.yml

@@ -13,6 +13,9 @@ on:
       - 'LICENSE'
       - 'SECURITY.md'
       - 'CHANGELOG.md'
+      - 'AGENTS.md'
+      - 'CLAUDE.md'
+      - '**/SKILL.md'
     tags:
       - 'v*'
   workflow_dispatch:

AGENTS.md

@@ -1,4 +1,5 @@
 # AGENTS.md
+
 Guidance for AI agents (including Claude Code) working in this repository.
 
 ## Project Overview
@@ -25,7 +26,7 @@ It is a direct port of [FlaskAPI Guard](https://github.com/rennf93/flaskapi-guar
 
 DjAPI Guard is a **thin adapter** over [guard-core](https://github.com/rennf93/guard-core). All security logic (models, handlers, decorators, detection engine, protocols, utilities) lives in the `guard_core` package; this repo contains only the Django integration layer.
 
-```
+```text
 guard-core (engine, PyPI dependency >=3.15.0)   <- all security logic
 └── djangoapi-guard (this repo)                 <- Django middleware adapter
     ├── fastapi-guard                           <- sibling adapter (ASGI middleware)

CLAUDE.md

@@ -1,4 +1,5 @@
 # AGENTS.md
+
 Guidance for AI agents (including Claude Code) working in this repository.
 
 ## Project Overview
@@ -25,7 +26,7 @@ It is a direct port of [FlaskAPI Guard](https://github.com/rennf93/flaskapi-guar
 
 DjAPI Guard is a **thin adapter** over [guard-core](https://github.com/rennf93/guard-core). All security logic (models, handlers, decorators, detection engine, protocols, utilities) lives in the `guard_core` package; this repo contains only the Django integration layer.
 
-```
+```text
 guard-core (engine, PyPI dependency >=3.15.0)   <- all security logic
 └── djangoapi-guard (this repo)                 <- Django middleware adapter
     ├── fastapi-guard                           <- sibling adapter (ASGI middleware)

pyproject.toml

@@ -134,6 +134,10 @@ plugins = ["mypy_django_plugin.main"]
 [tool.django-stubs]
 django_settings_module = "tests.settings"
 
+[tool.pymarkdown.extensions]
+# Enable YAML front matter parsing (agent skill files use front matter)
+front-matter = {enabled = true}
+
 [tool.pymarkdown.plugins.md007]
 enabled = true
 indent = 2