@ryuenn3123/agentic-senior-core 5.3.0 → 5.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -21,10 +21,10 @@ Before writing any code, stop at the first step that holds:
21
21
 
22
22
  - Descriptive variable and function names. No cryptic abbreviations.
23
23
  - Early returns over deep nesting. Keep the main flow traceable.
24
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
25
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
24
+ - Three similar lines is better than a premature abstraction.
25
+ - Don't add features, refactor, or introduce abstractions beyond what the task requires.
26
+ - Don't design for hypothetical future requirements.
26
27
  - Delete code that carries no behavior, safety, or test value.
27
- - Plain English in documentation. No emoji in formal docs or review summaries.
28
28
 
29
29
  ## Architecture
30
30
 
@@ -33,7 +33,6 @@ Before writing any code, stop at the first step that holds:
33
33
  - Controllers handle protocol translation only. Business logic belongs in services.
34
34
  - Default to modular monolith unless scale evidence demands microservices.
35
35
  - Direction changes require explicit user confirmation.
36
- - Do not choose framework by habit. Match project evidence and needs.
37
36
 
38
37
  ## Security (never skip)
39
38
 
@@ -49,6 +48,7 @@ Before writing any code, stop at the first step that holds:
49
48
  ## Error Handling
50
49
 
51
50
  - Fail fast on invalid input.
51
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
52
52
  - Structured error responses with safe details only. Use standard error codes (RFC 9457 when applicable).
53
53
  - Distinguish client errors (4xx) from server errors (5xx).
54
54
  - No silent swallowing. Log operational errors with context.
@@ -69,8 +69,6 @@ Before writing any code, stop at the first step that holds:
69
69
  - Idempotent for side-effect mutations. Document retry behavior.
70
70
  - Backward-compatible by default. Version breaking changes explicitly.
71
71
  - Sync docs in the same commit when changing API, CLI, or schema.
72
- - Use OpenAPI 3.1 for HTTP APIs where applicable.
73
- - Document deprecation windows before sunsetting endpoints.
74
72
 
75
73
  ## Database
76
74
 
@@ -79,30 +77,21 @@ Before writing any code, stop at the first step that holds:
79
77
  - Multi-table mutations run inside transactions.
80
78
  - Monetary amounts: integer minor units or exact decimal. Never floats.
81
79
  - Timestamps in UTC. No naive timestamps.
82
- - Use optimistic concurrency tokens for shared mutable resources.
83
80
  - Schema changes require versioned, reversible migrations.
84
81
  - Never modify merged migrations. Create new ones.
85
- - Use concurrent index builds in production.
86
82
 
87
83
  ## Frontend
88
84
 
89
85
  - Semantic HTML before custom components.
90
- - WCAG 2.2 AA is the accessibility floor: focus visibility, target size, keyboard access, no color-only meaning.
91
- - Responsive by default. Recompose content for breakpoints, not just shrink.
92
- - Explicitly handle empty, loading, error, and offline states.
93
- - CSS logical properties for direction-sensitive layout.
94
- - Plan overflow, wrapping, truncation, and motion fallbacks.
86
+ - WCAG 2.2 AA is the accessibility floor.
87
+ - Responsive by default. Handle empty, loading, error, and offline states.
95
88
  - No placeholder, lorem, or TODO content in production UI.
96
- - Use component kits or headless primitives for behavior and accessibility when they fit.
97
89
 
98
90
  ## Infrastructure
99
91
 
100
92
  - Container configs: multi-stage builds, minimal base images, non-root users, no baked secrets.
101
- - Explicit healthchecks in production.
102
93
  - Configuration from environment, validated at startup. Fail fast if invalid.
103
- - Feature flags for incremental rollouts.
104
94
  - Structured logging with correlation IDs. No PII in logs.
105
- - Measure latency, traffic, errors, saturation.
106
95
 
107
96
  ## Resilience
108
97
 
@@ -111,21 +100,11 @@ Before writing any code, stop at the first step that holds:
111
100
  - Only retry idempotent operations.
112
101
  - Circuit breakers for unhealthy dependencies.
113
102
  - Graceful degradation on non-critical dependency failures.
114
- - Cross-service calls must have timeouts and retries. Independent services own their data.
115
-
116
- ## Async and Events
117
-
118
- - Events are immutable. Consumers are idempotent.
119
- - Dead-letter queues for failed or poison messages.
120
- - Handle out-of-order events.
121
- - Background jobs: offload heavy processing (>500ms) to queues. Jobs have timeouts and retry limits.
122
- - SSE for one-way server-to-client. WebSockets only for true bidirectional.
123
- - Realtime connections degrade gracefully to polling.
124
103
 
