fix broken internal links in docs using old numbered paths

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: moosebay

pages/docs/how-to/ci-integrations.md

@@ -824,4 +824,4 @@ devtools version
 
 ---
 
-**Next:** Explore [Examples & Best Practices](./07-examples-and-best-practices.md) for real-world usage patterns and advanced techniques.
+**Next:** Explore [Examples & Best Practices](/docs/cookbook/examples-and-best-practices) for real-world usage patterns and advanced techniques.

pages/docs/how-to/environments-and-variables.md

@@ -748,4 +748,4 @@ SECRET_KEY=myvalue devtools flow run test.yaml
 
 ---
 
-**Next:** Learn how to use the [CLI Tool](./05-cli-tool.md) to run flows from the command line and integrate with CI/CD pipelines.
+**Next:** Learn how to use the [CLI Tool](/docs/reference/cli) to run flows from the command line and integrate with CI/CD pipelines.

pages/docs/how-to/import-har.md

@@ -275,7 +275,7 @@ Use case: Share with browser debugging tools
 Right-click flow → Export → YAML
 ```
 
-Use case: Version control, CI/CD (see [CLI Tool](./05-cli-tool.md))
+Use case: Version control, CI/CD (see [CLI Tool](/docs/reference/cli))
 
 ### Export to cURL
 ```
@@ -317,4 +317,4 @@ Use case: Share individual requests for terminal execution
 
 ---
 
-**Next:** Learn how to create and customize [Visual Flows](./03-working-with-flows.md) to build complex API test scenarios.
+**Next:** Learn how to create and customize [Visual Flows](/docs/how-to/working-with-flows) to build complex API test scenarios.

pages/docs/how-to/working-with-flows.md

@@ -39,7 +39,7 @@ A **Flow** is a visual representation of an API testing workflow. It consists of
 
 ### Method 2: Auto-Generate from HAR Import
 
-When you [import a HAR file](./02-importing-har-files.md), DevTools automatically creates a Flow showing:
+When you [import a HAR file](/docs/how-to/import-har), DevTools automatically creates a Flow showing:
 - Request execution order
 - Data dependencies between requests
 - Variable extraction points
@@ -431,7 +431,7 @@ Every node automatically creates output variables. Access them from subsequent n
 
 ![JavaScript node editor and output](/docs/assets/flow-node-js-config.webp)
 
-See the [Environments & Variables](./04-environments-and-variables.md) guide for more details.
+See the [Environments & Variables](/docs/how-to/environments-and-variables) guide for more details.
 
 ## Dependencies and Execution Order
 
@@ -775,4 +775,4 @@ Don't build a 20-node flow without testing!
 
 ---
 
-**Next:** Learn about [Environments & Variables](./04-environments-and-variables.md) to manage configurations across different deployment stages.
+**Next:** Learn about [Environments & Variables](/docs/how-to/environments-and-variables) to manage configurations across different deployment stages.

pages/docs/reference/cli.md

@@ -200,7 +200,7 @@ flows:
 
 ### Complete Example
 
-See [Examples & Best Practices](./07-examples-and-best-practices.md) for full examples.
+See [Examples & Best Practices](/docs/cookbook/examples-and-best-practices) for full examples.
 
 ## Environment Variables
 
@@ -261,7 +261,7 @@ test:
     API_BASE_URL: https://api-staging.example.com
 ```
 
-See [CI/CD Integration](./06-cicd-integration.md) for complete examples.
+See [CI/CD Integration](/docs/how-to/ci-integrations) for complete examples.
 
 ## Output Formats
 
@@ -701,4 +701,4 @@ Validate responses explicitly:
 
 ---
 
-**Next:** Learn how to integrate DevTools CLI into your [CI/CD Pipeline](./06-cicd-integration.md).
+**Next:** Learn how to integrate DevTools CLI into your [CI/CD Pipeline](/docs/how-to/ci-integrations).

pages/docs/start-here/install.md

@@ -136,10 +136,10 @@ After sending a request:
 
 Now that you have DevTools installed and understand the basics:
 
-1. **Import Real Requests**: Learn how to [import HAR files](./02-importing-har-files.md) from browser recordings
-2. **Create Flows**: Build visual test workflows with the [Flow Builder](./03-working-with-flows.md)
-3. **Manage Environments**: Set up [environments and variables](./04-environments-and-variables.md) for different configurations
-4. **Automate Tests**: Integrate with CI/CD using the [CLI tool](./05-cli-tool.md)
+1. **Import Real Requests**: Learn how to [import HAR files](/docs/how-to/import-har) from browser recordings
+2. **Create Flows**: Build visual test workflows with the [Flow Builder](/docs/how-to/working-with-flows)
+3. **Manage Environments**: Set up [environments and variables](/docs/how-to/environments-and-variables) for different configurations
+4. **Automate Tests**: Integrate with CI/CD using the [CLI tool](/docs/reference/cli)
 
 ## Common First-Time Questions
 
@@ -158,7 +158,7 @@ DevTools supports:
 - cURL commands
 - OpenAPI/Swagger specs (coming soon)
 
-See [Importing HAR Files](./02-importing-har-files.md) for details.
+See [Importing HAR Files](/docs/how-to/import-har) for details.
 
 ### Does DevTools support authentication?
 
@@ -171,12 +171,12 @@ Yes, DevTools supports all standard authentication methods:
 
 ### Can I use DevTools in my CI/CD pipeline?
 
-Absolutely! The CLI tool is designed for CI/CD integration. See [CI/CD Integration](./06-cicd-integration.md) for examples with GitHub Actions, GitLab CI, Jenkins, and more.
+Absolutely! The CLI tool is designed for CI/CD integration. See [CI/CD Integration](/docs/how-to/ci-integrations) for examples with GitHub Actions, GitLab CI, Jenkins, and more.
 
 ### Is DevTools free?
 
 Yes, DevTools is **open source under the Apache-2.0 license** and free to use. The source code is available on [GitHub](https://github.com/the-dev-tools/dev-tools).
 
 ---
 
-**Ready to import real API requests?** Continue to [Importing HAR Files](./02-importing-har-files.md).
+**Ready to import real API requests?** Continue to [Importing HAR Files](/docs/how-to/import-har).