ECdison6227/project-guardian-cheap-code-delegate

Project Guardian

프로젝트 경계에서 이 스킬을 사용하세요:

• 프로젝트 시작 시.
• 컨텍스트 손실 또는 새 스레드 이후 재개 시.
• 주요 편집 전.
• 파일 수정 후.
• 저비용 작업자가 패치를 생성한 후.
• 작업 세션 종료 시.
• 마지막 메모리 체크포인트로부터 30분 경과 후.

핵심 책임

• .ai/memory/에 프로젝트 메모리 유지.
• .ai/state.json에 기계 판독 가능 상태 유지.
• git 규율 강제: 초기화, 스테이징, 자동 커밋. git을 언급만 하지 말고 실행하세요.
• 브랜치 안전성 유지.
• 변경된 파일 요약.
• 푸시, 리셋, 클린, 배포 또는 파괴적 명령을 자동으로 실행하지 않음.

시작 또는 재개

1. .ai/state.json이 존재하는지 확인.
2. .ai/memory/ 파일이 있으면 읽기.
3. git status --short --branch 확인.
4. git 저장소가 아니면 git init 자동 실행.
5. main 또는 master 브랜치에 있으면 사용자에게 ai/<task> 브랜치를 제안하되, 확인 없이 생성하지 않음.
6. 새 작업을 수행하기 전에 간결한 재개 요약 생성.

헬퍼:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

메모리 초기화

프로젝트에 메모리가 없을 때 헬퍼 사용:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

헬퍼가 생성하는 항목:

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

또한 디렉터리가 git 저장소가 아니면 git init을 실행합니다.

편집 후

1. git 상태 및 diff 요약 실행.
2. 변경된 파일 요약.
3. 유용하다면 저비용 체크포인트 작성을 위해 cheap-code-delegate 사용.
4. 메모리 체크포인트 자동 작성.
5. git add -A 및 git commit -m "checkpoint: <summary>" 자동 실행.
6. 사용자가 명시적으로 요청하거나 --push를 전달하지 않으면 푸시하지 않음.

헬퍼:

# 로컬 자동 커밋
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# 자동 커밋 및 푸시 (명시적 의도 필요)
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

논문 프로젝트

프로젝트가 논문 또는 학위 논문인 경우:

• .ai/memory/PAPER_CONTEXT.md 유지.
• 초록, 서론, 관련 연구, 방법, 실험, 한계, 결론, 참고문헌, 그림, 표, 수식 추적.
• 편집 후 사용자에게 섹션 간 일관성, 인용 및 번호 매기기를 확인하도록 알림.

자동 실행

다음을 자동으로 실행:

• 디렉터리가 git 저장소가 아닐 때 git init.
• 체크포인트 작성 시 git add -A.
• 체크포인트 작성 시 git commit.
• .ai/memory 체크포인트 작성.

명시적 사용자 확인 필요

자동으로 실행하지 않음:

• git push
• git reset
• git clean
• 파괴적 체크아웃
• rm -rf
• 배포
• 프로덕션 명령
• 자동 제안된 ai/<task> 브랜치 외의 브랜치 생성

참조

필요할 때만 로드:

• references/memory-schema.md: .ai/ 파일 책임.
• references/git-safety.md: 안전한 git 워크플로.
• references/paper-projects.md: 논문 메모리 지침.