docs(agent): add anti-local-thinking rules — NEVER #10 strengthen (disprove before report), NEVER #11 (no mechanical apply), ALWAYS #9 (project history cross-ref), Bug Report Protocol

This commit is contained in:
2026-03-15 23:26:54 +09:00
parent c9f44afcf1
commit 9b93ee9776
2 changed files with 53 additions and 1 deletions

View File

@@ -19,7 +19,13 @@ description: 모든 작업에 자동 적용되는 에이전트 행동 규칙.
7. NEVER truncate error messages — always show the full error output
8. NEVER say "구현 완료" or "동작 확인" without ACTUAL end-to-end test — import/문법 통과는 검증이 아님
9. NEVER confuse "코드가 논리적으로 맞음" with "실제로 동작함" — 실행 로그가 없으면 미검증
10. NEVER fix code by looking at only the immediate file — always trace the full data flow across ALL affected files (producer → consumer → side effects) before proposing a fix
10. NEVER fix or audit code by looking at only the immediate file:
(a) Open the PRODUCER (who creates the data?) and CONSUMER (who reads/deletes?)
(b) Search for defense mechanisms (try-catch, dedup, idempotency guards)
(c) DISPROVE the bug before reporting — if a defense exists, it may be a false positive
(d) Report only bugs with a proven end-to-end triggering path
"I traced the flow" without opening actual files = violation.
11. NEVER apply changes mechanically across files — every import, variable, function must have at least one callsite in the SAME file
## ALWAYS (필수)
@@ -31,6 +37,7 @@ description: 모든 작업에 자동 적용되는 에이전트 행동 규칙.
6. ALWAYS read related existing code (minimum 3 files) before writing new code
7. ALWAYS verify with real execution after implementation — trigger the actual flow, check logs (e.g. extension.log), confirm the expected result appeared
8. ALWAYS distinguish "구현했다" vs "검증했다" when reporting to user — 테스트 안 했으면 명시
9. ALWAYS cross-reference with project history (devlog, git log -5, Vikunja) when evaluating system state — code absence may mean "intentionally removed" or "deployed externally", not "unimplemented"
## Failure Protocol
@@ -52,6 +59,10 @@ description: 모든 작업에 자동 적용되는 에이전트 행동 규칙.
4. `.agents/workflows/services.md` (service credentials & protocols)
5. `.agents/workflows/` (action procedures)
## Bug Report Protocol
→ See `.agents/references/bug-report-protocol.md`
## PowerShell Notes
- `curl` → PowerShell에서 `Invoke-WebRequest` 별칭. **반드시 `curl.exe`** 사용