fish-shell

name	fish-shell
description	Foundational guidance for writing, reviewing, and maintaining Fish shell code. Use for fish scripts, functions, completions, and shell tooling when choosing fish-native idioms for output streams, text/list handling, command status, control flow, function structure, file layout, formatting, or verification.

Fish Shell

Base layer for Fish shell development. Load only the smallest reference that owns the current decision.

Route

• Language idioms: read language-idioms.md for output streams, text/list handling, command substitutions, status checks, or success/failure chaining.
• Script structure: read script-structure.md for file roles, shebangs, startup scope, completions, function shape, arguments, variables, wrappers, or failure paths.
• Development workflow: read development-workflow.md for formatting, syntax-checking, reloading, debugging, or completion checks.

Add future references by decision surface. Keep detailed guidance in references, not here.