# Shell

`knowledge-bases/structured/shell/` is the structured knowledge pack for Shell.

## When to Install

- the repo contains `.sh`, `.bash`, or `.zsh` scripts
- the task touches automation, bootstrap, CI, or ops workflows
- the work needs guidance on portability, safety checks, and failure handling

## Pack Depth

- overview, review checklist, and framework notes
- promoted rules in `rules/shell/`
- canonical skill in `skills/shell-engineering/SKILL.md`
- workflow template in `templates/workflows/implement-shell-change.md`

## Examples

- `knowledge-bases/structured/shell/examples/01-reference-scenario.md`

## Validation Cues

- run the script in the safest dry-run or non-destructive mode available
- surface portability and destructive-operation risks before handoff