1회용이 아닌 다중 사용을 위한 (유지 보수 가능한) ai coding 을 위한 켄트 백의 제안

• spec driven dev - 스팩 주도 개발 : 최대한 작고 구체적으로 명령
• rule growing dev - 룰 개선형 개발 : 재활용 가능한 코드로 통제

1.스팩 주도 개발

• 스팩 문서를 (상세하게 잘게 쪼개어 작성한) 개발을 위한 필수 조건으로 진행

명세작성(SPEC) > 게획 수립(PLAN) > 작업분할 및 실행(TASK) > 완성 결과물 코드 (RESULT)

1) 명세작성 : 상세 요구사항, ui ux 정책, api 규격 등에 대해 명확히 작성, PRD(Product Requirement Document) , TRD(Technical Requirement Document), Design Document
2) 계획수립 : 명세를 기반으로 기술계획, 파일구조, 필요 함수 및 컴포넌트 정의
3) 작업분할 및 실행 : 계획을 ai가 실행할 작은 단위로 task 분해한 후 순차적으로 코드 생성
4) 완성 결과 : 코드 테스트 및 완료

잘게 쪼개고 구체적인 문서를 통해 ai 에게 작업을 시키고 확인함, 작게 쪼개고 작게 검증하는 루프를 반복하며 확인해 가는 방식

• epic > user story > task : md 작성
• 구체적인 작업은 2~3개의 논리적으로 나누기 편한 task 를 묶어서 git issue로 생성 -> git worktree 로 나누어 병렬로 작업함

문서 작성 방법

• 직업 LLM과 대화를 통해
• Prompt Template 사용 (super claude ...)
• AWS Kiro : https://aws.amazon.com/ko/blogs/korea/introducing-kiro/ , https://channy.creation.net/blog/1941
• github spec kit : https://github.com/github/spec-kit

2. 룰 기반 개발

coding convention 기반 작업 의뢰 및 리뷰 방식

• 지속 가능한 코딩 추구 : ai 생성하는 코드의 품질이 일정하게 유지 필요
• 코드 퀄리티를 정의한 문서 = coding convention

ex)

프론트

• design system rules
• 컴포넌트 분리 원칙
• ...

백앤드

• 프로젝트 architecture, 디자인 패턴 rules
• TDD rules
• ...

rules/
├── backend/
│ ├── api/
│ ├── database/
│ ├── data-fetching-rules.md
│ └── index.md
├── common/
│ └── typescript/
│ ├── code-quality.md
│ ├── index.md
│ └── state-management-rules.md
└── view/
├── components/
│ ├── architecture.md
│ ├── composition-patterns.md
│ ├── design-principles.md
│ ├── review.md
│ └── shadcn-ui.md
├── design/
│ └── system.md
├── patterns/
│ ├── form.md
│ ├── performance.md
│ ├── project-structure.md
│ ├── react.md
│ └── server-client-components.md
├── index.md
└── readability.md

rules라는 루트 디렉터리 아래에 backend, common, view 세 가지 주요 영역으로 나뉘며, 각각의 영역은 관련 문서와 서브 디렉터리를 포함하고 있어 문서화와 규칙 관리함.

각 사용 에디터에 따라 rule 로 등록함

• cusor ai : cusor rule 로 등록
• claude code : /docs/rules 경로에 주요 룰들을 md 형식으로 등록, 경로별 룰을 참조하여 사용.
  CLAUDE.md에서 참조,
• 특정 종류의 rule에만 집중하는 sub-agent 생성
• researchers, developers, reviewers, testers