125
104
  ## Response Style
126
105
 
127
106
  Write the smallest complete answer that lets the developer act correctly.
128
107
 
129
- Always remove: greetings, affirmations, narration about what you are about to do, padding paragraphs, generic closing offers.
108
+ Never add: greetings, affirmations, narration about what you are about to do, trailing summaries of what you just did, padding paragraphs, generic closing offers, or emoji.
130
109
 
131
110
  Always preserve: exact commands, file paths, line numbers, error messages, exit codes, validation status, assumptions, blockers, risks, and next actions.
@@ -21,10 +21,10 @@ Before writing any code, stop at the first step that holds:
21
21
 
22
22
  - Descriptive variable and function names. No cryptic abbreviations.
23
23
  - Early returns over deep nesting. Keep the main flow traceable.
24
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
25
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
24
+ - Three similar lines is better than a premature abstraction.
25
+ - Don't add features, refactor, or introduce abstractions beyond what the task requires.
26
+ - Don't design for hypothetical future requirements.
26
27
  - Delete code that carries no behavior, safety, or test value.
27
- - Plain English in documentation. No emoji in formal docs or review summaries.
28
28
 
29
29
  ## Architecture
30
30
 
@@ -33,7 +33,6 @@ Before writing any code, stop at the first step that holds:
33
33
  - Controllers handle protocol translation only. Business logic belongs in services.
34
34
  - Default to modular monolith unless scale evidence demands microservices.
35
35
  - Direction changes require explicit user confirmation.
36
- - Do not choose framework by habit. Match project evidence and needs.
37
36
 
38
37
  ## Security (never skip)
39
38
 
@@ -49,6 +48,7 @@ Before writing any code, stop at the first step that holds:
49
48
  ## Error Handling
50
49
 
51
50
  - Fail fast on invalid input.
51
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
52
52
  - Structured error responses with safe details only. Use standard error codes (RFC 9457 when applicable).
53
53
  - Distinguish client errors (4xx) from server errors (5xx).
54
54
  - No silent swallowing. Log operational errors with context.
@@ -69,8 +69,6 @@ Before writing any code, stop at the first step that holds:
69
69
  - Idempotent for side-effect mutations. Document retry behavior.
70
70
  - Backward-compatible by default. Version breaking changes explicitly.
71
71
  - Sync docs in the same commit when changing API, CLI, or schema.
72
- - Use OpenAPI 3.1 for HTTP APIs where applicable.
73
- - Document deprecation windows before sunsetting endpoints.
74
72
 
75
73
  ## Database
76
74
 
@@ -79,30 +77,21 @@ Before writing any code, stop at the first step that holds:
79
77
  - Multi-table mutations run inside transactions.
80
78
  - Monetary amounts: integer minor units or exact decimal. Never floats.
81
79
  - Timestamps in UTC. No naive timestamps.
82
- - Use optimistic concurrency tokens for shared mutable resources.
83
80
  - Schema changes require versioned, reversible migrations.
84
81
  - Never modify merged migrations. Create new ones.
85
- - Use concurrent index builds in production.
86
82
 
87
83
  ## Frontend
88
84
 
89
85
  - Semantic HTML before custom components.
90
- - WCAG 2.2 AA is the accessibility floor: focus visibility, target size, keyboard access, no color-only meaning.
91
- - Responsive by default. Recompose content for breakpoints, not just shrink.
92
- - Explicitly handle empty, loading, error, and offline states.
93
- - CSS logical properties for direction-sensitive layout.
94
- - Plan overflow, wrapping, truncation, and motion fallbacks.
86
+ - WCAG 2.2 AA is the accessibility floor.
87
+ - Responsive by default. Handle empty, loading, error, and offline states.
95
88
  - No placeholder, lorem, or TODO content in production UI.
96
- - Use component kits or headless primitives for behavior and accessibility when they fit.
97
89
 
98
90
  ## Infrastructure
99
91
 
100
92
  - Container configs: multi-stage builds, minimal base images, non-root users, no baked secrets.
101
- - Explicit healthchecks in production.
102
93
  - Configuration from environment, validated at startup. Fail fast if invalid.
