reflect

reflect skill 개요

reflect가 하는 일

reflect는 Claude가 대화 도중 실행을 잠시 멈추고, 처음의 목표부터 대화를 다시 읽은 뒤 현재 방향에 대해 솔직하게 판단하도록 돕는 중간 점검용 skill입니다. 세부 사항으로 더 깊이 들어가기보다, reflect skill은 지금의 진행 방향이 여전히 타당한지, 어떤 가정이 이를 이끌고 있는지, 빠진 것은 없는지, 다음 행동이 계속 진행인지, 방향 전환인지, 아니면 일시 중단인지 확인합니다.

Decision Support, 기획, 제품 업무, 디버깅 루프, 전략 논의처럼 전술적으로는 진전이 있어 보이지만 전략적으로는 방향이 어긋날 수 있는 긴 대화에서 특히 유용합니다.

가장 잘 맞는 사용자와 상황

AI 어시스턴트에게 여러 단계의 작업을 자주 맡기고, 안정적인 “sanity check” 장치가 필요하다면 reflect를 설치할 만합니다. “한 걸음 물러서서 보자”, “우리가 놓친 게 있나?”, “이걸 너무 복잡하게 생각하는 건가?”, “크게 보면?”, “아직 방향이 맞나?” 같은 요청을 자주 하는 사용자에게 잘 맞습니다.

가장 강력한 활용처는 요약이 아닙니다. 핵심 역할은 방향 보정입니다. 대화가 잘못된 경로에 깊이 들어가기 전에 확증 편향, 매몰 비용 사고, 앵커링, 복잡도 증가, 최신 정보 편향을 포착하는 데 있습니다.

reflect가 다른 점

이 skill은 의도적으로 입력 부담이 낮게 설계되어 있습니다. 앞선 대화에 충분한 맥락이 있다면 긴 설명을 다시 요구하지 않고 바로 실행되어야 합니다. 맥락이 너무 부족할 때도 reflection을 또 다른 기획 작업으로 바꾸는 대신, 판단에 꼭 필요한 확인 질문 하나만 던집니다.

함께 제공되는 참고 자료는 유용한 원칙을 더해 줍니다. reflection은 원래 목표부터 다시 읽어야 하고, 엄격해 보이기 위해 문제를 지어내지 않아야 하며, 구체적인 권고로 끝나야 합니다. 포함된 scripts는 transcript를 테스트하거나 reflection 결과가 충분히 구체적인지 검증하려는 팀에도 도움이 됩니다.

reflect skill 사용 방법

reflect 설치와 repository 경로

GitHub repository에서 다음 명령으로 skill을 설치합니다.

npx skills add alirezarezvani/claude-skills --skill reflect

소스 위치는 다음과 같습니다.

productivity/reflect/skills/reflect

먼저 SKILL.md를 읽고, 작동 방식을 이해하기 위해 다음 파일을 확인하세요.

• references/cognitive_bias_canon.md
• references/conversation_reflection_practice.md
• references/honest_output_discipline.md
• scripts/bias_pattern_detector.py
• scripts/conversation_depth_analyzer.py
• scripts/directional_recommendation_validator.py

이 skill은 순수 추론 기반 skill입니다. 호환되는 skill 환경 외에 외부 API, 데이터베이스, 특정 벤더 도구가 필요하지 않습니다.

실제 대화에서 reflect 호출하기

진행 중인 대화 안에서 직접적으로 요청하세요.

• “Reflect on where we are before we continue.”
• “Take a step back. Are we solving the right problem?”
• “Sanity check this plan for bias and drift.”
• “Are we overthinking this, or is the complexity justified?”
• “Use reflect for Decision Support: should we continue, pivot, or pause?”

좋은 reflect 사용 프롬프트에는 주제뿐 아니라 의사결정 압박이 들어갑니다. 예를 들어 “reflect on this”라고 쓰기보다 이렇게 요청하는 편이 좋습니다. “Reflect before we implement. Original goal: reduce onboarding friction. Current path: adding a multi-step configuration wizard. Check whether this is still aligned, what assumptions we are making, and whether we should continue, pivot, or pause.”

출력 품질을 높이는 입력

이 skill은 대화 안에 원래 목표, 현재 계획, 제약 조건, 최근 결정이 이미 들어 있을 때 가장 잘 작동합니다. 해당 정보가 흩어져 있다면 reflect를 호출하기 전에 짧게 다시 정리하세요.

유용한 입력 패턴은 다음과 같습니다.

• Original goal: 성공이 무엇을 의미하기로 했는지
• Current direction: 현재 대화가 무엇을 최적화하고 있는지
• Decision point: 지금 무엇을 결정하거나 실행하려는지
• Constraints: 마감, 위험 허용도, 사용자 요구, 기술적 한계
• Concern: 방향 이탈, 복잡성, 편향, 근거 부족, 정체 상태

이렇게 하면 skill이 최근 몇 턴에만 반응하는 대신, 현재 경로를 출발점의 기준과 비교할 수 있습니다.

선택 사항: script를 활용한 workflow

