# Show GN: project-context, 에이전트가 프로젝트 맥락을 파일 기반으로 남기는 스킬

> Clean Markdown view of GeekNews topic #27467. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27467](https://news.hada.io/topic?id=27467)
- GeekNews Markdown: [https://news.hada.io/topic/27467.md](https://news.hada.io/topic/27467.md)
- Type: show
- Author: [perhapsspy](https://news.hada.io/@perhapsspy)
- Published: 2026-03-13T20:16:33+09:00
- Updated: 2026-03-13T20:16:33+09:00
- Original source: [github.com/perhapsspy](https://github.com/perhapsspy/project-context)
- Points: 4
- Comments: 0

## Topic Body

에이전트로 프로젝트를 만들고 운영하다 보면  
프로젝트 단위의 맥락을 계속 남겨두고 싶어집니다.  
그래야 다음 세션에서도 적은 토큰으로 현재 상태를 읽고  
작업을 이어가기 쉬워지니까요.  
  
여러 프로젝트를 거치며 이 맥락을 어떻게 남기는 게 좋을지 계속 시도했고,  
결국 docs 폴더 안에 사람과 에이전트가 함께 볼 수 있는 형태로  
작업 상태와 참고 맥락을 남기는 방향으로 정리했습니다.  
에이전트는 작업 중 중요한 내용을 스스로 기록하고,  
반복적으로 필요한 내용은 참고 문서로 남겨 재활용할 수 있습니다.  
  
이건 프로젝트를 완전히 문서화하거나  
거대한 지식베이스를 만드는 접근은 아닙니다.  
목표는 프로젝트 맥락의 기준선을  
가능한 한 자동으로 유지하는 것입니다.  
  
처음엔 더 복잡한 구조도 고민했고 시행착오도 꽤 있었지만,  
결국 에이전트가 파일 검색만으로도 충분히 잘 동작해서  
가벼운 파일 기반 구조로 정리할 수 있었습니다.  
  
설치 후 AGENTS.md에 이 스킬을 사용하라고 적어두면 되고,  
기존에 정리해둔 맥락을 project-context 구조로 옮길 수 있는  
마이그레이션 스킬도 함께 넣어두었습니다.  
  
써보시고 피드백 주시면 감사하겠습니다.  
  
설치: `npx skills add perhapsspy/project-context`  
  
이 스킬은 전에 올렸던 [$structure-first](https://news.hada.io/topic?id=26530) 의 후속 스킬입니다.   
같이 쓰면 더 좋고, 둘 다 에이전트를 사용할 때 산출물의 기준선을 올리는 방향으로 만들었습니다.

## Comments



_No public comments on this page._