Skip to content

Commit 624df25

Browse files
committed
robustness improvement on pino-mirror.ts
1 parent 7e951e2 commit 624df25

3 files changed

Lines changed: 556 additions & 26 deletions

File tree

AGENTS.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,70 @@
11
# AGENTS.md
22

3-
Behavioral guidelines reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
3+
Behavioral rules cut LLM coding mistakes. Merge with project instructions as needed.
44

5-
**Tradeoff:** Guidelines bias caution over speed. Trivial tasks, use judgment.
5+
**Tradeoff:** Rules bias caution over speed. Trivial task, use judgment.
66

77
## 1. Think Before Coding
88

9-
**Don't assume. Don't hide confusion. Surface tradeoffs.**
9+
**No assume. No hide confusion. Surface tradeoffs.**
1010

11-
Before implementing:
12-
- State assumptions explicitly. Uncertain, ask.
13-
- Multiple interpretations exist, present them - don't pick silently.
14-
- Simpler approach exists, say so. Push back when warranted.
11+
Before code:
12+
- State assumptions. Unsure, ask.
13+
- Multiple readings, show them - no silent pick.
14+
- Simpler way exist, say. Push back when right.
1515
- Unclear, stop. Name confusion. Ask.
1616

1717
## 2. Simplicity First
1818

19-
**Minimum code solves problem. Nothing speculative.**
19+
**Min code solve problem. Nothing speculative.**
2020

2121
- No features beyond ask.
2222
- No abstractions for single-use code.
2323
- No "flexibility" or "configurability" unrequested.
24-
- No error handling for impossible scenarios.
25-
- Write 200 lines, could be 50, rewrite.
24+
- No error handling for impossible cases.
25+
- Wrote 200 lines, could be 50, rewrite.
2626

27-
Ask: "Would senior engineer say overcomplicated?" If yes, simplify.
27+
Ask: "Would senior engineer call overcomplicated?" Yes, simplify.
2828

2929
## 3. Surgical Changes
3030

31-
**Touch only what you must. Clean up only own mess.**
31+
**Touch only what must. Clean only own mess.**
3232

3333
Editing existing code:
34-
- Don't "improve" adjacent code, comments, formatting.
35-
- Don't refactor unbroken things.
34+
- No "improve" adjacent code, comments, formatting.
35+
- No refactor unbroken things.
3636
- Match existing style, even if you'd differ.
37-
- Notice unrelated dead code, mention - don't delete.
37+
- Spot unrelated dead code, mention - no delete.
3838

39-
Changes create orphans:
39+
Changes make orphans:
4040
- Remove imports/variables/functions YOUR changes made unused.
41-
- Don't remove pre-existing dead code unless asked.
41+
- No remove pre-existing dead code unless asked.
4242

43-
Test: Every changed line traces directly to user request.
43+
Test: every changed line trace to user request.
4444

4545
## 4. Goal-Driven Execution
4646

47-
**Define success criteria. Loop until verified.**
47+
**Define success. Loop until verified.**
4848

49-
Transform tasks into verifiable goals:
49+
Turn tasks into verifiable goals:
5050
- "Add validation" → "Write tests for invalid inputs, then make them pass"
5151
- "Fix the bug" → "Write a test that reproduces it, then make it pass"
5252
- "Refactor X" → "Ensure tests pass before and after"
5353

54-
Multi-step tasks, state brief plan:
54+
Multi-step task, state brief plan:
5555
```
5656
1. [Step] → verify: [check]
5757
2. [Step] → verify: [check]
5858
3. [Step] → verify: [check]
5959
```
6060

61-
Strong success criteria enable independent loop. Weak criteria ("make it work") require constant clarification.
61+
Strong criteria = independent loop. Weak criteria ("make it work") = constant clarification.
6262

6363
## 5. Coding Standards
6464

65-
- Follow TDD: failing test precedes production logic (red → green → refactor).
66-
- Apply SOLID; can't articulate why change doesn't violate one of five, probably does.
65+
- TDD: failing test before production logic (red → green → refactor).
66+
- Apply SOLID; can't say why change no violate one of five, probably does.
6767

6868
---
6969

70-
**Guidelines working if:** fewer unnecessary changes in diffs, fewer rewrites from overcomplication, clarifying questions precede implementation, every behavior change ships with passing test.
70+
**Rules working if:** fewer needless changes in diffs, fewer rewrites from overcomplication, clarifying questions before code, every behavior change ships with passing test.

0 commit comments

Comments
 (0)