refactor(agent): .agents 통합 + AGENT.md 수칙 업데이트 + STATUS.md 도입 + end.md Wiki 동기화 개편
This commit is contained in:
@@ -113,22 +113,44 @@ C:\ProgramData\miniforge3\envs\variet-agent\python.exe .agent\workflows\helpers\
|
||||
|
||||
---
|
||||
|
||||
## 3. Wiki 동기화 (해당 시에만)
|
||||
## 3. 설계 문서 업데이트 (필수)
|
||||
|
||||
| 코드 변경 | 대상 Wiki |
|
||||
|-----------|----------|
|
||||
| 서버 변경 | Architecture |
|
||||
| 프론트엔드 변경 | Architecture |
|
||||
| 인프라 변경 | Architecture |
|
||||
| 새 모듈/패키지 추가 | Architecture |
|
||||
- [ ] `.agent/references/STATUS.md` — 모듈 상태 테이블 업데이트 (변경 있었다면)
|
||||
- 기능 추가/제거 → 기능 목록 테이블 업데이트
|
||||
- 모듈 변경 → 모듈 상태 + 최근 변경 업데이트
|
||||
- 마일스톤 달성 → 최근 마일스톤 추가
|
||||
- [ ] `.agent/references/architecture.md` — 구조 변경이 있었다면 업데이트
|
||||
|
||||
## 4. Wiki 동기화 (로컬 변경 기반)
|
||||
|
||||
로컬 references 파일이 변경되었는지 확인합니다:
|
||||
|
||||
```powershell
|
||||
C:\ProgramData\miniforge3\envs\variet-agent\python.exe .agent\workflows\helpers\wiki_helper.py update "Architecture" /tmp/wiki_content.md
|
||||
git diff --name-only .agent/references/
|
||||
```
|
||||
|
||||
변경된 파일이 있으면 **파일별로** Wiki에 업로드합니다:
|
||||
|
||||
| 로컬 파일 | Wiki 페이지 |
|
||||
|-----------|------------|
|
||||
| `STATUS.md` | "Status" |
|
||||
| `architecture.md` | "Architecture" |
|
||||
|
||||
```powershell
|
||||
# STATUS.md가 변경된 경우
|
||||
C:\ProgramData\miniforge3\envs\variet-agent\python.exe .agent\workflows\helpers\wiki_helper.py update "Status" .agent\references\STATUS.md
|
||||
```
|
||||
```powershell
|
||||
# architecture.md가 변경된 경우
|
||||
C:\ProgramData\miniforge3\envs\variet-agent\python.exe .agent\workflows\helpers\wiki_helper.py update "Architecture" .agent\references\architecture.md
|
||||
```
|
||||
|
||||
> [!TIP]
|
||||
> 변경된 파일이 없으면 이 단계를 건너뜁니다.
|
||||
|
||||
---
|
||||
|
||||
## 4. Git Commit & Push
|
||||
## 5. Git Commit & Push
|
||||
|
||||
```powershell
|
||||
git add -A
|
||||
@@ -151,7 +173,7 @@ scope: (선택)
|
||||
|
||||
---
|
||||
|
||||
## 5. 최종 체크리스트
|
||||
## 6. 최종 체크리스트
|
||||
|
||||
> [!WARNING]
|
||||
> 아래 항목 중 하나라도 누락되면 세션 종료를 완료할 수 없습니다.
|
||||
@@ -160,6 +182,7 @@ scope: (선택)
|
||||
- [ ] devlog index 업데이트됨
|
||||
- [ ] devlog entry 작성됨 (필요한 경우만)
|
||||
- [ ] Vikunja 태스크 생성/완료 처리됨 (커밋 전수 검사 기반)
|
||||
- [ ] Wiki 동기화됨 (아키텍처 변경이 있었다면)
|
||||
- [ ] STATUS.md 업데이트됨 (모듈/기능 변경이 있었다면)
|
||||
- [ ] Wiki 동기화됨 (변경된 references 파일이 있었다면)
|
||||
- [ ] git push 완료
|
||||
- [ ] 사용자에게 완료 보고
|
||||
|
||||
@@ -10,7 +10,7 @@ description: 모든 구현 작업 전 실행하는 사전 점검 체크리스트
|
||||
|
||||
> [!CAUTION]
|
||||
> **Python 실행 시 반드시 절대경로 사용** (conda 환경이라 `python`이 PATH에 없음):
|
||||
> `C:\ProgramData\miniforge3\envs\agent_chat\python.exe`
|
||||
> `C:\ProgramData\miniforge3\envs\variet-agent\python.exe`
|
||||
> 절대로 `python`, `py`, `python.exe`를 단독으로 쓰지 마세요.
|
||||
|
||||
## 1단계: 요구사항 정리
|
||||
|
||||
@@ -14,6 +14,7 @@ description: 세션 시작 시 프로젝트 맥락을 빠르게 복구하는 워
|
||||
|
||||
`.agent/AGENT.md`를 읽고 에이전트 행동 규칙을 로딩합니다.
|
||||
`.agent/references/known-issues.md`를 읽어 최근 이슈를 파악합니다.
|
||||
`.agent/references/STATUS.md`를 읽어 전체 설계 현황과 기능 목록을 파악합니다.
|
||||
|
||||
### 1. Devlog 맥락 복구
|
||||
|
||||
|
||||
Reference in New Issue
Block a user