diff --git a/.gitea/workflows/cicd.yml b/.gitea/workflows/cicd.yml
index aa2bc19..7f1b936 100644
--- a/.gitea/workflows/cicd.yml
+++ b/.gitea/workflows/cicd.yml
@@ -563,7 +563,11 @@ jobs:
               echo 'Running E2E tests with Playwright...' &&
               export CI=true &&
               export NODE_ENV=test &&
-              yarn playwright test --reporter=list --headed=false
+              echo 'Verifying Playwright installation...' &&
+              yarn playwright --version || echo 'Playwright CLI not available via yarn' &&
+              npx playwright --version || echo 'Playwright CLI not available via npx' &&
+              echo 'Running tests via yarn script...' &&
+              yarn test:e2e --reporter=list
             else
               echo 'ℹ No E2E tests found'
             fi
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 3324a58..5e9b607 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -299,8 +299,8 @@ yarn test:coverage
 # Run E2E tests (Playwright)
 yarn test:e2e
 
-# Run E2E tests in headless mode (CI-like)
-yarn playwright test --headed=false
+# Run E2E tests in headless mode (CI-like, default)
+yarn playwright test
 
 # Run E2E tests with specific reporter
 yarn playwright test --reporter=list