mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 10:59:59 +00:00
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
21 lines
877 B
Markdown
21 lines
877 B
Markdown
# Shell
|
|
|
|
Use this page for shell-script-specific guidance.
|
|
|
|
## Script Layout
|
|
|
|
- You MUST store general `.sh` scripts for infinito.nexus administration under `scripts/`.
|
|
- You MUST keep shell entrypoints in `scripts/` so they stay easy to discover and reuse.
|
|
- You MUST keep role-local or component-specific shell helpers in their owning area, such as `roles/.../files/`, when they belong to a single role.
|
|
|
|
## Executable Bit
|
|
|
|
- You MUST set the executable bit on shell scripts that are meant to run directly.
|
|
- You MUST use `chmod +x` for those scripts so they can be invoked as executables.
|
|
- You MUST keep a shebang at the top of executable shell scripts.
|
|
|
|
## Notes
|
|
|
|
- `scripts/tests/deploy/local/exec/container.sh` is a direct-entry shell script example.
|
|
- For shell entrypoints that are exposed through `make`, you SHOULD prefer a thin target that delegates to the script.
|