Fix all documentation link warnings

- Fix product home page links (a2a-security/index.md, capiscio-cli/README.md)
- Fix support page CLI references
- Fix scoring-system.md parent directory depth (../../  ../)
- Remove trailing slashes from all relative links
- Docs now build cleanly with --strict mode

Author: beonde

docs/community/support.md

@@ -6,30 +6,30 @@ Need help with CapiscIO? Here are the best ways to get support.
 
 Start with the documentation for your specific product:
 
-- **[A2A Security Documentation](../a2a-security/)** - Security middleware guides and API reference
-- **[CapiscIO CLI Documentation](../capiscio-cli/)** - Command-line tools and validation
+- **[A2A Security Documentation](../a2a-security/index.md)** - Security middleware guides and API reference
+- **[CapiscIO CLI Documentation](../capiscio-cli/README.md)** - Command-line tools and validation
 
 ## Quick Links
 
 ### Getting Started
 
-- [A2A Security Quick Start](../a2a-security/getting-started/quickstart/)
-- [CapiscIO CLI Getting Started](../capiscio-cli/)
+- [A2A Security Quick Start](../a2a-security/getting-started/quickstart.md)
+- [CapiscIO CLI Getting Started](../capiscio-cli/README.md)
 - [A2A Protocol Specification](https://github.com/a2aproject/A2A){:target="_blank"}
 
 ### Common Tasks
 
 **For A2A Security:**
 
-- [Installation & Setup](../a2a-security/getting-started/installation/)
-- [Configuration Guide](../a2a-security/guides/configuration/)
-- [Core Concepts](../a2a-security/getting-started/concepts/)
+- [Installation & Setup](../a2a-security/getting-started/installation.md)
+- [Configuration Guide](../a2a-security/guides/configuration.md)
+- [Core Concepts](../a2a-security/getting-started/concepts.md)
 
 **For CapiscIO CLI:**
 
-- [Validation Process](../capiscio-cli/validation-process/)
-- [Scoring System](../capiscio-cli/scoring-system/)
-- [Architecture](../capiscio-cli/architecture/)
+- [Validation Process](../capiscio-cli/validation-process.md)
+- [Scoring System](../capiscio-cli/scoring-system.md)
+- [Architecture](../capiscio-cli/architecture.md)
 
 ## GitHub Resources
 
@@ -62,7 +62,7 @@ Want to contribute? See our [Contributing Guide](contributing.md) for details on
 
 ### Python (A2A Security)
 
-- **PyPI**: [a2a-security package](https://pypi.org/project/a2a-security/)
+- **PyPI**: [a2a-security package](https://pypi.org/project/a2a-security.md)
 - **Installation**: `pip install a2a-security`
 - **Requirements**: Python 3.10+
 

docs/guides/scoring-system.md

@@ -362,7 +362,7 @@ capiscio validate https://agent.example.com --detailed-scores --test-live
 capiscio validate agent.json --detailed-scores --json > scores.json
 ```
 
-[**See full CLI usage guide →**](../../capiscio-cli/scoring-system/)
+[**See full CLI usage guide →**](../capiscio-cli/scoring-system.md)
 
 ### Python API
 
@@ -385,7 +385,7 @@ if result.trust.rating == TrustRating.HIGHLY_TRUSTED:
     await process_payment(partner_url)
 ```
 
-[**See full Python usage guide →**](../../a2a-security/guides/scoring/)
+[**See full Python usage guide →**](../a2a-security/guides/scoring.md)
 
 ---
 
@@ -500,9 +500,9 @@ The old `result.score` property still exists but returns `compliance.total` and
 
 ## See Also
 
-- **[CapiscIO CLI Scoring](https://docs.capisc.io/capiscio-cli/scoring-system/)** - Command-line usage and flags
-- **[A2A Security Scoring](https://docs.capisc.io/a2a-security/guides/scoring/)** - Python API and patterns
-- **[Core Concepts](https://docs.capisc.io/a2a-security/getting-started/concepts/)** - Understanding validation architecture
+- **[CapiscIO CLI Scoring](https://docs.capisc.io/capiscio-cli/scoring-system.md)** - Command-line usage and flags
+- **[A2A Security Scoring](https://docs.capisc.io/a2a-security/guides/scoring.md)** - Python API and patterns
+- **[Core Concepts](https://docs.capisc.io/a2a-security/getting-started/concepts.md)** - Understanding validation architecture
 
 ---
 

docs/index.md

@@ -24,15 +24,15 @@ Runtime security for A2A agents. Message validation, signature verification, and
 **Use when:** Building production A2A agents that need protection from malformed messages, protocol violations, and SSRF attacks.
 
 **Quick Links:**
-- [Quick Start →](a2a-security/getting-started/quickstart/)
-- [Installation Guide](a2a-security/getting-started/installation/)
-- [Configuration Reference](a2a-security/guides/configuration/)
-- [Scoring System](a2a-security/guides/scoring/)
+- [Quick Start →](a2a-security/getting-started/quickstart.md)
+- [Installation Guide](a2a-security/getting-started/installation.md)
+- [Configuration Reference](a2a-security/guides/configuration.md)
+- [Scoring System](a2a-security/guides/scoring.md)
 
-[![PyPI](https://img.shields.io/pypi/v/capiscio-a2a-security.svg)](https://pypi.org/project/capiscio-a2a-security/){:target="_blank"}
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/){:target="_blank"}
+[![PyPI](https://img.shields.io/pypi/v/capiscio-a2a-security.svg)](https://pypi.org/project/capiscio-a2a-security.md){:target="_blank"}
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads.md){:target="_blank"}
 
-[Browse A2A Security Docs →](a2a-security/){ .md-button .md-button--primary }
+[Browse A2A Security Docs →](a2a-security/index.md){ .md-button .md-button--primary }
 </div>
 
 <div class="product-card" markdown>
@@ -43,15 +43,15 @@ Command-line validation for A2A agent cards. Three-dimensional scoring, JWS sign
 **Use when:** Validating agent cards during development, CI/CD pipelines, or registry submissions.
 
 **Quick Links:**
-- [Getting Started](capiscio-cli/)
-- [Validation Process](capiscio-cli/validation-process/)
-- [Scoring System](capiscio-cli/scoring-system/)
-- [API Reference](capiscio-cli/api-reference/)
+- [Getting Started](capiscio-cli/README.md)
+- [Validation Process](capiscio-cli/validation-process.md)
+- [Scoring System](capiscio-cli/scoring-system.md)
+- [API Reference](capiscio-cli/api-reference.md)
 
 [![npm version](https://img.shields.io/npm/v/capiscio-cli.svg)](https://www.npmjs.com/package/capiscio-cli){:target="_blank"}
 [![Downloads](https://img.shields.io/npm/dm/capiscio-cli)](https://www.npmjs.com/package/capiscio-cli){:target="_blank"}
 
-[Browse CLI Docs →](capiscio-cli/){ .md-button .md-button--primary }
+[Browse CLI Docs →](capiscio-cli/README.md){ .md-button .md-button--primary }
 [Try Online Validator →](https://capisc.io/validator){ .md-button target="_blank" }
 </div>
 
@@ -104,7 +104,7 @@ Command-line validation for A2A agent cards. Three-dimensional scoring, JWS sign
 <div class="link-grid" markdown>
 
 - [:material-github: **GitHub**<br/>Source code & issues](https://github.com/capiscio){:target="_blank"}
-- [:material-package: **PyPI**<br/>Python packages](https://pypi.org/user/capiscio/){:target="_blank"}
+- [:material-package: **PyPI**<br/>Python packages](https://pypi.org/user/capiscio.md){:target="_blank"}
 - [:material-npm: **npm**<br/>Node.js packages](https://www.npmjs.com/~capiscio){:target="_blank"}
 - [:material-file-document: **A2A Spec**<br/>Protocol reference](https://github.com/a2aproject/A2A){:target="_blank"}