fix: resolve 4 major architectural deadlock and OS dependency bugs

This commit is contained in:
2026-03-28 23:00:40 +09:00
parent 1ba0ae97f9
commit 471f79e18e
4 changed files with 64 additions and 6 deletions

View File

@@ -12,7 +12,7 @@ description: Universal Agent Lifecycle SOP
작업 착수 전, 무지성 코딩을 금지하며 **인간이 수정한 위키를 1순위로 흡수**합니다.
* **[Read] 전사 규정 탐색:** `.knowledge/global_wiki/` (Wiki.js Clone) 를 탐색해 프로젝트 언어(TS, Python 등) 컨벤션과 UI 토큰을 습득하십시오.
* **[Read] 기획/언어 바인딩:** `.knowledge/project_wiki/tech_stack.md` 를 읽고 사용할 패키지 매니저(`npm`, `pip`)와 프레임워크를 종속하십시오.
* **[Read] 기획/언어 바인딩:** `.knowledge/project_wiki/tech_stack.md` 가 존재할 경우 이를 최우선으로 읽고, 만약 아직 위키 연동 전이라 파일이 없다면 절대 멈추지 말고 `package.json`이나 `PROJECT.md` 등 로컬 환경을 분석하여 언어와 패키지 매니저를 유추하십시오.
* **[Sync] Git 충돌 방어망:** 로컬의 위키 파일을 열어보거나 수정하기 전, **무조건 `.knowledge/project_wiki` 폴더 안에서 `git pull --rebase origin main`을 실행하여 원격(웹) 수정본을 먼저 흡수**하십시오. (충돌 시 인간의 코드 우선).
* **[Setup] 무결점 캡슐화 준수:** 에이전트 구동용 `mcp.json``.agent/config/mcp.json`에 숨겨져 있으며, 에이전트 전용 패키지는 `.agent/env/package.json`에 숨겨져 있습니다. 루트(Root)를 오염시키지 말고 반드시 숨겨진 경로를 참조하십시오.
@@ -38,4 +38,4 @@ description: Universal Agent Lifecycle SOP
1. **Devlog (일일 개발 일지) 작성:** 단순 코드 외에 '설계 결정(왜 A 대신 B를 택했나)', '미완료 사항', '트러블슈팅'이 있었다면, 반드시 **`.knowledge/project_wiki/devlog/YYYY-MM-DD.md`** 에 양방향 링크(`[[문서명]]`)를 써서 기록합니다 (기존 과거 Devlog 시스템 완벽 계승).
2. **Wiki 자동 동기화:** 코드의 아키텍처나 API가 변경된 경우, `obsidian-skills` 프롬프트를 바탕으로 `.knowledge/project_wiki/` 내부 문서를 최신화하고 `git push`를 날려 인간의 웹 뷰(Gitea Wiki)를 갱신합니다.
3. **Vikunja 하이라키 동기화:** 로컬의 Get-Shit-Done(GSD) `.planning/` 단계에서 한 에픽(Phase)이 완전히 끝났을 때만, 해당 커밋 해시와 작업 내역을 묶어 회사의 거시적 태스크 보드인 **Vikunja 웹 대시보드**에 1회 매핑 및 `Done` 처리 하십시오. (마이크로 태스크의 잦은 복사 금지).
3. **Vikunja 하이라키 동기화 (PROJECT 모드 한정):** `.agent/config/.env.agent``AGENT_OPERATING_MODE``PROJECT`일 경우에 한하여, 로컬의 Get-Shit-Done(GSD) `.planning/` 단계에서 한 에픽(Phase)이 완전히 끝났을 때 해당 커밋 해시와 작업 내역을 묶어 **Vikunja 웹 대시보드**에 1회 매핑 및 `Done` 처리 하십시오. (마이크로 태스크의 잦은 복사 금지. TEST 모드일 경우 이 동기화를 강제로 스킵합니다).