Add design considerations to README.md

README.md

@@ -14,3 +14,23 @@ life" works out just fine for us.
 
 Then, of course, there's the image of Buckaroo invoked every time we say
 the name. In fact, I think we have our new theme song.
+
+## Example GitHub Template
+
+<https://github.com/rwxrob/template-bonzai>
+
+## Design Considerations
+
+* **Promote high-level package library API calls over Cmd bloat.** Code
+  belongs in package libraries, not Cmds. While Bonzai allows for rapid
+  applications development by putting everything initially in Cmd
+  Methods, Cmds are most designed for documentation and completion, not
+  heavy Method implementations. Eventually, most Method implementations
+  should be moved into their own package libraries, perhaps even in the
+  same Go module. Cmds should *never* be communicating with each other
+  directly. While the idea of adding a Channel attribute was intriguing,
+  it quickly became clear that doing so would promote too much code and
+  tight coupling --- even with channels --- between specific commands.
+  Cmds should be *very* light. In fact, most Cmds should assign their
+  Method directly from one matching the Method function signature in a
+  callable, high-level library.