Coding Agent에 Context Hygiene 필요

코드 살아남고, rationale 썩는다

긴 coding session 후, 디스크 파일은 정확하지만 변경 이유는 context에서 사라지는 중일 수 있어. 다음 agent가 diff는 보지만 결정 trail, parallel-session 경고, 사람 authority boundary는 꼭 X.

그래서 coding agent에 live board, narrow staging, exact validation 노트, 운영 boundary 설명하는 commit message 필요. Test 통과는 필요, 전체 handoff X. Commit message는 chat history 없는 미래 instance가 cold로 읽을 수 있어야.

Stale 문서 blindly 신뢰 X

현재 source 읽기. 현재 git status check. 현재 route verify. 옛 history 도움, source가 object state. 모든 coding-agent turn의 첫 action은 reading-knowledge와 running-knowledge align.

Stage explicit, -A 절대 X

Multi-session repo의 git add -A는 context-poisoning move. 다른 워크플로의 무관한 dirty 파일 끌어와서 어느 누구도 — 사람도 다음 agent도 — intent 재구성 못 하는 commit 만들어. 이번 turn 건드린 path만 stage.

Code

Coding-agent context checklist·yaml

coding_context_checklist:
  - read repo instructions (CLAUDE.md, sibling overlays)
  - check git status (identify unrelated dirty files)
  - inspect target files
  - run focused validation (pytest path/to/test::case)
  - stage explicit paths only
  - write a commit message that future-instances can read cold
  - record commit/push boundary in handoff

Multi-session safe staging·bash

# Bad (in a repo other sessions also touch):
#   git add -A && git commit -m "..."

# Good:
git add backend/auth.py tests/test_auth.py
git commit --only \
  backend/auth.py tests/test_auth.py \
  -m "fix(auth): tighten session expiry check"

Coding Agent에 Context Hygiene 필요

코드 살아남고, rationale 썩는다

Stale 문서 blindly 신뢰 X

Stage explicit, -A 절대 X

Code

External links

Exercise

Progress

댓글 0