From 060e87dada51175ceffed6e79277733c898ec680 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sun, 1 Feb 2026 16:12:13 +0000
Subject: [PATCH] docs: align development setup guide with build reality

- Update `CONTRIBUTING.md` to detail the behavior of `npm run build`, specifically that it executes `scripts/build-dist.mjs` and copies an allowlist of files/directories to `dist/`.
- Validate project health via `npm run lint`, `scripts/agent/validate-events.mjs`, and unit tests.
- Confirm `README.md` correctly links to `CONTRIBUTING.md` for detailed developer setup.

Co-authored-by: PR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
---
 CONTRIBUTING.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 265b42d9..1cd631b4 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -114,6 +114,7 @@ To set up the project locally:
    ```
 
    (This runs `npm run build:css` to generate Tailwind styles.)
+   This command executes `scripts/build-dist.mjs` to prepare the `dist/` directory for deployment. It copies an explicit allowlist of files (including `index.html`, `_headers`, `_redirects`) and directories (including `assets`, `js`, `css`, `config`) to `dist/`, excluding development artifacts like `scripts/` and `issues/`.
 
 3. **Run Tests**: