자세한 기술 계획 만들기
사양은 빌드해야 하는 항목을 정의합니다. 기술 계획은 빌드 방법을 정의합니다. 이 단원에서는 엔터프라이즈 브라운필드 시나리오에 대한 고급 계획 기술을 다룹니다.
계획 기본 사항 검토
plan.md 파일은 디자인 문서 역할을 하며, spec.md 높은 수준의 요구 사항과 그에 따른 구체적인 구현 작업 간의 차이를 해소합니다. 포괄적인 기술 계획에는 다음이 포함됩니다.
- 아키텍처 개요: 구성 요소가 상호 작용하는 방법에 대한 개략적인 보기입니다.
- 기술 스택 및 주요 결정: 근거를 사용하여 기술 선택에 대한 명시적 설명서입니다.
- 구현 시퀀스: 구현 단계의 논리적 진행.
- 헌법 검증: 제안된 솔루션이 프로젝트 원칙을 준수하는지 명시적으로 확인합니다.
- 가정 및 열린 질문: 가정 및 해결되지 않은 질문에 대한 설명서입니다.
이러한 기본 사항을 염두에 두고 엔터프라이즈 개발을 위한 고급 계획 고려 사항을 살펴보겠습니다.
우려 사항 분리 - 사양 및 계획
사양과 기술 계획 간의 문제를 분리하는 것이 중요합니다. 사양은 안정적이며 "무엇"에 초점을 맞추고 있지만 다른 "방법"접근 방식을 실험할 때 계획이 진화 할 수 있습니다.
사양에 내부 직원 포털에 대한 문서 업로드 기능이 필요하다고 가정합니다. 사양은 파일 크기 제한, 지원되는 형식, 피드백 업로드 및 액세스 제어와 같은 사용자 요구 사항을 정의합니다. 기술 계획은 이러한 요구 사항을 사용할 Azure Storage 서비스, API를 구성하는 방법, 구현할 인증 메커니즘 및 파일의 유효성을 검사하는 방법 등 구체적인 아키텍처 결정으로 변환합니다. Azure Blob Storage에서 Azure Files로 이동하는 등 한 기술에서 다른 기술로 전환하려는 경우 spec.md 크게 변경되지 않은 상태로 plan.md 업데이트합니다. 기능 요구 사항은 변경되지 않습니다. 구현 방법만 변경됩니다.
계획 구조 및 콘텐츠 검사
포괄적인 기술 계획에는 구현 방법을 전체적으로 정의하는 몇 가지 주요 섹션이 포함되어 있습니다.
아키텍처 개요
아키텍처 개요는 구성 요소가 상호 작용하는 방법에 대한 개략적인 보기를 제공합니다. 문서 업로드 기능의 경우 아키텍처에서 다음을 설명할 수 있습니다.
"다중 파트 파일 업로드를 처리하는 새 백 엔드 API 엔드포인트 /api/documents/upload 를 구현합니다. React 프런트 엔드에는 파일 선택기 및 진행률 표시기가 있는 새 DocumentUpload 구성 요소가 포함되어 있습니다. 사용자가 파일을 선택하면 프런트 엔드는 업로드하기 전에 크기 및 형식의 유효성을 검사합니다. 백 엔드는 파일을 수신하고, 유효성을 다시 검사하고, Azure Blob Storage에 저장하고, SQL 데이터베이스에 메타데이터를 기록합니다. 업로드에 성공하면 프런트 엔드에서 문서 목록을 새로 고쳐 새 파일을 표시합니다."
이 요약은 코드 수준 세부 정보로 전환하지 않고 전체 흐름을 설정합니다. 이를 통해 모든 사람이 주요 구성 요소와 상호 작용을 이해할 수 있습니다.
기술 스택 및 주요 의사 결정
이 계획은 기술 선택 사항 및 근거를 명시적으로 문서화합니다. 이 섹션에서는 특정 라이브러리 또는 서비스가 선택된 이유에 대한 향후 혼동을 방지합니다.
기술 결정 예:
- 백 엔드: Blob 작업용 Azure.Storage.Blobs SDK v12를 사용하는 .NET 8 Web API.
- 프런트 엔드: UI 일관성을 위해 Ant 디자인의 업로드 구성 요소를 사용한 React 18입니다.
- 인증: 포털의 인증 컨텍스트에서 기존 Microsoft Entra ID 토큰을 사용합니다.
-
스토리지: 이름이 Azure Blob Storage 컨테이너입니다
employee-documents. - 데이터베이스: DocumentMetadata 테이블을 사용하여 기존 SQL 데이터베이스를 확장합니다(열: ID, UserId, FileName, BlobUrl, UploadDate, FileSize).
각 결정은 사양 요구 사항과 헌법 원칙 모두에 부합해야 합니다. 헌법에서 "모든 클라우드 리소스에 Azure 서비스 사용"을 요구하는 경우 계획은 명시적으로 Azure Blob Storage를 선택하고 이 원칙을 참조합니다.
구현 시퀀스
이 계획은 구현 단계의 순서를 간략하게 설명합니다. 나중에 생성된 작업 목록만큼 세분화되지는 않지만 이 시퀀스는 설정에서 완료까지 논리적 진행을 제공합니다.
문서 업로드 기능에 대한 일반적인 구현 순서:
- 데이터베이스 스키마 업데이트: 적절한 인덱스 및 제약 조건을 사용하여 DocumentMetadata 테이블을 만듭니다.
- 백 엔드 API 개발: 파일 유효성 검사, Blob Storage 통합 및 메타데이터 지속성을 사용하여 POST /api/documents/upload 엔드포인트를 구현합니다.
- 프런트 엔드 구성 요소 만들기: 파일 선택, 클라이언트 쪽 유효성 검사 및 업로드 진행률 표시를 사용하여 DocumentUpload 구성 요소를 빌드합니다.
- 통합: 프런트 엔드 구성 요소를 백 엔드 API에 연결하고, 응답을 처리하고, 문서 목록을 업데이트합니다.
- 보안 강화: 서버 쪽 파일 형식 유효성 검사, 크기 제한 및 인증 검사를 구현합니다.
- 오류 처리: 클라이언트 및 서버 쪽 오류에 대한 포괄적인 오류 메시지를 추가합니다.
- 테스트: 업로드 흐름에 대한 API 메서드 및 통합 테스트에 대한 단위 테스트를 만듭니다.
이 시퀀스는 종속 구성 요소(데이터베이스에 쓰는 API)가 구현되기 전에 기본 요소(데이터베이스 스키마)가 있는지 확인합니다. 각 단계는 이전 작업을 기반으로 하여 통합 문제의 가능성을 줄입니다.
헌법 확인
이 계획에는 헌법에 반하는 제안된 해결책을 명시적으로 확인하는 검증 섹션이 포함되어 있습니다. 이 확인은 아키텍처 드리프트를 방지하고 프로젝트 원칙과의 일관성을 보장합니다.
헌법에 "모든 데이터 스토리지가 Azure 서비스를 사용해야 함" 및 "API가 클라이언트와 서버 모두에서 입력의 유효성을 검사해야 함"이 포함된 경우 계획 확인 섹션에서 확인합니다.
- "Azure Blob Storage를 사용하면 Azure 서비스 요구 사항이 충족됩니다."
- "React 구성 요소(클라이언트) 및 .NET API(서버)에서 유효성 검사를 구현하는 것은 심층 방어 보안 원칙에 부합합니다."
- "Microsoft Entra ID 인증 요구 사항은 기존 포털 인증 컨텍스트를 사용하여 충족됩니다."
이 확인은 검사점 역할을 합니다. 계획이 헌법을 위반하는 것을 제안하는 경우, AI가 일반적으로 그것을 플래그 지정하며, 이는 검토 중에 알게 됩니다. 계획 단계에서 헌법 충돌을 해결하면 나중에 재작업을 방지할 수 있습니다.
가정 및 열린 질문
잘 구성된 계획은 가정 및 해결되지 않은 질문을 문서화합니다. 이러한 투명성은 구현이 시작되기 전에 잠재적인 문제를 식별하는 데 도움이 됩니다.
예제 가정:
- "Azure Blob Storage 컨테이너 'employee-documents'가 있고 프라이빗 액세스를 위해 구성되어 있다고 가정합니다."
- "기존 SQL 데이터베이스에 메타데이터에 충분한 스토리지 용량이 있다고 가정합니다."
- "업로드된 파일의 바이러스 검사가 이 반복의 범위를 벗어난다고 가정합니다."
열려 있는 질문 예제:
- "관리자가 다른 사용자의 업로드된 문서를 삭제할 수 있어야 하나요?"
- "모든 문서 액세스 시도에 감사 로깅이 필요한가요?"
- "문서가 업로드될 때 시스템에서 전자 메일 알림을 보내야 하나요?"
이러한 가정 및 질문을 문서화하면 범위 크리프가 방지되고 관련자가 코딩을 시작하기 전에 중요한 결정을 내릴 수 있습니다. 구현 중에 가정이 잘못된 것으로 판명되면 그에 따라 계획을 업데이트할 수 있습니다.
/speckit.plan을 사용하여 계획 생성
GitHub 사양 키트는 GitHub Copilot 채팅의 /speckit.plan 명령을 통해 계획을 생성합니다. 이 명령은 spec.md 및 constitution.md 모두 입력으로 사용하여 포괄적인 기술 디자인을 생성합니다.
명령을 호출하기 전에 AI에 필요한 다른 컨텍스트를 고려합니다. 기존 코드베이스, 기술 기본 설정 및 인프라 제약 조건은 모두 계획에 영향을 줍니다. 이 컨텍스트를 미리 제공하면 보다 정확하고 실행 가능한 결과가 생성됩니다.
내부 직원 포털 시나리오의 문서 업로드 기능의 경우 다음과 같은 컨텍스트를 제공할 수 있습니다.
"기존 포털은 .NET 8 Web API 백 엔드가 있는 React 프런트 엔드를 사용합니다. 업로드 기능을 이 스택에 통합해야 합니다. 파일 지속성을 위해 Azure Blob Storage를 사용합니다. 모든 업로드 작업에 대해 Microsoft Entra ID 인증이 필요합니다. 포털에 메타데이터 스토리지에 사용할 수 있는 SQL 데이터베이스가 이미 있습니다."
이 컨텍스트는 AI가 현재 스택에 맞지 않는 그린필드 솔루션을 제안하지 않고 기존 아키텍처에 원활하게 맞는 계획을 생성하도록 안내합니다.
계획 명령 호출
Visual Studio Code에서 GitHub Copilot 채팅을 열고 /speckit.plan을 입력합니다. AI가 추가 정보를 요청하는 경우 아키텍처 컨텍스트를 제공합니다. GitHub Copilot는 사양, 헌법 및 추가 컨텍스트를 처리하여 plan.md 생성합니다.
AI가 다양한 접근 방식을 고려하고, 헌법에 대해 검사하고, 출력을 일관된 디자인 문서로 구조화하면 계획 단계가 잠시 걸릴 수 있습니다.
계획 검토 및 유효성 검사
계획 생성은 첫 번째 단계일 뿐입니다. 중요 검토를 통해 계획이 정확하고 완전하며 프로젝트의 요구 사항에 맞게 조정됩니다.
사양 요구 사항의 적용 범위 확인
계획을 spec.md와 체계적으로 비교합니다. 사양의 모든 요구 사항은 계획의 구현 접근 방식에 매핑되어야 합니다.
예를 들어 spec.md "50MB를 초과하는 파일에 대한 오류 메시지 표시"가 필요한 경우 계획에서 이 유효성 검사의 위치와 방법을 설명해야 합니다. 계획에서 이 유효성 검사를 생략하는 경우 계획이 불완전하거나 사양에 설명이 필요합니다.
기술 표준과의 맞춤 확인
계획의 기술 선택이 조직의 표준 및 모범 사례와 일치하는지 확인합니다. 팀이 특정 라이브러리 또는 패턴을 표준화하는 경우 계획은 이러한 기본 설정을 반영해야 합니다.
고려해야 할 질문:
- 제안된 아키텍처가 기존 시스템에 적합한가요?
- 선택한 라이브러리가 사용자 환경에서 사용하도록 승인되었나요?
- 기술 선택은 조직의 보안 및 규정 준수 정책을 준수합니까?
- 따라야 하는 유사한 기능에 대해 설정된 패턴이 있나요?
Azure 환경의 문서 업로드 기능의 경우 Azure Blob Storage가 승인된 서비스인지, 인증 접근 방식이 엔터프라이즈 ID 표준(예: Microsoft Entra ID 사용)에 부합하고 제안된 SQL 스키마가 데이터베이스 명명 규칙을 따르는지 확인합니다.
헌법 준수 유효성 검사
이 계획에는 제안된 솔루션이 헌법 요구 사항을 준수하는 명시적 검증이 포함되어야 합니다. 원칙을 위반하지 않도록 이 확인 섹션을 주의 깊게 검토하세요.
헌법에 "모든 비밀을 Azure Key Vault에 저장해야 함"이 요구되고 계획이 azure Storage 연결 문자열을 appsettings.json저장하도록 제안하는 경우 충돌이 발생합니다. 런타임에 Key Vault에서 연결 문자열을 검색하도록 계획을 수정해야 합니다.
계획 중에 발견된 헌법 위반은 쉽게 해결할 수 있습니다. 코드 검토 또는 프로덕션 배포 중에 발견된 헌법 위반은 비용이 많이 들고 중단됩니다.
계획을 반복하고 구체화합니다.
계획은 초기 생성 후 구체화가 필요한 경우가 많습니다. 첫 번째 시도에서 완벽을 기대하지 마십시오. GitHub Copilot의 설명 기능을 사용하여 계획 품질을 개선합니다.
모호성 및 간격 해결
계획에 "적절한 오류 처리 구현"와 같은 모호한 문이 포함된 경우 세부 정보를 누릅니다. 어떤 오류가 발생할 수 있나요? 각 오류를 어떻게 처리해야 하나요? 어떤 오류 정보를 기록해야 하며 사용자에게 표시되어야 하나요?
GitHub Copilot Chat을 사용하여 "업로드 엔드포인트가 처리해야 하는 특정 오류는 무엇인가요?" 또는 "Azure Blob Storage를 사용할 수 없는 경우 어떻게 해야 하나요?" 등의 후속 질문을 할 수 있습니다. AI는 모호한 섹션을 구체적인 사양으로 확장할 수 있습니다.
기술 타당성 확인
제약 조건이 있는 경우 제안된 아키텍처가 기술적으로 가능한지 확인합니다. 계획에서 30초 시간 제한으로 Web API를 통해 50MB 파일을 동기적으로 업로드할 것을 제안하는 경우 문제가 발생합니다. 파일 크기가 50MB를 초과할 경우, 분할 업로드나 타임아웃 시간을 길게 설정해야 할 수도 있습니다.
관련 전문 지식이 있는 팀 구성원과 상의하세요. 계획에서 데이터베이스 스키마 변경 내용을 제안하는 경우 데이터베이스 관리자에게 검토합니다. 새 Azure 리소스가 필요한 경우 인프라 엔지니어에게 프로비저닝이 가능한지 확인합니다.
비기능적 요구 사항 고려
계획에서 성능, 보안, 확장성, 유지 관리 가능성, 접근성 등 사양의 비기능 요구 사항을 충족하는지 확인합니다.
문서 업로드의 경우 계획에 다음이 포함되어 있는지 확인합니다.
- 성능: 업로드를 얼마나 빨리 완료해야 하나요? 최대 동시 업로드 볼륨은 무엇인가요?
- 보안: 파일에서 맬웨어를 검색하려면 어떻게 하나요? 액세스는 어떻게 제어되는가? 감사 로그는 어디에 저장되어 있나요?
- 확장성: 시스템에서 증가된 업로드 볼륨을 어떻게 처리하나요? 스토리지 용량 제한은 무엇인가요?
- 유지 관리 기능: 직원이 조직을 떠날 때 업로드된 파일은 어떻게 정리되나요?
- 접근성: 업로드 UI가 WCAG(웹 콘텐츠 접근성 지침) 2.1 AA 표준을 충족하나요?
계획에서 이러한 고려 사항을 생략하는 경우 명시적으로 추가합니다. 계획에서 해결되지 않는 경우 구현 중에 비기능 요구 사항은 종종 생각 후에 발생합니다.
타당성 및 완전성 평가
계획이 구현을 위한 충분한 지침을 제공하는지 여부를 평가합니다. 너무 모호한 계획("파일 업로드 구현")은 유용하지 않습니다. 너무 규범적인 계획("정확히 47줄의 코드 사용")은 지나치게 제한됩니다.
적절한 수준의 세부 정보는 모든 유연성을 제거하지 않고 명확한 방향을 제공합니다. 계획은 다음과 같이 대답해야 합니다.
- 어떤 구성 요소를 만들거나 수정해야 합니까?
- 이러한 구성 요소는 어떻게 상호 작용합니까?
- 어떤 기술과 라이브러리가 사용됩니까?
- 구현 순서는 무엇인가요?
- 정확성을 보장하는 확인 단계는 무엇인가요?
계획에서 기능을 구현하는 방법을 구상할 수 없는 경우 더 자세한 정보가 필요합니다. 계획이 코드를 작성하는 것처럼 느껴지면 너무 상세할 수 있습니다.
누락된 요소 식별
계획에서 빈틈을 확인합니다. 일반적인 누락은 다음과 같습니다.
- 오류 처리: 시스템에서 네트워크 오류, 스토리지 오류 또는 데이터베이스 문제를 어떻게 처리하나요?
- 성능 고려 사항: 업로드 속도, 동시 사용자 또는 스토리지 제한에 대한 우려가 있나요?
- 테스트 전략: 구현의 유효성을 검사하기 위해 어떤 테스트를 작성해야 합니까?
- 롤백 방법: 배포로 인해 문제가 발생하는 경우 변경 내용을 되돌리려면 어떻게 해야 할까요?
plan.md 수동으로 편집하거나 더 많은 컨텍스트를 제공하고 관련 섹션을 다시 생성하여 이러한 격차를 해결합니다.
구체화된 컨텍스트를 사용하여 다시 생성
초기 계획이 적절하지 않은 경우 보다 적합한 컨텍스트를 제공하여 다시 생성합니다. 예를 들어 계획에서 새 데이터베이스 사용을 제안하지만 기존 데이터베이스를 사용해야 하는 경우 다음을 명확히 합니다. "기존 EmployeePortal 데이터베이스를 사용합니다. 새 테이블을 만드는 대신 이 데이터베이스에 DocumentMetadata 테이블을 추가합니다."
이 업데이트된 컨텍스트를 통합하여 계획을 /speckit.plan 다시 생성합니다. AI는 이에 따라 접근 방식을 조정합니다.
수동으로 계획 편집
plan.md Markdown 파일이므로 직접 편집할 수 있습니다. AI가 90개% 올바른 방법을 제안하지만 약간의 조정이 필요한 경우 모든 항목을 다시 생성하는 대신 파일을 편집합니다.
예를 들어 계획에서 특정 Blob 컨테이너 이름을 제안하지만 조직에 명명 규칙이 있는 경우 plan.md 컨테이너 이름을 직접 업데이트합니다.
팀 구성원과 공동 작업
팀 환경에서는 검토를 위해 plan.md 공유합니다. 선임 개발자 또는 설계자는 구현이 시작되기 전에 아키텍처 결정의 유효성을 검사할 수 있습니다. 이 동료 검토는 자동화된 검사가 놓칠 수 있는 문제를 발견합니다.
팀 검토는 공유 이해도를 구축합니다. 여러 개발자가 기능을 사용할 때 계획을 함께 검토하면 모든 사용자가 접근 방식을 알고 다른 진행 중인 작업과의 잠재적 충돌을 식별할 수 있습니다.
문서 아키텍처 결정
계획은 빌드할 내용뿐만 아니라 향후 개발자가 의사 결정 컨텍스트를 이해하는 데 도움이 되는 특정 아키텍처 선택을 한 이유를 문서화해야 합니다.
고려된 레코드 대안
여러 실행 가능한 방법 중에서 선택할 때 고려한 대안과 다른 방법보다 하나를 선택한 이유를 문서화합니다.
파일 스토리지의 경우 다음 세 가지 방법을 고려할 수 있습니다.
- Azure Blob Storage: 비용 효율성, 확장성 및 기존 Azure 환경과의 통합을 위해 선택되었습니다.
- Azure Files: 대용량 파일 스토리지 및 불필요한 SMB(서버 메시지 블록) 프로토콜 오버헤드에 대한 높은 비용으로 인해 거부되었습니다.
- SQL Database FILESTREAM: 데이터베이스 크기 및 복잡성 증가를 방지하기 위해 거부되었습니다.
이 설명서는 이후 개발자가 왜 더 간단한 접근 방식이 사용되지 않았는지에 대해 의문을 제기하지 못하도록 합니다. 의사 결정 근거는 시간을 잃지 않고 보존됩니다.
캡처 가정
계획은 기존 시스템, 인프라 및 조직 제약 조건에 대해 가정합니다. 이러한 가정을 명시적으로 만듭니다.
문서 업로드에 대한 예제 가정:
- 개발이 시작되기 전에 인프라 팀에서 Azure Blob Storage 컨테이너
employee-documents를 프로비전합니다. - 기존 포털 인증은 사용자 식별을 위해 신뢰할 수 있는 유효성이 검사된 Microsoft Entra ID 토큰을 제공합니다.
- SQL Database에는 스토리지 확장 없이도 다른 메타데이터 테이블에 충분한 용량이 있습니다.
- 네트워크 인프라는 프록시 또는 방화벽 제한 없이 50MB HTTP 업로드를 지원합니다.
구현 중에 잘못된 가정이 있으면 계획을 다시 검토하고 그에 따라 조정할 수 있습니다. 문서화된 가정은 상황이 변경될 때 영향 분석을 간단하게 만듭니다.
향후 진화 계획
기능이 어떻게 발전할 수 있는지를 고려하고 아키텍처가 확장 가능성이 있는 확장을 수용하도록 합니다.
문서 업로드의 경우 향후 요구 사항에는 다음이 포함될 수 있습니다.
- PDF 및 DOCX 이외의 다른 파일 형식 지원
- 직원 간의 파일 공유 구현
- 문서 버전 관리 추가
- 여러 파일의 대량 업로드를 사용하도록 설정합니다.
- 바이러스 검사 통합
아키텍처에서 이러한 확장을 어렵게 만드는 경우 초기 디자인 조정이 보장되는지 여부를 고려합니다. 지금은 미래의 기능을 구현하지 않지만 미래의 변화를 고통스럽게 만드는 구석에 자신을 그리는 것을 피합니다.
구현하는 동안 계획 공유 및 유지 관리
계획은 구현 전체에서 참조가 됩니다. 개발자는 정기적으로 계획을 참조하여 코드가 문서화된 아키텍처와 일치하는지 확인해야 합니다.
관련자와 계획 공유
계획을 완료한 후 유효성 검사를 위해 관련 이해 관계자와 공유합니다.
- 제품 관리자: 계획이 모든 사양 요구 사항을 제공하는지 확인합니다.
- 보안 팀: 보안 제어가 조직 표준을 충족하는지 확인합니다.
- 인프라 팀: 제안된 Azure 리소스를 프로비전하고 구성할 수 있는지 확인합니다.
- 아키텍처 팀: 조직 아키텍처 원칙과의 맞춤 유효성을 검사합니다.
이 이해관계자 검토는 구현이 시작되기 전에 문제를 발견합니다. 보안 팀 피드백에 제안된 인증이 충분하지 않은 것으로 확인되면 코드를 작성하기 전에 계획을 업데이트합니다.
필요에 따라 계획 업데이트
계획은 살아있는 문서입니다. 구현 중에 접근 방식이 의도한 대로 작동하지 않는 것을 발견하면 새 접근 방식을 반영하도록 계획을 업데이트합니다.
브라우저 localStorage에 업로드 진행률을 저장하려고 했지만 이로 인해 프라이빗 브라우징 모드에서 문제가 발생하는 것을 발견한 경우 대신 메모리 내 상태를 사용하도록 계획을 업데이트합니다. 추론이 유지되도록 변경이 필요한 이유를 문서화합니다.
plan.md 실제 구현과 동기화된 상태로 유지합니다. 계획 및 코드가 분기되면 계획이 참조 설명서로 값을 잃게 됩니다.
- 보안 접근 방식이 조직의 요구 사항을 충족합니까?
- 데이터베이스 스키마는 명명 규칙에 따라 디자인된가요?
계획에서 데이터베이스 사용을 제안하지만 기존 포털에 이미 데이터베이스가 있는 경우 과잉 사용일 수 있습니다. 계획에서 팀에서 피하는 기술을 제안하는 경우 계획을 문서화하거나 조정합니다.
피해야 할 일반적인 계획 문제
계획을 만들고 검토할 때 다음과 같은 일반적인 실수를 방지합니다.
계획 단계 건너뛰기: 계획 없이 사양에서 코드로 직접 이동하면 아키텍처 실수의 위험이 증가합니다. 계획에 투자한 시간은 재작업을 방지하여 배당금을 지급합니다.
검토 없이 계획 수락: AI 생성 계획은 최종 설계가 아닌 시작점입니다. 항상 비판적으로 검토하고 특정 컨텍스트에 대해 확인합니다.
과잉 제한 구현: 계획은 모든 세부 정보를 지시하는 것이 아니라 안내해야 합니다. 개발자가 구현하는 동안 적절한 전술적 결정을 내릴 수 있는 여지를 남겨 둡니다.
헌법 충돌 무시: 이 계획이 헌법 원칙을 위반하는 경우 충돌을 즉시 해결하십시오. 원칙에 개정이 필요한 경우 헌법을 준수하거나 업데이트하도록 계획을 조정합니다.
계획 업데이트 잊기: 구현에 새 정보가 표시되면 plan.md 업데이트합니다. 낡은 계획은 미래의 개발자를 오도하고 문서의 가치를 떨어뜨립니다.
요약
기술 계획은 사양을 실행 가능한 아키텍처로 변환합니다. 기술 스택 및 인프라에 대한 적절한 컨텍스트를 사용하여 /speckit.plan 계획을 생성합니다. 계획을 중요하게 검토하여 모든 사양 요구 사항을 충족하고, 헌법에 부합하며, 충분한 구현 지침을 제공합니다. 유효성이 검사된 계획을 사용하여 작업 생성 및 구현을 안내합니다. plan.md 이해와 함께 발전하고 전체 개발 수명 주기에 중요한 컨텍스트를 제공하는 살아있는 문서로 취급합니다.