diff --git a/HACKING.md b/HACKING.md
new file mode 100644
index 0000000..5feaf7c
--- /dev/null
+++ b/HACKING.md
@@ -0,0 +1,12 @@
+
+
+
+
+
+# default behavior for command line output
+
+if some command requires a subcommand and the subcommand is missing, output should be printed as follows:
+
+* auxilary information should be printed to the stderr. These are read by human.
+* list of candidates for the missing subcommand should be printed to the stdout. These are not only read by human, but also read by shell completion facility.
+