junghanacs🧠

Backlinks

† #수선 #정비 #유지보수 #일관성

ᨒ Sourceᨒ Blameᨒ History ↗

Created: Modified: 8 min read

이 노트에 대하여

수선은 글의 내용을 비평하거나 문장을 첨삭하는 일과 다르다. 여기서는 노트의 얼굴, 섹션, 링크, 태그, 파일명, 히스토리를 돌보며 가든 전체의 일관성과 회수 가능성을 회복하는 유지보수의 언어로 다룬다.

히스토리

  • [2026-06-15 Mon 10:16] 비둘기 메타에서 수선·정비·유지보수 메타로 용도 전환. 비둘기 의미축은 봇로그로 옮기고 연결만 남김.
  • [2024-11-26 Tue 05:37] 생성 — 원래 비둘기 메타로 시작

관련메타

관련노트

KEYWORDS

수선은 가든의 유지보수다

수선은 새 글을 쓰는 일이 아니라, 이미 있는 노트가 제자리를 다시 찾도록 돕는 일이다. 깨진 링크를 고치고, 흩어진 섹션 이름을 맞추고, 제목·태그·설명·초록이 실제 내용을 가리키게 만들고, 오래된 흔적은 히스토리로 보존한다.

이때 수선은 단순한 청소가 아니다. 형식이 맞아야 사람이 다시 읽을 수 있고, 에이전트가 안전하게 이어 쓸 수 있으며, 검색과 임베딩이 덜 헤맨다. 수선은 가든의 미관이 아니라 회수 가능성, 연결성, 협업 가능성을 지키는 유지보수다.

비평·교열·수정과의 경계

비평, 교열, 첨삭, 수정은 주로 글의 내용과 문장에 개입한다. 논지가 맞는지, 문장이 자연스러운지, 표현이 더 정확한지 묻는다.

수선은 그보다 바깥의 구조를 본다. 이 노트가 어느 메타에 붙어야 하는지, 관련노트와 관련메타가 분리되어 있는지, 히스토리가 보존되는지, 파일명과 front matter가 서로 맞는지, 태그가 검색 자석으로 작동하는지를 본다. 둘 다 “고침”이지만 수선의 대상은 문장보다 가든의 구조다.

mend / repair / maintenance

mend 는 찢어진 것을 꿰매는 말이다. 완전히 새로 만들지 않고, 남아 있는 결을 살려 다시 쓸 수 있게 한다. 그래서 가든의 수선은 삭제와 재작성보다 보존과 재배치에 가깝다.

repair 는 고장 난 기능을 회복하는 말이다. 깨진 링크, 어긋난 파일명, 누락된 description, 비어 있는 scaffold, 잘못된 태그처럼 노트의 기능을 떨어뜨리는 부분을 고친다.

maintenance 는 망가지기 전에 계속 돌보는 말이다. 가든은 한 번 정리해 끝나는 창고가 아니라 계속 자라는 정원이다. 그러므로 유지보수는 예외 상황의 처리가 아니라 지식가든의 일상적 호흡이다.

수선의 원칙

  • ID는 보존한다. ID는 공개된 영속 신원이다.
  • 히스토리는 덮지 않고 위에 더한다.
  • 역링크의 표시 텍스트는 다른 노트의 시간 흔적이므로 함부로 고치지 않는다.
  • 제목, 태그, description, abstract, 파일명은 서로 같은 방향을 가리켜야 한다.
  • 빈 scaffold를 남발하지 않고, 실제 연결이 있을 때 관련메타와 관련노트를 채운다.
  • 기계적 일괄치환보다 노트를 읽고 판단하는 수선을 우선한다.

왜 에이전트에게 중요한가

에이전트는 노트 하나를 보고 이어 쓴다. 노트의 얼굴과 구조가 흔들리면 에이전트는 잘못된 자석에 붙거나, 같은 일을 다시 만들거나, 오래된 맥락을 현재 사실로 오해한다. 반대로 수선된 노트는 적은 토큰으로 더 많은 맥락을 전달한다.

그래서 수선은 에이전트 협업 인프라다. 사람에게는 읽기 좋은 가든을 만들고, 에이전트에게는 안전하게 손댈 수 있는 작업면을 만든다. 가든의 정비는 지식의 보존이면서 동시에 미래의 협업자를 맞이하는 예절이다.

Comments

Backlinks