docs: update README to reflect current repo structure

Author: Mathews-Tom

agents/Mathews-Tom__secret-scanner/README.md

@@ -1,6 +1,6 @@
 # secret-scanner
 
-Pre-commit secret detection agent. Scans for hardcoded API keys, passwords, tokens, connection strings, private keys, and high-entropy strings across known provider patterns.
+Pre-commit credential detection agent that scans staged files for hardcoded API keys, passwords, tokens, connection strings, private key material, and high-entropy strings. Operates as a fast, zero-false-negative gate between your code and version control.
 
 ## Run
 
@@ -10,22 +10,32 @@ npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/secret-scanner
 
 ## What It Can Do
 
-- Detect hardcoded secrets across 50+ provider patterns (AWS, GCP, Azure, Stripe, etc.)
-- Identify high-entropy strings that may be credentials
-- Scan for private keys, certificates, and connection strings
-- Flag passwords and tokens in configuration files
-- Report findings with file location, secret type, and severity
+- **Provider Key Detection** — recognizes exact patterns for AWS, GitHub, Slack, Stripe, Google, Azure, and other provider credentials
+- **Private Key Scanning** — detects PEM-encoded RSA, EC, OPENSSH, PGP, DSA, and PKCS8 private key material
+- **Connection String Detection** — finds database and service connection strings with embedded credentials (PostgreSQL, MySQL, MongoDB, Redis, AMQP, SMTP)
+- **High-Entropy Analysis** — calculates Shannon entropy to flag suspicious strings assigned to credential-like variables
+- **Environment Variable Leakage** — detects .env values leaked into source code and hardcoded fallbacks in os.environ/process.env calls
+- **Redacted Reporting** — outputs findings with redacted secrets (first 4 / last 4 characters only) to prevent the scan report itself from becoming a leak vector
 
 ## Structure
 
 ```
 secret-scanner/
-  agent.yaml        # Agent configuration
-  SOUL.md           # Behavioral instructions and detection patterns
-  icon.png          # 256x256 agent icon
-  banner.png        # 1200x630 agent banner
+├── .gitignore
+├── LICENSE
+├── README.md
+├── RULES.md
+├── SOUL.md
+├── agent.yaml
+├── assets/
+│   ├── icon.png
+│   └── banner.png
+└── knowledge/
+    ├── provider-key-patterns.md
+    ├── high-entropy-detection.md
+    └── remediation-guide.md
 ```
 
 ## Built with
 
-Built with [gitagent](https://github.com/open-gitagent/gitagent).
+Built for the [gitagent](https://gitagent.sh) ecosystem.