diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index db326df..336ad42 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -13,7 +13,9 @@ jobs:
       - uses: actions/checkout@v4
       - name: Lint markdown
         run: |
-          for f in $(find . -name "*.md"); do
-            echo "Checking $f..."
-            test -s "$f" || echo "  WARNING: empty file"
-          done
+          pip install markdownlint-cli2
+          markdownlint-cli2 '**/*.md' --config .markdownlint.yaml || true
+      - name: Lint YAML
+        run: |
+          pip install yamllint
+          yamllint -c .yamllint.yaml . || true
diff --git a/.yamllint.yaml b/.yamllint.yaml
new file mode 100644
index 0000000..5ff2808
--- /dev/null
+++ b/.yamllint.yaml
@@ -0,0 +1,16 @@
+# YAML linting configuration for CognitiveOS SDLC
+extends: default
+rules:
+  line-length:
+    max: 120
+    level: warning
+  trailing-spaces: warning
+  indentation:
+    spaces: 2
+    level: warning
+  document-start: warning
+  quotes:
+    avoid: warning
+  brackets:
+    max-spaces-inside: 1
+    level: warning