파일 기반 플래닝 (아랍어판)

무엇을 해주나

Manus 스타일의 "디스크를 작업 기억으로 쓰는" 패턴을 Claude Code에 적용합니다.

• 3종 파일 생성: task_plan.md(단계·진행·결정), findings.md(조사 결과), progress.md(세션 로그)를 프로젝트 루트에 만들고 유지합니다.
• 자동 컨텍스트 복원: UserPromptSubmit / PreToolUse / PreCompact 훅이 계획 파일을 다시 주입하고, session-catchup.py가 /clear 또는 컴팩션 이후 끊긴 맥락을 git diff와 비교해 복구합니다.
• 작업 규율 강제: "2단계 규칙"(검색 두 번마다 발견 내용 저장), "3회 실패 프로토콜"(진단→대안→재사고→사용자 문의), 모든 오류를 표로 기록하는 규칙을 제시합니다.
• 읽기/쓰기 결정 매트릭스와 안티패턴 표로 언제 파일을 읽고 언제 쓰는지 명확히 안내합니다.
• 보안 경계: 웹·API에서 가져온 신뢰할 수 없는 내용은 훅이 반복 주입하는 task_plan.md가 아니라 findings.md에만 쓰도록 규정합니다.

문서 본문은 아랍어로 작성되어 있어 아랍어 사용 환경에 특히 적합합니다.

이런 분께 추천

• 3단계 이상 걸리는 리팩터링·기능 구현을 Claude Code로 진행하며 중간에 컨텍스트가 날아가 답답했던 분
• 여러 세션에 걸친 리서치나 문서화 작업의 진행 상황을 남기고 싶은 분
• 아랍어로 프로젝트 계획과 로그를 관리해야 하는 팀
• TodoWrite 같은 임시 목록 대신 파일로 남는 계획 기록을 원하는 분

활용 예시

1. 레거시 모듈 마이그레이션: "이 모듈을 TypeScript로 옮길 계획을 세워줘"라고 하면 단계별 task_plan.md가 생성되고, 각 단계 완료 시 상태가 complete로 갱신되며 발생한 오류가 표로 누적됩니다.
2. /clear 이후 이어서 작업: 대화를 초기화한 뒤 다시 질문하면 훅이 계획 파일을 읽고 session-catchup.py가 git diff와 비교해 "어디까지 했는지"를 요약해 줍니다.
3. 경쟁 서비스 리서치: 웹 검색 결과를 두 번마다 findings.md에 저장해 스크린샷·PDF 기반 정보가 컨텍스트에서 사라지는 것을 방지합니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 OthmanAdi/planning-with-files 의 skills/planning-with-files-ar 폴더를 내 ~/.claude/skills/planning-with-files-ar/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.