/ingest
원시 자료를 가져와서 검색 가능한 지식으로 만듭니다. 이것은 지식을 쌓아두지 않고 성장시키는 작업입니다.
절대 건드리지 말아야 할 규칙: 원시 자료는 절대 수정하지 않습니다. 다시 쓰지도, 이름을 바꾸지도, 재정렬하지도 않으며, 보기 흉하거나 중복되어도 삭제하지 않습니다. 6개월 후에 wiki 페이지가 잘못된 것처럼 보일 때, 이를 확인할 수 있는 유일한 방법은 출처로 돌아가는 것입니다. 출처를 건드렸다면 돌아갈 곳이 없습니다.
순서대로 할 일
1. 자료 찾기
memoria/grezzo/를 확인합니다. 사용자가 파일을 지정했다면 그 파일을 사용합니다. 아무것도 지정하지 않았다면 아직 memoria/wiki/index.md에 없는 파일을 가져옵니다.
grezzo/에 아무것도 없으면 알리고 중단합니다: "grezzo가 비어 있습니다. 무언가를 넣고 다시 실행해주세요."
2. 읽기
| 유형 | 방법 |
|---|---|
.md, .txt, .csv, .json | Read |
.pdf | Read로 PDF 직접 읽기 |
| URL | WebFetch |
| 오디오, 비디오 | 전사본이 필요합니다: 사용자에게 grezzo에 전사본을 넣어달라고 요청하고, 파일 이름만으로 내용을 추측하지 마세요 |
열 수 없는 형식이면 알리고 나머지를 계속 진행합니다. 읽지 않은 척 하거나 파일 제목만으로 요약하지 마세요.
3. 페이지 쓰기
하나의 출처는 memoria/wiki/ 안에 하나 이상의 페이지가 되며, 하나의 요약이 아닙니다. 각 주제(고객, 개념, 결정, 프로세스)에 대해 하나의 페이지를 만듭니다.
페이지의 조건:
- 짧게: 한 화면을 넘으면 두 페이지로 나눕니다
- 자립적: 출처를 읽지 않아도 이해할 수 있어야 합니다
- 연결됨: 문장 안에
[[파일-이름]]형식으로 다른 페이지를 언급하며, 마지막에 목록으로 나열하지 않습니다 - 출처 명시: 상단에 어느 grezzo 파일에서 왔는지 표시하여 검증 가능하게 만듭니다
파일 이름이 모든 것을 지탱하는 규칙입니다. 페이지는 주제 이름으로, 소문자와 하이픈을 사용하여 명명합니다: Rossi Srl 고객은 rossi-srl.md에 있으며, 언급할 때마다 [[rossi-srl]]이라고 씁니다. 링크는 항상 .md 확장자 없이 파일 이름 자체입니다. 이렇게 하면 링크를 따라가면 해당 파일이 열리며, 추측할 필요 없이 기억 속에서 페이지를 건너뛰며 탐색할 수 있습니다. 링크와 파일 이름이 일치하지 않으면 탐색이 깨집니다.
아래는 rossi-srl.md 페이지 예시입니다:
---
fonte: memoria/grezzo/call-rossi-2026-03-14.md
data: 2026-03-14
---
Rossi Srl는 28일 이내에 지불하며 항상 정시에 지불해 왔습니다. 3월 [[marco]]와의 통화에서 회계연도 말일로 송장 발행일을 변경해 달라고 요청했습니다. 해당 회사의 구매 부서는 30일에 마감되기 때문입니다. [[fatturazione]]도 참조하세요.
해당 주제에 대한 페이지가 이미 존재하면 새 페이지를 만들지 말고 업데이트합니다. 동일한 고객에 대한 두 페이지는 wiki가 더 이상 유용하지 않게 되는 방법입니다.
새로운 출처가 기존 내용과 모순되면, 기존 내용을 삭제하지 말고 변경되었음을 명시하고 언제부터인지 적습니다. "3월에는 28일 이내에 지불했지만, 7월부터는 60일로 변경되었습니다"는 단순히 "60"으로 다시 쓰는 것보다 가치가 있습니다. 왜냐하면 변경 자체가 정보이기 때문입니다: 다음에 해당 고객이 기한을 초과할 때, 이것이 일시적인 이상인지 새로운 표준인지 알 수 있습니다. 모순을 표시하는 것은 기억이 유용한 이유의 절반입니다.
4. 인덱스와 로그 업데이트
항상, 그리고 같은 작업에서 함께 수행합니다.
memoria/wiki/index.md: 각 페이지당 한 줄, 연결과 함께. 인덱스에 없는 페이지는 아무도 찾을 수 없습니다.
memoria/wiki/log.md: 상단에 항목을 추가합니다.
## [2026-03-14 16:20] ingest | Rossi 3월 14일 통화 전사본
세 페이지: [[rossi-srl]] (신규), [[fatturazione]] 및 [[marco]] (업데이트됨).
첫 번째 줄 형식 ## [날짜] 유형 | 제목은 단순한 장식이 아닙니다: 로그를 단일 명령(grep "^## \[" memoria/wiki/log.md)으로 읽을 수 있게 유지하며, 항목이 100개가 되어도 그렇습니다.
5. 수행한 작업 알리기
세 줄 이내로 알립니다. 무엇을 읽었는지, 몇 페이지를 다루었는지, 그리고 이전에 없었던 새로 알게 된 한 가지. 마지막 항목이 사용자에게 작업이 유용했음을 깨닫게 해줍니다.
하지 말아야 할 실수
| 실수 | 이유 |
|---|---|
| grezzo 파일 수정 또는 이름 변경 | 유일하게 검증 가능한 것을 잃습니다 |
| 모든 것을 하나의 페이지에 넣기 | 재사용 불가, 연결 불가, 업데이트 불가 |
[[링크]] 없는 페이지 | 기억이 아닌 파일 폴더가 됩니다 |
| 파일 이름과 일치하지 않는 링크 | 링크를 따라가는 것이 추측이 되며 탐색이 깨집니다 |
| 변경 사실을 언급하지 않고 이전 데이터를 새 데이터로 덮어쓰기 | 정보였던 변경 사항을 잃습니다 |
| 열 수 없는 파일을 요약하기 | 진짜처럼 보이지만 사실 거짓입니다 |
페이지를 쓰고 index.md를 잊기 | 쓴 페이지가 무용지물이 됩니다 |
| 이미 존재하는 주제에 두 번째 페이지 추가 | 이후 두 페이지 모두 신뢰할 수 없게 됩니다 |