scripts는 필수는 아니지만, 반복 가능한 검토에 유용합니다. transcript를 User:와 Assistant: 턴이 포함된 plain text로 저장한 뒤 다음을 실행하세요.

python scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt

bias_pattern_detector.py로 후보 편향 패턴을 표시할 수 있습니다. 다만 regex에 걸렸다는 사실을 증거로 취급하기보다, AI가 판단을 적용하도록 하세요. reflection을 생성한 뒤에는 directional_recommendation_validator.py로 결과가 구체적인 continue, pivot, pause 권고로 끝나는지, 막연한 안심에 그치지 않는지 확인할 수 있습니다.

reflect skill FAQ

reflect는 더 나은 요약 프롬프트일 뿐인가요?

아닙니다. 요약은 일어난 일을 압축하지만, reflect는 대화가 여전히 올바른 결과를 향하고 있는지 판단합니다. reflect skill은 방향 이탈, 부족한 근거, 과도하게 설계된 해법, 간과된 제약, 정당화되지 않은 추진력을 드러내야 합니다. 모든 것이 실제로 타당하다면 억지로 반론을 만들어내지 말고, 근거와 함께 그렇다고 말해야 합니다.

언제 reflect를 쓰지 않는 것이 좋나요?

단순한 일회성 작업, 사실 확인, 재평가할 만한 이전 맥락이 거의 없는 상황에는 적합하지 않습니다. 단지 격려나 문체 피드백만 원하는 경우에도 잘 맞지 않습니다. 이 skill은 진행 흐름을 의도적으로 끊도록 설계되어 있어 복잡한 작업에서는 가치가 크지만, 사소한 작업에는 불필요합니다.

reflect는 초보자에게도 쉬운가요?

네. 호출은 “reflect” 또는 “take a step back”처럼 간단할 수 있습니다. 초보자는 입력 부담이 낮은 설계의 이점을 얻을 수 있고, 고급 사용자는 원래 목표, 현재 결정, 의심되는 실패 유형을 함께 제공해 더 좋은 결과를 얻을 수 있습니다.

Decision Support에서 reflect는 팀에 어떻게 도움이 되나요?

Decision Support에서 reflect는 의사결정 전에 구조화된 멈춤 지점을 제공합니다. 제품 방향을 선택하기 전, 기술 설계를 확정하기 전, 디버깅 경로를 계속 밀고 가기 전, 또는 어떤 권고를 받아들이기 전에 유용합니다. 잘못된 방향으로 계속 진행하는 비용이 재평가를 위해 잠시 멈추는 비용보다 클 때 가치가 가장 큽니다.

reflect skill 개선 방법

reflect에 명확한 의사결정 경계 주기

가장 흔한 약한 출력은 모호한 호출에서 나옵니다. “Reflect on our discussion”도 작동할 수는 있지만, “Reflect before we choose option B; check for anchoring, missing counterevidence, and whether we should continue, pivot, or pause”라고 하면 skill이 훨씬 선명한 목표를 갖게 됩니다.

특정 위험이 중요하다면 이름을 붙이세요. 예를 들어 “I’m worried we are adding features because each one sounds reasonable individually. Check for complexity bias.”처럼 요청할 수 있습니다.

근거 기반 재평가를 강제하기

좋은 reflect 출력은 구체적인 대화 근거를 언급해야 합니다. 원래 목표, 프레이밍이 바뀐 지점, 지배적이 된 가정, 검증이 필요한 결정 등이 여기에 해당합니다. 응답이 일반론처럼 느껴진다면 이렇게 요청하세요. “Redo the reflection using specific evidence from earlier turns and end with a concrete recommendation.”

이는 repository의 honest-output discipline과도 맞닿아 있습니다. 막연한 비관도, 막연한 안심도, 지어낸 문제도 없어야 합니다.

흔한 실패 유형 확인하기

reflect의 흔한 실패에는 최근 턴에만 집중하는 것, 판단 대신 요약만 하는 것, 근거 없이 문제를 찾아내는 것, 다음 행동을 명확히 제시하지 않은 채 끝나는 것이 있습니다. 또 다른 실패는 질문을 너무 많이 하는 것입니다. 이 skill은 대화가 재평가하기에 지나치게 얕을 때만 확인 질문을 해야 합니다.

다음처럼 바로잡을 수 있습니다. “Reread from the original goal, not just the recent implementation details. Identify the strongest reason to continue and the strongest reason to pivot.”

첫 권고 이후에도 반복하기

첫 reflection은 작업의 끝이 아니라 의사결정 체크포인트로 다루세요. 권고가 “continue”라면 어떤 근거가 나오면 그 판단이 바뀔지 물어보세요. “pivot”이라면 실행 가능한 가장 작은 방향 전환을 요청하세요. “pause”라면 계속 진행하기 전에 정확히 어떤 누락 정보를 해결해야 하는지 물어보세요.

이렇게 해야 reflect가 실용적으로 유지됩니다. 목표는 더 많은 분석이 아니라 더 나은 다음 행동입니다.