diff --git a/README.md b/README.md
index 496743b..8615093 100644
--- a/README.md
+++ b/README.md
@@ -138,7 +138,23 @@ behavior:
     - parameters from `params`
     - configs are processed last of all
 
+### Debugging
 
+There are several ways to debug config building internals.
+
+- plugin can show detected package dependencies hierarchy - run:
+
+```sh
+composer dump-autoload --verbose
+```
+
+Can be shortened to `composer du -v`.
+
+- see the list of configs and files that plugin has detected and uses
+to build configs: `vendor/hiqdev/composer-config-plugin/output/__files.php`.
+
+- see the assembled configs in
+`vendor/hiqdev/composer-config-plugin-output` directory.
 
 ## Known issues
 
diff --git a/docs/readme/Usage.md b/docs/readme/Usage.md
index 554219b..275551f 100644
--- a/docs/readme/Usage.md
+++ b/docs/readme/Usage.md
@@ -80,7 +80,23 @@ behavior:
     - parameters from `params`
     - configs are processed last of all
 
+### Debugging
 
+There are several ways to debug config building internals.
+
+- plugin can show detected package dependencies hierarchy - run:
+
+```sh
+composer dump-autoload --verbose
+```
+
+Can be shortened to `composer du -v`.
+
+- see the list of configs and files that plugin has detected and uses
+to build configs: `vendor/hiqdev/composer-config-plugin/output/__files.php`.
+
+- see the assembled configs in
+`vendor/hiqdev/composer-config-plugin-output` directory.
 
 ## Known issues