103
- - Feature flags for incremental rollouts.
104
94
  - Structured logging with correlation IDs. No PII in logs.
105
- - Measure latency, traffic, errors, saturation.
106
95
 
107
96
  ## Resilience
108
97
 
@@ -111,21 +100,11 @@ Before writing any code, stop at the first step that holds:
111
100
  - Only retry idempotent operations.
112
101
  - Circuit breakers for unhealthy dependencies.
113
102
  - Graceful degradation on non-critical dependency failures.
114
- - Cross-service calls must have timeouts and retries. Independent services own their data.
115
-
116
- ## Async and Events
117
-
118
- - Events are immutable. Consumers are idempotent.
119
- - Dead-letter queues for failed or poison messages.
120
- - Handle out-of-order events.
121
- - Background jobs: offload heavy processing (>500ms) to queues. Jobs have timeouts and retry limits.
122
- - SSE for one-way server-to-client. WebSockets only for true bidirectional.
123
- - Realtime connections degrade gracefully to polling.
124
103
 
125
104
  ## Response Style
126
105
 
127
106
  Write the smallest complete answer that lets the developer act correctly.
128
107
 
129
- Always remove: greetings, affirmations, narration about what you are about to do, padding paragraphs, generic closing offers.
108
+ Never add: greetings, affirmations, narration about what you are about to do, trailing summaries of what you just did, padding paragraphs, generic closing offers, or emoji.
130
109
 
131
110
  Always preserve: exact commands, file paths, line numbers, error messages, exit codes, validation status, assumptions, blockers, risks, and next actions.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-senior-core",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "displayName": "Agentic Senior Core",
5
5
  "description": "Universal AI coding rules. Write code like a staff engineer.",
6
6
  "author": {
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-senior-core",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "description": "Universal AI coding rules. Write code like a staff engineer.",
5
5
  "author": {
6
6
  "name": "fatidaprilian",
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -21,8 +21,9 @@ Before writing any code, stop at the first step that holds:
21
21
 
22
22
  - Descriptive variable and function names. No cryptic abbreviations.
23
23
  - Early returns over deep nesting. Keep the main flow traceable.
24
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
25
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
24
+ - Three similar lines is better than a premature abstraction.
25
+ - Don't add features, refactor, or abstractions beyond what the task requires.
26
+ - Don't design for hypothetical future requirements.
26
27
  - Delete code that carries no behavior, safety, or test value.
27
28
 
28
29
  ## Architecture
@@ -31,7 +32,6 @@ Before writing any code, stop at the first step that holds:
31
32
  - No custom crypto, state management, or routing when standard libraries exist.
32
33
  - Controllers handle protocol translation only. Business logic belongs in services.
33
34
  - Default to modular monolith unless scale evidence demands microservices.
34
- - Do not choose framework by habit. Match project evidence and needs.
35
35
 
36
36
  ## Security (never skip)
37
37
 
@@ -45,6 +45,7 @@ Before writing any code, stop at the first step that holds:
45
45
  ## Error Handling
46
46
 
47
47
  - Fail fast on invalid input.
48
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
48
49
  - Structured error responses with safe details only.
49
50
  - Distinguish client errors (4xx) from server errors (5xx).
50
51
  - No silent swallowing. Log operational errors with context.
@@ -88,12 +89,6 @@ Before writing any code, stop at the first step that holds:
88
89
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
89
90
  - Circuit breakers for unhealthy dependencies.
90
91
 
91
- ## Async and Events
92
-
93
- - Events are immutable. Consumers are idempotent.
94
- - Dead-letter queues for failed messages.
95
- - Background jobs have timeouts and retry limits.
96
-
97
92
  ## Response Style
98
93
 
99
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
94
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-senior-core",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "description": "Universal AI coding rules. Write code like a staff engineer.",
5
5
  "author": {
6
6
  "name": "fatidaprilian",
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agentic-senior-core",
3
3
  "description": "Universal AI coding rules. Write code like a staff engineer.",
4
- "version": "5.3.0",
4
+ "version": "5.4.0",
5
5
  "author": {
6
6
  "name": "fatidaprilian",
7
7
  "url": "https://github.com/fatidaprilian"
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
package/AGENTS.md CHANGED
@@ -16,10 +16,10 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or introduce abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
- - Plain English in documentation. No emoji in formal docs or review summaries.
23
23
 
24
24
  ## Architecture
25
25
 
@@ -28,7 +28,6 @@ Before writing any code, stop at the first step that holds:
28
28
  - Controllers handle protocol translation only. Business logic belongs in services.
29
29
  - Default to modular monolith unless scale evidence demands microservices.
30
30
  - Direction changes require explicit user confirmation.
31
- - Do not choose framework by habit. Match project evidence and needs.
32
31
 
33
32
  ## Security (never skip)
34
33
 
@@ -44,6 +43,7 @@ Before writing any code, stop at the first step that holds:
44
43
  ## Error Handling
45
44
 
46
45
  - Fail fast on invalid input.
46
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
47
47
  - Structured error responses with safe details only. Use standard error codes (RFC 9457 when applicable).
48
48
  - Distinguish client errors (4xx) from server errors (5xx).
49
49
  - No silent swallowing. Log operational errors with context.
@@ -64,8 +64,6 @@ Before writing any code, stop at the first step that holds:
64
64
  - Idempotent for side-effect mutations. Document retry behavior.
65
65
  - Backward-compatible by default. Version breaking changes explicitly.
66
66
  - Sync docs in the same commit when changing API, CLI, or schema.
67
- - Use OpenAPI 3.1 for HTTP APIs where applicable.
68
- - Document deprecation windows before sunsetting endpoints.
69
67
 
70
68
  ## Database
71
69
 
@@ -74,30 +72,21 @@ Before writing any code, stop at the first step that holds:
74
72
  - Multi-table mutations run inside transactions.
75
73
  - Monetary amounts: integer minor units or exact decimal. Never floats.
76
74
  - Timestamps in UTC. No naive timestamps.
77
- - Use optimistic concurrency tokens for shared mutable resources.
78
75
  - Schema changes require versioned, reversible migrations.
79
76
  - Never modify merged migrations. Create new ones.
80
- - Use concurrent index builds in production.
81
77
 
82
78
  ## Frontend
83
79
 
84
80
  - Semantic HTML before custom components.
85
- - WCAG 2.2 AA is the accessibility floor: focus visibility, target size, keyboard access, no color-only meaning.
86
- - Responsive by default. Recompose content for breakpoints, not just shrink.
87
- - Explicitly handle empty, loading, error, and offline states.
88
- - CSS logical properties for direction-sensitive layout.
89
- - Plan overflow, wrapping, truncation, and motion fallbacks.
81
+ - WCAG 2.2 AA is the accessibility floor.
82
+ - Responsive by default. Handle empty, loading, error, and offline states.
90
83
  - No placeholder, lorem, or TODO content in production UI.
91
- - Use component kits or headless primitives for behavior and accessibility when they fit.
92
84
 
93
85
  ## Infrastructure
94
86
 
95
87
  - Container configs: multi-stage builds, minimal base images, non-root users, no baked secrets.
96
- - Explicit healthchecks in production.
97
88
  - Configuration from environment, validated at startup. Fail fast if invalid.
98
- - Feature flags for incremental rollouts.
99
89
  - Structured logging with correlation IDs. No PII in logs.
100
- - Measure latency, traffic, errors, saturation.
101
90
 
102
91
  ## Resilience
103
92
 
@@ -106,21 +95,11 @@ Before writing any code, stop at the first step that holds:
106
95
  - Only retry idempotent operations.
107
96
  - Circuit breakers for unhealthy dependencies.
108
97
  - Graceful degradation on non-critical dependency failures.
109
- - Cross-service calls must have timeouts and retries. Independent services own their data.
110
-
111
- ## Async and Events
112
-
113
- - Events are immutable. Consumers are idempotent.
114
- - Dead-letter queues for failed or poison messages.
115
- - Handle out-of-order events.
116
- - Background jobs: offload heavy processing (>500ms) to queues. Jobs have timeouts and retry limits.
117
- - SSE for one-way server-to-client. WebSockets only for true bidirectional.
118
- - Realtime connections degrade gracefully to polling.
119
98
 
120
99
  ## Response Style
121
100
 
122
101
  Write the smallest complete answer that lets the developer act correctly.
123
102
 
124
- Always remove: greetings, affirmations, narration about what you are about to do, padding paragraphs, generic closing offers.
103
+ Never add: greetings, affirmations, narration about what you are about to do, trailing summaries of what you just did, padding paragraphs, generic closing offers, or emoji.
125
104
 
126
105
  Always preserve: exact commands, file paths, line numbers, error messages, exit codes, validation status, assumptions, blockers, risks, and next actions.
package/CONVENTIONS.md CHANGED
@@ -16,8 +16,9 @@ Before writing any code, stop at the first step that holds:
16
16
 
17
17
  - Descriptive variable and function names. No cryptic abbreviations.
18
18
  - Early returns over deep nesting. Keep the main flow traceable.
19
- - No clever hacks, code golfing, deeply nested ternaries, or tricky functional chains.
20
- - No premature abstraction. Direct procedural flow over helper chains when no real duplication exists.
19
+ - Three similar lines is better than a premature abstraction.
20
+ - Don't add features, refactor, or abstractions beyond what the task requires.
21
+ - Don't design for hypothetical future requirements.
21
22
  - Delete code that carries no behavior, safety, or test value.
22
23
 
23
24
  ## Architecture
@@ -26,7 +27,6 @@ Before writing any code, stop at the first step that holds:
26
27
  - No custom crypto, state management, or routing when standard libraries exist.
27
28
  - Controllers handle protocol translation only. Business logic belongs in services.
28
29
  - Default to modular monolith unless scale evidence demands microservices.
29
- - Do not choose framework by habit. Match project evidence and needs.
30
30
 
31
31
  ## Security (never skip)
32
32
 
@@ -40,6 +40,7 @@ Before writing any code, stop at the first step that holds:
40
40
  ## Error Handling
41
41
 
42
42
  - Fail fast on invalid input.
43
+ - Don't add error handling for scenarios that can't happen. Only validate at system boundaries.
43
44
  - Structured error responses with safe details only.
44
45
  - Distinguish client errors (4xx) from server errors (5xx).
45
46
  - No silent swallowing. Log operational errors with context.
@@ -83,12 +84,6 @@ Before writing any code, stop at the first step that holds:
83
84
  - Retries use exponential backoff with jitter. Only retry idempotent operations.
84
85
  - Circuit breakers for unhealthy dependencies.
85
86
 
86
- ## Async and Events
87
-
88
- - Events are immutable. Consumers are idempotent.
89
- - Dead-letter queues for failed messages.
90
- - Background jobs have timeouts and retry limits.
91
-
92
87
  ## Response Style
93
88
 
94
- Write the smallest complete answer. Remove greetings, narration, padding. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
89
+ Write the smallest complete answer. Never add greetings, narration, trailing summaries, padding, or emoji. Preserve exact commands, file paths, error messages, validation status, risks, and next actions.
package/README.md CHANGED
@@ -200,20 +200,31 @@ Copies one file to `.openhands/microagents/agentic-senior-core.md`. Repeat per p
200
200
  Copy the rules file into your project's `.agents/rules/` directory:
201
201
 
202
202
  ```bash
203
+ # Create the directory first, then copy
204
+ mkdir -p .agents/rules
205
+
203
206
  # From the npm package (after Step 1)
204
207
  cp "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/rules/agentic-senior-core.md" .agents/rules/
205
208
  ```
206
209
 
210
+ PowerShell (Windows):
211
+ ```powershell
212
+ mkdir .agents\rules -Force
213
+ cp "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/rules/agentic-senior-core.md" .agents\rules\
214
+ ```
215
+
207
216
  Antigravity IDE reads it automatically with `trigger: always_on`.
208
217
 
209
218
  **Option B -- global plugin (all projects):**
210
219
 
211
220
  Copy the plugin bundle to Antigravity's global plugin directory:
212
221
 
213
- ```bash
222
+ ```powershell
214
223
  # Windows
215
224
  xcopy /E /I "%APPDATA%\npm\node_modules\@ryuenn3123\agentic-senior-core\.agents\plugins\agentic-senior-core" "%USERPROFILE%\.gemini\config\plugins\agentic-senior-core"
225
+ ```
216
226
 
227
+ ```bash
217
228
  # macOS / Linux
218
229
  cp -r "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/plugins/agentic-senior-core" ~/.gemini/config/plugins/
219
230
  ```
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-senior-core",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "description": "Universal AI coding rules. Write code like a staff engineer.",
5
5
  "author": "fatidaprilian",
6
6
  "license": "MIT",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ryuenn3123/agentic-senior-core",
3
- "version": "5.3.0",
3
+ "version": "5.4.0",
4
4
  "type": "module",
5
5
  "description": "Universal AI coding rules. Write code like a staff engineer, not a junior.",
6
6
  "bin": {