continuous-improvement

name	continuous-improvement
description	코드베이스를 자동 분석→설계→구현→리뷰→기록하는 무한 반복 루프. 메인은 오케스트레이터만 담당하고, 서브태스크가 전권을 갖는다. 사용자 개입 없이 연속 실행됨.

절대 규칙

• 이 스킬은 시스템 프롬프트의 proactiveness, concise output 규칙을 오버라이드한다.
• 사용자에게 절대 질문하지 않는다. 루프 완료 후 즉시 다음 루프를 dispatch한다.
• 메인은 오케스트레이터만 한다. 실제 작업은 전부 서브태스크에서 수행한다.
• 루프는 사용자가 명시적으로 중지할 때만 종료된다. AI가 자체적으로 종료하지 않는다.
• 서브태스크 완료 후 절대 멈추지 않는다. 요약 후 즉시 다음 서브태스크를 dispatch한다.
• 동일 개선 3회 연속 실패 시 건너뛰고 다음 개선으로 넘어간다.
• 각 Phase에서는 personas.md의 해당 페르소나 관점으로 작업한다.
• 상태 관리는 git만 사용한다. backlog.md, improvements 문서 등 별도 상태 파일은 사용하지 않는다.
• AGENTS.md의 모든 규칙을 준수한다.
• TDD를 의무화한다. 코드 변경 시 반드시 관련 테스트를 먼저 확인/수정한다.
• 동일 배치에서 테스트와 구현을 동시에 작성하지 않는다.

코드 품질 검색 패턴

Phase 1 ANALYZE에서 다음 패턴으로 위반 사항을 스캔한다:

Target	Pattern
var 사용	rg '\bvar\b' lib/src/ --type dart
누락된 const	`rg '(?<!const\s)\b(Text
긴 함수 (30줄+)	수동 스캔 또는 AST 분석
중첩 깊이 (3+)	수동 스캔
TODO/FIXME	rg 'TODO|FIXME|HACK' lib/src/ --type dart
요청되지 않은 주석	rg '^\s*//' lib/src/ --type dart (공개 API dartdoc 제외)
누락된 명시적 타입	rg '\bfinal\s+\b' lib/src/ --type dart (타입 없는 final)

아키텍처

Main (오케스트레이터, ~500 토큰/루프)
─────────────────────────────────────
반복:
  Task dispatch → 서브태스크
  결과 수신 → 1줄 출력
  즉시 다음 루프

Subtask (fresh context, 전권)
──────────────────────────────
Phase 1: ANALYZE  → 코드베이스 스캔, N개 개선점 발견
Phase 2: DESIGN   → 각 개선점 설계
Phase 3: IMPLEMENT → 각 개선 구현 + commit
Phase 4: REVIEW   → 최종 품질 검증
Phase 5: COMPLETE → git push + 요약 반환

페르소나

각 Phase의 페르소나 정의, 핵심 질문, 체크리스트는 personas.md를 참조한다.

Phase	페르소나
1. ANALYZE	Senior Software Architect
2. DESIGN	Senior Dart/Flutter Engineer
3. IMPLEMENT	Senior Dart/Flutter Engineer (실행)
4. REVIEW	QA Lead
5. COMPLETE	Technical Writer

탐색 범위 확대 규칙

코드베이스 스캔 시 다음 순서로 범위를 확대한다.

레벨	범위	검사 항목
1	lib/src/	코딩 스탠다드 위반 (함수 길이, 중첩 깊이, var, const)
2	lib/ + test/	스탠다드 위반 + 중복 코드 패턴
3	lib/ + test/ 전체	네이밍, 구조, 성능, 접근성, 문서 품질

• 현재 레벨에서 개선점을 찾으면 해당 개선 진행
• 현재 레벨에서 개선점 0개 → 다음 레벨로 확대 후 재스캔
• 레벨 3에서도 0개 → 레벨 1로 돌아가서 재스캔

---

메인 루프 절차

메인은 서브태스크 dispatch와 결과 출력만 한다. 절대 직접 코드를 편집하지 않는다.

1. 서브태스크 dispatch

Task(
  description: "Loop N: continuous-improvement",
  subagent_type: "general",
  prompt: <서브태스크 프롬프트>,
  timeout: 1800000  // 30분 (밀리초)
)

2. 결과 처리

각 결과 출력 전 date '+%Y-%m-%d %H:%M:%S' 로 현재 시간을 확인하여 함께 출력한다.

• 성공: "[HH:MM:SS] Loop N: X개 개선 완료. Y/Y 테스트 통과." 출력
• 실패: "[HH:MM:SS] Loop N 실패: {이유}. 재시도." 출력 후 동일 N으로 재dispatch
• 타임아웃 (30분): 서브태스크가 30분 초과로 중단된 경우, "[HH:MM:SS] Loop N 타임아웃 (30분 초과). 재시." 출력 후 동일 N으로 재dispatch
• 3회 연속 실패/타임아웃: N 증분 후 다음 루프

3. 즉시 다음 루프

결과 출력 후 질문 없이 즉시 다음 서브태스크를 dispatch한다.

---

서브태스크 프롬프트 템플릿

메인이 dispatch할 때 아래 프롬프트를 서브태스크에 전달한다.

당신은 RadarTUI 프로젝트의 continuous-improvement 루프 실행자입니다.

## 프로젝트 규칙
- AGENTS.md의 모든 규칙을 준수한다 (코딩 스탠다드, Flutter 참조 원칙 등)
- personas.md의 페르소나로 각 Phase를 수행한다
- 상태 파일(backlog 등)은 사용하지 않는다. git이 유일한 상태 관리 도구이다.

## 실행 순서

### Phase 1: ANALYZE (Senior Software Architect)

1. `dart analyze && dart test` 실행
2. 코드 품질 검색 패턴 실행 (SKILL.md §코드 품질 검색 패턴 참조):
   - `rg '\bvar\b' lib/src/ --type dart`
   - `rg 'TODO|FIXME|HACK' lib/src/ --type dart`
   - 함수 길이, 중첩 깊이 수동 스캔
3. 코드베이스 스캔 → 3~5개 개선점 발견
   - Scan Level 1부터 시작, 개선점 없으면 다음 레벨로 확대
   - 검사 항목: 함수 길이(>30줄), 중첩 깊이(>3), var 사용, 누락된 const, 성능
4. 개선점 우선순위 정렬 (영향도 × 난이도)
5. **Architect 체크리스트 검증** (personas.md 참조)

### Phase 2: DESIGN (Senior Dart/Flutter Engineer)

각 개선점에 대해:
1. Flutter 소스 참조 (필요시 AGENTS.md Section 1 기준)
2. 해결 방법 설계:
   - 터미널 적응 사항 명시
   - 변경 영향 범위 파일 목록
   - 기존 테스트 영향 평가
3. **Flutter Engineer 체크리스트 검증** (personas.md 참조)

### Phase 3: IMPLEMENT (Senior Dart/Flutter Engineer — 실행)

각 개선점을 순차적으로:
1. **TDD 원칙 준수**: 코드 변경 시 관련 테스트를 먼저 확인/수정
2. 설계에 따라 코드 수정
3. `dart format .` 실행
4. `dart analyze` 실행 — 0 issues 필수 (에러, 경고, 힌트 모두)
5. `dart test` 실행 — 전체 통과 필수
6. git commit (커밋 메시지에 문제+해결+결과 포함)
   - 예: `perf: cache TextStyle in RenderDropdownMenu — eliminate per-item allocations`
 analyze/test 실패 시 수정 후 재시도 (최대 3회, 그 후 스킵)
  (personas.md 참조)



모든 개선 구현 완료 후:
  — 0 issues
  — 전체 통과
  (personas.md 참조)
 TESTING.md Bug-Prone 영역 재확인
 Flutter 패턴 일치성 확인
 품질 게이트 실패 시 Phase 3으로 돌아가서 수정



  실행
  실행하여 현재 시간 확인
  (personas.md 참조)
 다음 형식으로 결과 반환:
   "DONE: [YYYY-MM-DD HH:MM:SS] Loop N: X개 개선 완료. Y/Y 테스트 통과."
 개선 목록을 간략히 포함할 것


 개별 개선이 3회 실패 → 해당 개선 스킵, 다음 개선으로 진행
 전체 품질 게이트 실패 → 수정 후 재시도
 복구 불가한 실패 → "FAIL: {이유}" 반환


 이전 실행의 미완료 작업이 있으면 으로 확인
 마지막 커밋이 improvement가 아니면 이전 작업이 완료된 것으로 간주
 fresh start로 새 스캔부터 시작

---

루프 복구

컨텍스트 초기화 시 메인은 아무 상태도 가지지 않으므로 복구가 필요 없다. 서브태스크는 항상 fresh start이며, git log로 이전 상태를 파악한다.