diff --git a/.github/workflows/quality.yaml b/.github/workflows/quality.yaml
index 78023e466..3487133b1 100644
--- a/.github/workflows/quality.yaml
+++ b/.github/workflows/quality.yaml
@@ -8,6 +8,7 @@ name: Quality & Validation
 # - Agent schema tests (fixture-based validation)
 # - Installation component tests (compilation)
 # - Bundle validation (web bundle integrity)
+# Keep this workflow aligned with `npm run quality` in `package.json`.
 
 "on":
   pull_request:
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..1b68191e5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+# BMAD-METHOD
+
+Open source framework for structured, agent-assisted software delivery.
+
+## Rules
+
+- Use Conventional Commits for every commit.
+- Before pushing, run `npm ci && npm run quality` on `HEAD` in the exact checkout you are about to push.
+  `quality` mirrors the checks in `.github/workflows/quality.yaml`.
diff --git a/package.json b/package.json
index 5012dea5a..a32decc32 100644
--- a/package.json
+++ b/package.json
@@ -39,6 +39,7 @@
     "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
     "lint:md": "markdownlint-cli2 \"**/*.md\"",
     "prepare": "command -v husky >/dev/null 2>&1 && husky || exit 0",
+    "quality": "npm run format:check && npm run lint && npm run lint:md && npm run docs:build && npm run validate:schemas && npm run test:schemas && npm run test:install && npm run validate:refs",
     "rebundle": "node tools/cli/bundlers/bundle-web.js rebundle",
     "test": "npm run test:schemas && npm run test:refs && npm run test:install && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
     "test:coverage": "c8 --reporter=text --reporter=html npm run test:schemas",