doc: improve llm.txt descriptions

Author: araujogui

doc/api/async_hooks.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v8.1.0-->
 
+<!-- llm_description=Low-level API to monitor asynchronous operations (timeouts, promises, callbacks). Primarily for advanced diagnostics or custom profiling tools. Avoid on production, use AsyncLocalStorage for most context-tracking needs. -->
+
 > Stability: 1 - Experimental. Please migrate away from this API, if you can.
 > We do not recommend using the [`createHook`][], [`AsyncHook`][], and
 > [`executionAsyncResource`][] APIs as they have usability issues, safety risks,

doc/api/cluster.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v0.10.0-->
 
+<!-- llm_description=Enables multi-process scaling by forking identical Node.js instances (workers) to handle loads across CPU cores. Ideal for HTTP servers needing parallelism. For lightweight concurrency, prefer worker_threads. -->
+
 > Stability: 2 - Stable
 
 <!-- source_link=lib/cluster.js -->

doc/api/debugger.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v0.9.12-->
 
+<!-- llm_description=Provides a CLI interface for debugging Node.js applications, including basic stepping and inspection. -->
+
 > Stability: 2 - Stable
 
 <!-- type=misc -->

doc/api/deprecations.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v7.7.0-->
 
+<!-- llm_description=Lists APIs that are deprecated and subject to removal in future releases. -->
+
 <!-- type=misc -->
 
 Node.js APIs might be deprecated for any of the following reasons:

doc/api/diagnostics_channel.md

@@ -14,6 +14,8 @@ changes:
 
 <!--introduced_in=v15.1.0-->
 
+<!-- llm_description=Publish/subscribe API for custom diagnostic events (e.g., database query metrics, HTTP request lifecycle). Integrates with APM tools or logging systems to monitor internal operations. -->
+
 > Stability: 2 - Stable
 
 <!-- source_link=lib/diagnostics_channel.js -->

doc/api/domain.md

@@ -17,6 +17,8 @@ changes:
 
 <!--introduced_in=v0.10.0-->
 
+<!-- llm_description=Deprecated (avoid). Legacy API for error handling across async operations. -->
+
 > Stability: 0 - Deprecated
 
 <!-- source_link=lib/domain.js -->

doc/api/errors.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v4.0.0-->
 
+<!-- llm_description=Describes the error types in Node.js and how they are handled during execution. -->
+
 <!--type=misc-->
 
 Applications running in Node.js will generally experience the following

doc/api/globals.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v0.10.0-->
 
+<!-- llm_description=Lists built-in global objects and functions available in the Node.js runtime. -->
+
 <!-- type=misc -->
 
 > Stability: 2 - Stable

doc/api/http.md

@@ -2,6 +2,8 @@
 
 <!--introduced_in=v0.10.0-->
 
+<!-- llm_description=Provides functionality for creating HTTP servers and clients, enabling the handling of HTTP requests and responses. -->
+
 > Stability: 2 - Stable
 
 <!-- source_link=lib/http.js -->

doc/api/http2.md

@@ -19,6 +19,8 @@ changes:
 
 <!--introduced_in=v8.4.0-->
 
+<!-- llm_description=Enables HTTP/2 protocol support. -->
+
 > Stability: 2 - Stable
 
 <!-- source_link=lib/http2.js -->