Hans11609/planning-with-files

planning-with-files은(는) 무엇을 하나요?

🗂️ 마크다운 파일을 활용한 영구적인 계획 수립, 진행 상황 추적, 지식 저장으로 작업 흐름을 혁신하세요. Manus의 성공에서 영감을 받았습니다.

개요

planning-with-files 기술은 AI 에이전트(Claude Code, Cursor, Codex 등)를 사용하여 프로젝트를 관리할 때, 모든 계획과 진행 상황을 마크다운 파일에 저장함으로써 작업의 지속성과 일관성을 보장합니다.

주요 기능

• 영구 계획: 프로젝트의 목표, 일정, 작업 항목을 .md 파일로 저장합니다.
• 진행 추적: 각 작업의 상태(예: ✅ 완료, 🔄 진행 중, ⏳ 대기 중)를 업데이트합니다.
• 지식 저장: 학습한 내용, 결정 사항, 참고 자료를 구조화된 문서로 보관합니다.
• 컨텍스트 공유: 여러 에이전트 세션 간에 작업 맥락을 유지합니다.

사용 방법

1. 초기화: 프로젝트 루트에 plan.md 파일을 생성하고, 다음 템플릿을 사용합니다.

# 프로젝트 계획

## 목표
- [ ] 주요 목표 1
- [ ] 주요 목표 2

## 작업 목록
- [ ] 작업 1: 설명
- [ ] 작업 2: 설명

## 진행 상황
- 시작일: YYYY-MM-DD
- 마감일: YYYY-MM-DD
- 전체 진행률: 0%

2. 진행 업데이트: 작업을 완료할 때마다 파일을 수정합니다.

- [x] 작업 1: 설명 ✅ 2025-03-15 완료
- [ ] 작업 2: 설명 🔄 진행 중

3. 지식 저장: notes.md 파일에 중요한 정보를 기록합니다.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 AI 에이전트

예시

프로젝트 시작 시:

# plan.md 파일 생성
echo "# 프로젝트 계획" > plan.md

세션 간 전환 시:

# 기존 계획 불러오기
cat plan.md

라이선스

MIT