Add CLAUDE.md with codebase documentation for AI assistants

[zaratan]

Covers project structure, development commands, CI checks,
code conventions, architecture notes, and key dependencies.

https://claude.ai/code/session_01TU6QNizdUvQe9WPdn7vXqG

[Copilot]

Pull request overview

Adds a new CLAUDE.md documentation file intended to orient AI assistants (and contributors) to the DevOops gem’s structure, workflows, conventions, and architecture.

Changes:

• Documented repository structure, development commands, and CI checks.
• Summarized code conventions and high-level architecture (Runner/ScriptsLoader, script storage, reserved names).
• Listed key dependencies and release/versioning notes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The repository tree lists lib/dev_oops/dev_oops.rb, but in this repo the gem entrypoint is lib/dev_oops.rb (top-level under lib/). Updating this section will prevent readers from looking for a non-existent file/path.

Suggested change

	lib/dev_oops/
	├── dev_oops.rb # Module init, Zeitwerk setup, eager_load
	├── version.rb # VERSION constant (bump for releases)
	├── runner.rb # Thor CLI entry point, dynamic command registration
	├── scripts_loader.rb # Script discovery, config parsing, Thor::Group builders
	└── commands/
	├── edit_script.rb # Edit script JSON config
	├── edit_script_sh.rb # Edit script .sh body
	├── local_install.rb # Create local ./dev_oops directory
	└── remove_script.rb # Remove a script
	exe/
	└── dev_oops # Executable entry point
	spec/
	└── dev_oops_spec.rb # RSpec tests
	templates/
	└── empty_script.tt # JSON template for new scripts
	bin/
	├── setup # Install bundle dependencies
	├── console # IRB console with gem loaded
	└── local_do # Local development runner
	lib/
	├── dev_oops.rb # Gem entrypoint, Zeitwerk setup, eager_load
	└── dev_oops/
	├── version.rb # VERSION constant (bump for releases)
	├── runner.rb # Thor CLI entry point, dynamic command registration
	├── scripts_loader.rb # Script discovery, config parsing, Thor::Group builders
	└── commands/
	├── edit_script.rb # Edit script JSON config
	├── edit_script_sh.rb # Edit script .sh body
	├── local_install.rb # Create local ./dev_oops directory
	└── remove_script.rb # Remove a script
	exe/
	└── dev_oops # Executable entry point
	spec/
	└── dev_oops_spec.rb # RSpec tests
	templates/
	└── empty_script.tt # JSON template for new scripts
	bin/
	├── setup # Install bundle dependencies
	├── console # IRB console with gem loaded
	└── local_do # Local development runner

[Copilot]

This CI description says PRs to main verify that lib/dev_oops/version.rb has been bumped, but the GitHub Actions workflow only performs the version-diff check/publish logic on pushes to main (release job). Please reword to match the actual workflow behavior.

[Copilot]

The Version & Release section repeats that CI verifies version changes on PRs to main, but the workflow currently checks for version changes only when running the release job on pushes to main. Please align this bullet with what CI actually does.

[Copilot]

The forbidden/reserved names list includes local_install, but the CLI registers the local directory creator under the install subcommand (and there is no local_install command registered in Runner). Consider clarifying whether local_install is a legacy alias/reserved name, or update the list to avoid confusion.

Suggested change

	- **Forbidden script names:** `help`, `install`, `edit`, `edit_sh`, `rm`, `local_install` — reserved for built-in commands.
	- **Forbidden script names:** `help`, `install`, `edit`, `edit_sh`, `rm` — reserved for built-in commands. The legacy alias name `local_install` is also reserved internally for backward compatibility and must not be used by user scripts, even though it is not exposed as a standalone CLI command.

[Copilot]

The Key Dependencies markdown table uses || at the start of each row/header, which renders as an extra empty column in standard Markdown. Use a single leading | for each row so the table formats correctly.