피드로 돌아가기
Dev.toDevOps
원문 읽기
Enterprise Documentation Transformation: Git-Native TaskWarrior Workflows for Platform Reorganization
DiagnosticPro 플랫폼 팀이 Git-native 문서화 + TaskWarrior CLI + 체계적 디렉토리 구조 도입으로 10,000+ 산재된 파일을 113개 논리 계층 구조로 정리
AI 요약
Context
프로덕션 플랫폼이 유기적으로 성장하면서 10,000개 이상의 파일이 논리적 계층구조 없이 분산되었고, 60개 문서에 API 키가 노출되어 있었으며, 주요 구조 변경 시 롤백 절차가 없는 상태였습니다. 고객 $29.99 결제 거래를 처리하는 프로덕션 시스템이므로 다운타임 없이 정조직화해야 했습니다.
Technical Solution
- Git-native 세이브포인트 전략:
git tag SAVEPOINT-00-BASELINE로 응급 롤백 지점을 생성하고 모든 변경을 즉시 커밋하여 감사 추적 기록 확보 - TaskWarrior CLI 통합:
task config urgency.user.project.diagnosticpro-reorg.coefficient 5.0설정으로 프로젝트 관리 도구를 개발 워크플로우에 직접 통합 - 엔터프라이즈 디렉토리 구조 설계: 01-docs, 02-src, 03-tests, 04-assets, 05-scripts, 06-infrastructure, 07-releases, 99-archive 8개 최상위 카테고리로 조직화하고 GCP 특정 인프라(firebase, cloudrun, firestore, iam, secrets 등) 하위 디렉토리 생성
- Git 이력 보존 마이그레이션: 대규모 재정조직 중
git mv명령으로 전체 커밋 이력의 문맥 유지 - 단계별 보안 검증: 기초 감사(01-BASELINE-ASSESSMENT.md) → 노출된 API 키 식별 및 보안 → 롤백 절차 테스트 순서로 진행
Key Takeaway
체계적 문서화, CLI 기반 프로젝트 관리, Git 이력 보존이 결합되면 복잡한 프로덕션 시스템을 안전하게 재구성하면서 확장 가능한 조직 패턴을 구축할 수 있습니다.
실천 포인트
프로덕션 플랫폼 유지보수 프로젝트에서 TaskWarrior로 우선순위 높음 작업을 `task add project:[이름] +[태그] priority:H` 형식으로 추적하고, Git 세이브포인트를 변경 전에 생성한 후 `git mv`로 파일을 이동하면 작업 진행률 추적과 롤백 능력을 동시에 확보할 수 있습니다.