organized code quality tools documentation

Author: BryanChasko

README.md

@@ -63,11 +63,18 @@ pragmatic execution, and narrative continuity.
 HeraldStack operates on consent-based principles and follows clear ethical
 guidelines including those defined in LawsOfRobotics.json.
 
+## Development Tools
+
+- **Code Quality & Validation**: Scripts for checking and formatting code are
+  available in `scripts/validation/`. See
+  `scripts/validation/VALIDATION_TOOLS.md` for usage details.
+  
 ## Further Information
 
 See docs/DETAILED.md for more information.
 
 ---
 
 © 2025 Bryan Chasko
+
 # Git hook test

scripts/validation/README.md

@@ -0,0 +1,30 @@
+# HeraldStack Validation & Code Quality Tools
+
+This directory contains scripts used for validating and formatting files in the
+HeraldStack project.
+
+## Available Scripts
+
+- `check-json.sh` - Validates and formats JSON files in the project using
+  jsonlint and prettier
+- `check-rust.sh` - Runs formatting (rustfmt), linting (clippy), tests, and
+  security audit on Rust code
+- `format-md.sh` - Formats Markdown files in the project using prettier
+
+## Usage
+
+Run these scripts from the project root for best results:
+
+```bash
+# Validate and format JSON files
+./scripts/validation/check-json.sh
+
+# Validate Rust code
+./scripts/validation/check-rust.sh
+
+# Format Markdown files
+./scripts/validation/format-md.sh
+```
+
+These scripts are designed to be used both locally during development and in
+CI/CD pipelines.

scripts/validation/VALIDATION_TOOLS.md

@@ -0,0 +1,30 @@
+# HeraldStack Validation & Code Quality Tools
+
+This directory contains scripts used for validating and formatting files in the
+HeraldStack project.
+
+## Available Scripts
+
+- `check-json.sh` - Validates and formats JSON files in the project using
+  jsonlint and prettier
+- `check-rust.sh` - Runs formatting (rustfmt), linting (clippy), tests, and
+  security audit on Rust code
+- `format-md.sh` - Formats Markdown files in the project using prettier
+
+## Usage
+
+Run these scripts from the project root for best results:
+
+```bash
+# Validate and format JSON files
+./scripts/validation/check-json.sh
+
+# Validate Rust code
+./scripts/validation/check-rust.sh
+
+# Format Markdown files
+./scripts/validation/format-md.sh
+```
+
+These scripts are designed to be used both locally during development and in
+CI/CD pipelines.

check-json.sh scripts/validation/check-json.shcheck-json.sh renamed to scripts/validation/check-json.sh

@@ -2,7 +2,7 @@
 set -e
 
 # Change to the rust_ingest directory where Cargo.toml is located
-cd "$(dirname "$0")/rust_ingest" || exit 1
+cd "$(dirname "$0")/../../rust_ingest" || exit 1
 echo "Checking Rust files in $(pwd)..."
 
 echo "Running rustfmt..."