---
title: "Claude Code를 사용하기 전에, 이것을 하지 않으면 기술 부채가 쌓입니다."
url: "https://claudemods.dev/ko/builds/claude-code-ai-63c624"
source: "https://www.threads.com/@brotake/post/De0b0SjiVWp"
source_type: "resource"
author: "Takeshi Hashimoto"
author_handle: "brotake"
stars: 0
category: "워크플로 및 CI"
categories: ["workflow"]
tags: ["best-practices", "planning", "prompting", "tech-debt", "workflow"]
permission_level: null
scan_complete: false
added: "2026-10-23T02:26:02.396Z"
updated: "2026-10-23T02:00:39.000Z"
locale: "ko"
content_locale: "ko"
---

# Claude Code를 사용하기 전에, 이것을 하지 않으면 기술 부채가 쌓입니다.

Claude Code를 사용하기 전에 계획서를 먼저 작성하게 함으로써 코딩 에이전트의 폭주를 억제하고 기술 부채를 방지하는 워크플로우를 설명합니다. Zenn의 상세 기사로 링크합니다.

## Description

Claude Code를 사용하기 전에, 이것을 하지 않으면 기술 부채가 쌓입니다.

코딩 에이전트에게 "일단 구현해"라고 던져주고 있지 않나요?

AI는 우수하지만, 지시가 애매하면 독자적인 판단으로 예상치 못한 구현을 합니다.
나중에 수정하는 비용은 처음부터 설계하는 것보다 몇 배나 더 듭니다.

대책은 간단합니다. 구현 전에 상세한 계획서를 작성하게 하는 것입니다.

프롬프트에 "먼저 계획서를 작성해. 구현은 그 다음에"라고 넣기만 해도 AI의 폭주를 상당히 억제할 수 있습니다.

Claude Code는 그 계획 능력이 높기 때문에, 계획 단계를 꼼꼼히 밟으면 아웃풋의 질이 한 단계 올라갑니다.

https://zenn.dev/kazuki_izutani/articles/1709552ca099f1

ClaudeCode #AI活用 #業務効率化

## Original README

Claude Codeを使う前に、これをやらないと技術負債が積み上がります。

コーディングエージェントに「とりあえず実装して」と丸投げしていませんか？

AIは優秀ですが、指示が曖昧だと独自の判断で予想外の実装をしてきます。
後から修正するコストは、最初から設計するより何倍もかかります。

対策はシンプルで、実装前に詳細な計画書を作らせること。

プロンプトに「まず計画書を作成して。実装はその後」と入れるだけで、AIの暴走をかなり抑えられます。

Claude Codeはその計画力が高いので、計画フェーズを丁寧に踏むとアウトプットの質が一段上がりますよ。

https://zenn.dev/kazuki_izutani/articles/1709552ca099f1

ClaudeCode #AI活用 #業務効率化