simonpokorny/knowledgebase

저장소의 .knowledgebase/에 작고 스키마가 깨끗한 항목 하나를 작성합니다. 저장소에 .knowledgebase/가 없으면 중단하고 사용자에게 먼저 /setup-knowledgebase 스킬을 실행하라고 알립니다.

1. 유형 선택:

   대상	유형	경로
   시스템에 대한 주장으로, 사실이며 다시 발견할 가치가 있는 것	finding	.knowledgebase/entries/finding-<주제-케밥>.md
   행동 규칙으로, 보통 실수로부터 비롯된 것	learning	.knowledgebase/entries/learning-<주제-케밥>.md
   대안 간의 선택으로, 트레이드오프가 있는 것	decision	.knowledgebase/entries/decision-NNNN-<주제-케밥>.md

2. 항목을 작성합니다. 프론트매터 필드, 상태, 제한 사항 및 본문 규칙은 ENTRY-FORMAT.md에 있습니다. 작성하기 전에 이 파일을 읽으십시오. 작업 예제는 이 플러그인의 templates/ 디렉토리에 함께 제공됩니다.

3. 상태가 정직한지 확인합니다. findings와 learnings의 경우: verified는 이 세션에서 직접 주장을 증명한 경우에만 설정하며, 그런 다음 verified-by: agent를 설정하고 본문에 증거(Source 링크 또는 실행한 검사)를 포함합니다. 증명할 수 없는 것은 unverified로 유지합니다. 이러한 항목은 사람이 검토 시 확인하도록 요청됩니다. 새로운 decisions는 status: decided를 가지며 두 가지 종류가 있습니다:

   • 구현 결정(Implementation decisions): 빌드 중 직접 내린 근본적인 선택. 이유와 트레이드오프를 기록하고 decided-by: agent로 설정합니다.
   • 계획 결정(Planning decisions): 사용자와 함께 내린 결정으로, 코드에서 추론할 수 없는 것. decided-by: agent로 기록한 다음, 세션 종료 보고서에서 adopt 라인을 사용자에게 전달하여 항목이 decided-by: human이 되도록 합니다. decided-by: human을 직접 설정하지 마십시오. 오직 사람만 설정합니다. 두 종류 모두 이후에 새로운 결정에 의해 superseded될 수 있습니다.

4. 항목이 명령을 금지하는 learning인 경우 guard: 정규식을 추가하여 규칙이 스스로 강제되도록 합니다. 가드 작성 규칙은 ENTRY-FORMAT.md에 있습니다. 정규식을 grep -E로 테스트한 후 커밋하십시오.

5. 항목을 생성한 변경 사항과 동일한 브랜치에 커밋하여 동일한 커밋에 포함되도록 합니다. 항목을 모아서 나중에 커밋하지 마십시오.