pilot-shell decisions: why the code looks like this