[Perl] DAQ system for the FAPG.
Update agent guidance.
AGENTS.org
@@ -106,18 +106,20 @@
106
106
- Perl code SHALL use strict/warnings.
107
107
- Perl script STDOUT and STDERR SHALL provide useful diagnostics in
108
108
the Systemd journal.
109
Removed:
- Perl scripts SHALL be linted against Perl-Critic, as severely as
110
Removed:
possible.
111
Removed:
- Perl scripts SHALL be reformatted using Perl-Tidy with the
112
Removed:
~--perl-best-practices~ flag.
109
Added:
- After modifying Perl code:
110
Added:
- Perl scripts SHALL be linted against Perl-Critic, as severely as
111
Added:
possible.
112
Added:
- Perl scripts SHALL be reformatted with Perl-Tidy using the
113
Added:
=.perltidyrc= config file at the root of the project.
113
114
114
115
** Shell
115
116
116
117
- Shell scripts SHALL be written in Bash.
117
118
- Shell scripts SHALL adhere to Google's Bash shell style guide
118
119
([[https://google.github.io/styleguide/shellguide.html]]).
119
Removed:
- Bash scripts SHOULD be checked with =shellcheck= for critical
120
Removed:
warnings.
120
Added:
- After modifying Bash code:
121
Added:
- Bash scripts SHOULD be checked with ~shellcheck~ for critical
122
Added:
warnings.
121
123
122
124
** Conventions
123
125
@@ -133,10 +135,6 @@
133
135
=orp=, and =ec=.
134
136
- Structured JSON parsing and generation SHALL be handled through
135
137
=JSON::PP=.
136
Removed:
- Broad refactors SHALL be avoided while touching deployment scripts
137
Removed:
or host-specific configuration.
138
Removed:
- Refactors impacting Perl files SHALL be followed by a call to
139
Removed:
=perltidy= to ensure homogenous Perl code style.
140
138
141
139
** Tests
142
140