The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
paths: - "/*.pl" - "/.pm" - "**/.t" - "/*.psgi" - "/*.cgi"
Perl Coding Style
This file extends common/coding-style.md with Perl-specific content.
Standards
- Always
use v5.36(enablesstrict,warnings,say, subroutine signatures) - Use subroutine signatures — never unpack
@_manually - Prefer
sayoverprintwith explicit newlines
Immutability
- Use Moo with
is => 'ro'andTypes::Standardfor all attributes - Never use blessed hashrefs directly — always use Moo/Moose accessors
- OO override note: Moo
hasattributes withbuilderordefaultare acceptable for computed read-only values
Formatting
Use perltidy with these settings:
-i=4 # 4-space indent
-l=100 # 100 char line length
-ce # cuddled else
-bar # opening brace always right
Linting
Use perlcritic at severity 3 with themes: core, pbp, security.
perlcritic --severity 3 --theme 'core || pbp || security' lib/
Reference
See skill: perl-patterns for comprehensive modern Perl idioms and best practices.