mirror of
https://github.com/gwebu-team/profile.d.git
synced 2025-12-10 20:55:46 +00:00
23 lines
1.2 KiB
Markdown
23 lines
1.2 KiB
Markdown
|
# AGENTS.md - Repository Guidelines for Agentic Coding
|
||
|
|
|
||
|
|
## Build & Development Commands
|
||
|
|
- `make help` - Show all available targets
|
||
|
|
- `make dist` - Create source distribution in dist/
|
||
|
|
- `make rpm` - Build RPM package
|
||
|
|
- `make podman_rpm` - Build RPM using podman (for MacOS)
|
||
|
|
- `make changelog` - Add changelog entry via ./changelog.sh
|
||
|
|
- `make clean` - Clean generated files
|
||
|
|
- Pre-commit hooks run automatically on commit (see .pre-commit-config.yaml)
|
||
|
|
|
||
|
|
## Code Style Guidelines
|
||
|
|
- **Shell Scripts**: Use bash syntax, source-safe with `${BASH_SOURCE-}` guard
|
||
|
|
- **File Permissions**: profile.d scripts must be 0644 (install -m 0644) - they are sourced, not executed
|
||
|
|
- **Line Endings**: LF only (enforced by pre-commit, see .editorconfig)
|
||
|
|
- **No trailing whitespace** (enforced by pre-commit, see .editorconfig)
|
||
|
|
- **Error Handling**: Use `command -v` instead of `which` for portability
|
||
|
|
- **OS Compatibility**: Support both Linux and MacOS with conditional logic
|
||
|
|
- **Naming**: Profile.d files use `z-<name>.sh` pattern for alphabetical loading
|
||
|
|
- **Licensing**: The Unlicense unless explicitly stated otherwise
|
||
|
|
- **Indentation**: 4 spaces for shell scripts (see .editorconfig)
|
||
|
|
- **Large Files**: Max 64KB (enforced by pre-commit)
|