If you name your app's folder `app/` and if you run the atom-shell from the directory above that, it will result in an error, which I believe is caused by resolving `require('app')` to your `app/` folder.
So just to avoid confusion where someone might create an app with that folder and run the atom-shell from that directory.
I wrote up some details getting atom-shell working using the grunt plugin.
- https://github.com/atom/atom-shell/issues/256#issuecomment-
42464026
## Write your first atom-shell app
-Generally, an atom-shell app would be like this:
+Generally, an atom-shell app would be like this (see this repo for reference [hello-atom](https://github.com/dougnukem/hello-atom)):
```text
-app/
+your-app/
├── package.json
├── main.js
└── index.html
On Windows:
```cmd
-$ .\atom-shell\atom.exe path-to-app\
+$ .\atom-shell\atom.exe your-app\
```
On Linux:
```bash
-$ ./atom-shell/atom path-to-app/
+$ ./atom-shell/atom your-app/
```
On Mac OS X:
```bash
-$ ./Atom.app/Contents/MacOS/Atom path-to-app/
+$ ./Atom.app/Contents/MacOS/Atom your-app/
```