Cursor rule

1---
2paths:
3  - "**/*.pl"
4  - "**/*.pm"
5  - "**/*.t"
6  - "**/*.psgi"
7  - "**/*.cgi"
8---
9# Perl Coding Style
10 
11> This file extends [common/coding-style.md](../common/coding-style.md) with Perl-specific content.
12 
13## Standards
14 
15- Always `use v5.36` (enables `strict`, `warnings`, `say`, subroutine signatures)
16- Use subroutine signatures — never unpack `@_` manually
17- Prefer `say` over `print` with explicit newlines
18 
19## Immutability
20 
21- Use **Moo** with `is => 'ro'` and `Types::Standard` for all attributes
22- Never use blessed hashrefs directly — always use Moo/Moose accessors
23- **OO override note**: Moo `has` attributes with `builder` or `default` are acceptable for computed read-only values
24 
25## Formatting
26 
27Use **perltidy** with these settings:
28 
29```
30-i=4    # 4-space indent
31-l=100  # 100 char line length
32-ce     # cuddled else
33-bar    # opening brace always right
34```
35 
36## Linting
37 
38Use **perlcritic** at severity 3 with themes: `core`, `pbp`, `security`.
39 
40```bash
41perlcritic --severity 3 --theme 'core || pbp || security' lib/
42```
43 
44## Reference
45 
46See skill: `perl-patterns` for comprehensive modern Perl idioms and best practices.
47