diff --git a/.clinerules b/.clinerules index 8f41d2d..cf19f22 100644 --- a/.clinerules +++ b/.clinerules @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일 diff --git a/.cursorrules b/.cursorrules index 8f41d2d..cf19f22 100644 --- a/.cursorrules +++ b/.cursorrules @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일 diff --git a/.workspace-skills/daily-subproject-review/SKILL.md b/.workspace-skills/daily-subproject-review/SKILL.md index 4c58755..b9e167e 100644 --- a/.workspace-skills/daily-subproject-review/SKILL.md +++ b/.workspace-skills/daily-subproject-review/SKILL.md @@ -1,7 +1,7 @@ --- name: daily-subproject-review version: 1.0.0 -description: workspace root 아래 여러 하위 Git repository의 오늘 작업 내용을 짧게 평가하는 일간 분석 스킬. 사용자가 "오늘 작업 평가", "하위 프로젝트 분석", "일간 리뷰", "daily review"를 요청할 때 사용한다. +description: workspace root 아래 여러 하위 Git repository의 오늘 작업 내용, 작업 속도, AI-first 표준화/하네싱 품질을 짧게 평가하는 일간 분석 스킬. 사용자가 "오늘 작업 평가해줘", "오늘 작업 평가", "하위 프로젝트 분석", "일간 리뷰", "daily review"를 요청할 때 사용한다. --- # Daily Subproject Review @@ -9,11 +9,12 @@ description: workspace root 아래 여러 하위 Git repository의 오늘 작업 ## 목적 workspace root의 하위 Git repository를 대상으로 오늘의 작업 내용을 짧게 평가한다. -커밋 수보다 변경의 의미, cross-repo 영향, 위험/누락, 다음 액션을 우선한다. +커밋 수보다 변경의 의미, cross-repo 영향, 작업 속도, AI-first 작업 가능성, 위험/누락, 다음 액션을 우선한다. ## 언제 호출할지 - 사용자가 오늘 작업 내용 평가를 요청할 때 +- 사용자가 "오늘 작업 평가해줘", "오늘 평가해줘"처럼 짧게 요청할 때 - 여러 하위 프로젝트의 일간 진행 상황을 요약해야 할 때 - cross-repo 동기화나 책임 경계 변화가 있었는지 빠르게 확인해야 할 때 - 다음 작업 우선순위를 하루 단위로 정리해야 할 때 @@ -30,6 +31,8 @@ workspace root의 하위 Git repository를 대상으로 오늘의 작업 내용 - [ ] 현재 날짜와 timezone - [ ] workspace root가 제품 repository인지, 여러 하위 repository를 품은 상위 폴더인지 - [ ] `.workspace-skills/shared/target-discovery.md`의 제외 규칙 +- [ ] `.workspace-skills/shared/speed-evaluation.md`의 속도 평가 기준 +- [ ] `.workspace-skills/shared/quality-evaluation.md`의 품질 평가 기준 - [ ] 하위 repository별 working tree 상태 ## 실행 절차 @@ -47,15 +50,29 @@ workspace root의 하위 Git repository를 대상으로 오늘의 작업 내용 - 필요하면 `.workspace-skills/shared/scripts/collect-subprojects.sh`를 실행한다. 4. **변경 의미 평가** - - 커밋을 동기화, 문서/로드맵, 실제 코드 구현, 테스트/검증, 운영 설정으로 분류한다. + - 커밋을 동기화, 표준화/하네싱, 문서/로드맵, 실제 코드 구현, 테스트/검증, 운영 설정으로 분류한다. - 반복 sync 커밋은 실제 진척과 분리해서 본다. -5. **위험과 누락 확인** +5. **작업 속도 평가** + - `.workspace-skills/shared/speed-evaluation.md`의 기준으로 속도 종합평가, 운영 전파, 표준화/하네싱, AI 작업 가능성, 제품 진척, 정렬/기획 속도를 나눠 본다. + - 작업 속도 표의 첫 행은 반드시 `속도 종합평가`로 작성한다. + - `속도 종합평가`의 판단 칸에는 속도 등급, 10점 만점 점수, 보정 이유를 한 문장으로 쓴다. + - 일반 개발자 AI 미사용 대비와 시니어 개발자 AI 미사용 대비 추정 배율을 표로 제시한다. + - 배율은 관측 가능한 git 기록 기반의 추정치로만 말한다. + - 제품 구현 근거가 약하면 `제품 진척` 축만 판정 보류로 두고, 표준화/하네싱 속도는 별도 성과로 인정한다. + +6. **작업 품질 평가** + - `.workspace-skills/shared/quality-evaluation.md`의 기준으로 표준화/하네싱, AI 작업 가능성, 일관성/드리프트 방지, 실행 가능성, 구현/제품 품질, 검증/감사 가능성을 평가한다. + - AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙/스킬/라우팅/ignore/output 기준을 제품 개발 인프라 품질로 평가한다. + - 제품 기능 구현이 없다는 이유만으로 표준화/하네싱 작업의 품질 점수를 낮추지 않는다. + - 작업 품질 표의 첫 행은 반드시 `작업 품질 종합평가`로 작성한다. + +7. **위험과 누락 확인** - 공통 정책이 각 repository에 반영되지 않은 항목을 찾는다. - 로드맵과 실제 코드 상태가 충돌하는지 확인한다. - archive 디렉터리는 사용자가 명시적으로 요청하지 않으면 읽지 않는다. -6. **결과 작성** +8. **결과 작성** - `.workspace-skills/shared/output-format.md`의 일간 분석 형식을 따른다. - 다음 액션은 3개 이내로 정리한다. @@ -71,6 +88,25 @@ workspace root의 하위 Git repository를 대상으로 오늘의 작업 내용 | repo | 오늘 커밋 | 작업 성격 | 평가 | |------|----------:|-----------|------| +## 작업 속도 + +| 속도 항목 | 관측 근거 | 일반 개발자 AI 미사용 대비 | 시니어 AI 미사용 대비 | 판단 | +|-----------|-----------|----------------------------|------------------------|------| +| 속도 종합평가 | <전체 범위와 시간대> | <예: 4-8배> | <예: 2-4배> | <등급, 10점 만점 점수, 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 실행 레일 전파 근거> | <예: 4-8배> | <예: 2-4배> | <평가> | +| AI 작업 가능성 | | <예: 4-8배> | <예: 2-4배> | <평가> | + +## 작업 품질 + +| 품질 항목 | 관측 근거 | 평가 | 판단 | +|-----------|-----------|------|------| +| 작업 품질 종합평가 | <전체 변경 범위> | <예: 높음, 8/10> | <표준화/하네싱/검증 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 하네싱 전파 근거> | <평가> | <판단> | +| AI 작업 가능성 | | <평가> | <판단> | +| 일관성/드리프트 방지 | | <평가> | <판단> | +| 구현/제품 품질 | <코드/테스트 근거> | <평가 또는 판정 보류> | <판단> | +| 검증/감사 가능성 | <검증/추적 근거> | <평가> | <판단> | + ## 위험/누락 - <확인할 항목> @@ -88,11 +124,16 @@ workspace root의 하위 Git repository를 대상으로 오늘의 작업 내용 - [ ] 모든 하위 repository의 working tree 상태를 확인했는가 - [ ] 오늘 커밋이 없는 repository도 누락하지 않았는가 - [ ] sync 커밋과 실질 변경을 구분했는가 +- [ ] 작업 속도를 일반 개발자/시니어 개발자 AI 미사용 대비 표로 제시했는가 +- [ ] 작업 속도 표 첫 행에 `속도 종합평가`를 포함하고 판단 칸에 등급/점수/보정 이유를 썼는가 +- [ ] 작업 품질 표에 `작업 품질 종합평가`, 표준화/하네싱, AI 작업 가능성 평가를 포함했는가 - [ ] archive 디렉터리를 명시 요청 없이 읽지 않았는가 ## 금지 사항 - 분석 요청만 받은 상태에서 하위 repository 파일을 수정하지 않는다. - 커밋 수나 라인 수만으로 생산성을 평가하지 않는다. +- 제품 기능 구현만을 진척 또는 품질의 기준으로 삼지 않는다. +- AI 미사용 대비 배율을 개인 성과나 확정 소요 시간처럼 단정하지 않는다. - `.workspace-skills/**`를 하위 프로젝트 작업량에 포함하지 않는다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`를 명시 요청 없이 읽지 않는다. diff --git a/.workspace-skills/rules/common/rules.md b/.workspace-skills/rules/common/rules.md index 8f41d2d..cf19f22 100644 --- a/.workspace-skills/rules/common/rules.md +++ b/.workspace-skills/rules/common/rules.md @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일 diff --git a/.workspace-skills/rules/project/rules.md b/.workspace-skills/rules/project/rules.md index 255175b..46a45d1 100644 --- a/.workspace-skills/rules/project/rules.md +++ b/.workspace-skills/rules/project/rules.md @@ -26,15 +26,19 @@ ## 스킬 라우팅 -| 요청 키워드 | SKILL.md | -|------------|----------| -| 오늘 작업 평가 / 일간 분석 / daily | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 분석 / weekly / cross-repo 점검 | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 구현 전 점검 / 시작 가능 여부 / pre-implementation | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘 / 오늘 평가해줘 / 일간 분석 / daily | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘 / 이번주 평가해줘 / 주간 분석 / weekly / cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼? / 구현 전 점검 / 시작 가능 여부 / pre-implementation | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 출력 기준 - 커밋 수와 라인 수는 보조 지표로만 사용한다. -- 실제 평가는 변경의 의미, cross-repo 영향, 책임 경계, 위험/누락, 다음 액션을 기준으로 한다. +- 실제 평가는 변경의 의미, 작업 속도, cross-repo 영향, 책임 경계, 위험/누락, 다음 액션을 기준으로 한다. +- 작업 속도는 일반 개발자/시니어 개발자 AI 미사용 대비 추정 배율을 표로 제시하되, 제품 구현과 운영 sync를 분리한다. +- 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선은 제품 기능 구현과 별개의 핵심 품질 성과로 평가한다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 평가한다. +- 제품 기능 구현만을 진척 또는 품질의 기준으로 삼지 않는다. - 최종 답변에는 사용자가 바로 행동할 수 있는 다음 액션을 포함한다. - 단순 분석 요청에서는 파일을 수정하지 않는다. diff --git a/.workspace-skills/shared/output-format.md b/.workspace-skills/shared/output-format.md index 53be1d9..1de97d9 100644 --- a/.workspace-skills/shared/output-format.md +++ b/.workspace-skills/shared/output-format.md @@ -12,6 +12,27 @@ | repo | 오늘 커밋 | 작업 성격 | 평가 | |------|----------:|-----------|------| +## 작업 속도 + +| 속도 항목 | 관측 근거 | 일반 개발자 AI 미사용 대비 | 시니어 AI 미사용 대비 | 판단 | +|-----------|-----------|----------------------------|------------------------|------| +| 속도 종합평가 | <전체 범위와 시간대> | <예: 4-8배> | <예: 2-4배> | <등급, 10점 만점 점수, 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 실행 레일 전파 근거> | <예: 4-8배> | <예: 2-4배> | <평가> | +| AI 작업 가능성 | | <예: 4-8배> | <예: 2-4배> | <평가> | + +<필요하면 신뢰도: 높음/중간/낮음> + +## 작업 품질 + +| 품질 항목 | 관측 근거 | 평가 | 판단 | +|-----------|-----------|------|------| +| 작업 품질 종합평가 | <전체 변경 범위> | <예: 높음, 8/10> | <표준화/하네싱/검증 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 하네싱 전파 근거> | <평가> | <판단> | +| AI 작업 가능성 | | <평가> | <판단> | +| 일관성/드리프트 방지 | | <평가> | <판단> | +| 구현/제품 품질 | <코드/테스트 근거> | <평가 또는 판정 보류> | <판단> | +| 검증/감사 가능성 | <검증/추적 근거> | <평가> | <판단> | + ## 좋은 점 - <핵심 성과> @@ -39,6 +60,27 @@ | 흐름 | 관련 repo | 상태 | 다음 결정 | |------|-----------|------|-----------| +## 작업 속도 + +| 속도 항목 | 관측 근거 | 일반 개발자 AI 미사용 대비 | 시니어 AI 미사용 대비 | 판단 | +|-----------|-----------|----------------------------|------------------------|------| +| 속도 종합평가 | <전체 범위와 시간대> | <예: 3-6배> | <예: 2-3배> | <등급, 10점 만점 점수, 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 실행 레일 전파 근거> | <예: 3-6배> | <예: 2-3배> | <평가> | +| AI 작업 가능성 | | <예: 3-6배> | <예: 2-3배> | <평가> | + +<필요하면 신뢰도: 높음/중간/낮음> + +## 작업 품질 + +| 품질 항목 | 관측 근거 | 평가 | 판단 | +|-----------|-----------|------|------| +| 작업 품질 종합평가 | <전체 변경 범위> | <예: 높음, 8/10> | <표준화/하네싱/검증 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 하네싱 전파 근거> | <평가> | <판단> | +| AI 작업 가능성 | | <평가> | <판단> | +| 일관성/드리프트 방지 | | <평가> | <판단> | +| 구현/제품 품질 | <코드/테스트 근거> | <평가 또는 판정 보류> | <판단> | +| 검증/감사 가능성 | <검증/추적 근거> | <평가> | <판단> | + ## 불일치/중복 - <로드맵, 문서, 구현 사이의 불일치> diff --git a/.workspace-skills/shared/quality-evaluation.md b/.workspace-skills/shared/quality-evaluation.md new file mode 100644 index 0000000..a2104e3 --- /dev/null +++ b/.workspace-skills/shared/quality-evaluation.md @@ -0,0 +1,41 @@ +# Quality Evaluation + +## 목적 + +일간/주간 작업 평가에서 제품 기능 구현만을 품질의 중심으로 보지 않는다. +AI-first 개발에서는 여러 repository에 걸친 표준화, 하네싱, 규칙 전파, drift 방지, 재현 가능한 운영 절차가 agent가 작업 가능한 제품 표면이자 개발 품질의 핵심 성과다. + +## 기본 원칙 + +- 제품 코드 구현은 품질 항목 중 하나일 뿐이며, 유일한 진척 기준이 아니다. +- AI-first 개발에서 cross-repo 표준화/하네싱은 반복 작업 비용과 운영 위험을 낮추는 정도를 넘어, agent 작업의 안전성/재현성/지속성을 결정하는 1급 품질 작업으로 본다. +- 진입 파일, skill routing, ignore 정책, sync 절차, version propagation은 agent-operable surface로 평가한다. +- 단순 sync와 의미 있는 하네싱 개선을 구분한다. +- 문서/roadmap 변경도 실행 절차, 책임 경계, 재현성, 의사결정 품질을 높이면 품질 개선으로 본다. +- 테스트/CI 근거가 없으면 검증 품질은 낮게 보되, 그 이유로 표준화/하네싱 품질 전체를 무효화하지 않는다. +- 전통적 구현 중심 기준으로 AI-first 하네싱 작업을 보조 업무처럼 낮게 평가하지 않는다. + +## 품질 축 + +| 축 | 의미 | 주요 근거 | +|----|------|-----------| +| 작업 품질 종합평가 | 오늘/이번 주 변경이 장기 유지보수성과 실행 품질을 얼마나 높였는지 | 변경 범위, repo 확산도, 표준화 수준, 미검증 위험 | +| 표준화/하네싱 품질 | 여러 프로젝트가 같은 규칙, 스킬, 스크립트, 진입 파일, sync 절차를 공유하게 만든 정도 | agent-ops, rules, entry files, sync scripts, version propagation | +| AI 작업 가능성 | agent가 암묵지 없이 안전하게 탐색, 수정, 평가, 이어받기를 할 수 있게 된 정도 | AGENTS/GEMINI/CLAUDE, skill routing, target discovery, ignore policy, output format | +| 일관성/드리프트 방지 | repo별 운영 규칙 차이를 줄이고 이후 차이를 감지/방지하기 쉬워졌는지 | 공통 파일 동기화, 버전 정책, ignore 정책, routing 규칙 | +| 실행 가능성 | 문서가 실제 실행 절차, 다음 액션, 책임 경계로 이어지는지 | GUIDE, README, roadmap/current, milestone, checklist | +| 구현/제품 품질 | 사용자 기능, 제품 코드, 테스트가 실제로 좋아졌는지 | code diff, test diff, CI/local verification | +| 검증/감사 가능성 | 변경 근거와 완료 상태를 추적하고 재검증하기 쉬운지 | 커밋 메시지, shortstat, version, CI, archive/current 연결 | + +## 출력 표 + +분석 결과에는 다음 표를 포함한다. + +| 품질 항목 | 관측 근거 | 평가 | 판단 | +|-----------|-----------|------|------| +| 작업 품질 종합평가 | <전체 변경 범위> | <예: 높음, 8/10> | <표준화/하네싱/검증 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 하네싱 전파 근거> | <평가> | <판단> | +| AI 작업 가능성 | | <평가> | <판단> | +| 일관성/드리프트 방지 | | <평가> | <판단> | +| 구현/제품 품질 | <코드/테스트 근거> | <평가 또는 판정 보류> | <판단> | +| 검증/감사 가능성 | <검증/추적 근거> | <평가> | <판단> | diff --git a/.workspace-skills/shared/speed-evaluation.md b/.workspace-skills/shared/speed-evaluation.md new file mode 100644 index 0000000..54195ea --- /dev/null +++ b/.workspace-skills/shared/speed-evaluation.md @@ -0,0 +1,62 @@ +# Speed Evaluation + +## 목적 + +일간/주간 작업 평가에서 속도를 별도 축으로 평가한다. +커밋 수 자체가 아니라, AI 지원이 없었다면 일반 개발자와 시니어 개발자가 같은 범위를 처리하는 데 어느 정도 걸렸을지와 비교한다. + +## 기본 원칙 + +- 속도 평가는 생산성 단정이 아니라 관측 가능한 git 기록 기반의 추정치다. +- `agent-ops` sync, 표준화/하네싱, 문서/roadmap 정리, 제품 코드 구현, 테스트/검증을 분리한다. +- 자동화된 sync와 표준화/하네싱은 제품 구현 속도와 분리하고, 운영 전파 및 플랫폼 정렬 속도로 평가한다. +- AI-first 개발에서 agent가 안전하게 작업할 수 있는 하네싱을 빠르게 구축하는 것은 제품 구현 이전의 보조 작업이 아니라 속도 기반 자체를 만드는 작업이다. +- 배율은 넓은 범위로 제시하고, 근거가 약하면 신뢰도를 `낮음`으로 둔다. +- archive 디렉터리는 사용자가 명시적으로 요청하지 않으면 읽지 않는다. + +## 속도 축 + +| 축 | 의미 | 주요 근거 | +|----|------|-----------| +| 속도 종합평가 | 전체 작업 흐름이 AI 미사용 대비 얼마나 빠르게 진행됐는지의 최종 평가 | 전체 커밋 범위, repo 확산도, 실질 변경 비율, 미완료/미검증 위험 | +| 운영 전파 속도 | 공통 규칙, skill, agent-ops 변경이 여러 repo에 퍼진 속도 | 원천 repo 커밋 시각, sync 커밋 시각, 반영 repo 수 | +| 표준화/하네싱 속도 | 여러 repo에 공통 실행 레일, 규칙, 진입 파일, sync 체계를 깐 속도 | agent-ops, rules, entry files, version, sync wave | +| AI 작업 가능성 구축 속도 | agent가 암묵지 없이 작업할 수 있도록 탐색/라우팅/출력/제외 기준을 명시한 속도 | skills, target discovery, output format, entry files, ignore policy | +| 제품 진척 속도 | 실제 제품 코드, 테스트, 사용자 기능이 전진한 속도 | 코드 변경 파일, 테스트 변경, 실행 검증 | +| 정렬 속도 | roadmap, milestone, README, 책임 경계가 정리된 속도 | roadmap/current, 활성 milestone, 문서 변경 | +| 검증 속도 | 변경 후 테스트나 상태 확인이 붙은 정도 | test 파일, CI 로그, 로컬 검증 기록 | + +`속도 종합평가`는 작업 속도 표의 첫 행에 반드시 포함한다. +첫 행의 `판단` 칸에는 속도 등급, 10점 만점 점수, 보정 이유를 한 문장으로 쓴다. +세부 축이 빠르면 그 속도 가치를 인정한다. +검증 근거가 부족하면 검증 위험만 종합평가에 보정한다. +제품 구현이 적다는 이유만으로 표준화/하네싱 중심 작업의 속도나 품질을 낮게 평가하지 않는다. + +## AI 미사용 대비 추정 기준 + +아래 표는 기본 휴리스틱이다. 실제 분석에서는 변경 난이도, repo 수, 테스트 유무, 반복 작업 자동화 여부를 반영해 조정한다. + +| 작업 유형 | 일반 개발자 AI 미사용 기준 | 시니어 개발자 AI 미사용 기준 | AI 사용 시 빠름 판정 예시 | +|-----------|----------------------------|-------------------------------|---------------------------| +| 단일 repo README/문서 갱신 | 0.5-1.5시간 | 0.25-1시간 | 2-4배 | +| roadmap/milestone 재정리 | 1-3시간 | 0.5-2시간 | 2-5배 | +| cross-repo 책임 경계/계획 정렬 | 3-8시간 | 1.5-4시간 | 2-6배 | +| cross-repo 표준화/하네싱 구축 | 4-12시간 | 2-6시간 | 3-8배 | +| 공통 agent-ops/sync 전파 1개 repo | 0.5-1시간 | 0.25-0.5시간 | 3-8배 | +| 5개 이상 repo 동시 정책 전파 | 4-8시간 | 2-4시간 | 4-10배 | +| 제품 코드 구현 + 테스트 | 변경 범위별 별도 산정 | 변경 범위별 별도 산정 | diff와 검증 근거 없으면 판정 보류 | + +## 출력 표 + +분석 결과에는 다음 표를 포함한다. + +| 속도 항목 | 관측 근거 | 일반 개발자 AI 미사용 대비 | 시니어 AI 미사용 대비 | 판단 | +|-----------|-----------|----------------------------|------------------------|------| +| 속도 종합평가 | <전체 범위와 시간대> | <예: 4-8배> | <예: 2-4배> | <예: 빠름, 8/10. 표준화/하네싱 전파가 빠르고 검증 위험만 보정> | +| 운영 전파 | <근거> | <예: 5-8배> | <예: 3-5배> | <평가> | +| 표준화/하네싱 | <근거> | <예: 4-8배> | <예: 2-4배> | <평가> | +| AI 작업 가능성 | <근거> | <예: 4-8배> | <예: 2-4배> | <평가> | +| 제품 진척 | <근거> | <예: 판정 보류> | <예: 판정 보류> | <평가> | +| 정렬/기획 | <근거> | <예: 2-4배> | <예: 1.5-3배> | <평가> | + +필요하면 `신뢰도: 높음/중간/낮음`을 한 문장으로 덧붙인다. diff --git a/.workspace-skills/weekly-subproject-review/SKILL.md b/.workspace-skills/weekly-subproject-review/SKILL.md index 7f3d5d6..708b3af 100644 --- a/.workspace-skills/weekly-subproject-review/SKILL.md +++ b/.workspace-skills/weekly-subproject-review/SKILL.md @@ -1,7 +1,7 @@ --- name: weekly-subproject-review version: 1.0.0 -description: workspace root 아래 여러 하위 Git repository의 최근 1주 흐름, cross-repo 의존성, 로드맵/구현 불일치, 책임 경계 위험을 평가하는 주간 분석 스킬. 사용자가 "주간 분석", "weekly review", "cross-repo 점검"을 요청할 때 사용한다. +description: workspace root 아래 여러 하위 Git repository의 최근 1주 흐름, 작업 속도, AI-first 표준화/하네싱 품질, cross-repo 의존성, 로드맵/구현 불일치, 책임 경계 위험을 평가하는 주간 분석 스킬. 사용자가 "이번주 작업 평가해줘", "주간 분석", "weekly review", "cross-repo 점검"을 요청할 때 사용한다. --- # Weekly Subproject Review @@ -9,11 +9,12 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 ## 목적 하위 repository들의 최근 1주 흐름을 묶어서 평가한다. -일간 분석보다 cross-repo 의존성, 중복 계획, 책임 경계 충돌, 오래 남은 잠금/보류 항목을 더 깊게 본다. +일간 분석보다 cross-repo 의존성, 작업 속도, AI-first 작업 가능성, 중복 계획, 책임 경계 충돌, 오래 남은 잠금/보류 항목을 더 깊게 본다. ## 언제 호출할지 - 사용자가 주간 하위 프로젝트 분석을 요청할 때 +- 사용자가 "이번주 작업 평가해줘", "이번주 평가해줘"처럼 짧게 요청할 때 - 여러 repository의 로드맵이 같은 방향을 보고 있는지 확인해야 할 때 - 다음 주 구현 우선순위를 정하기 전에 전체 흐름을 점검할 때 - cross-repo 경계나 중복 작업이 늘어난 것 같을 때 @@ -29,6 +30,8 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 ## 먼저 확인할 것 - [ ] `.workspace-skills/shared/target-discovery.md`의 제외 규칙 +- [ ] `.workspace-skills/shared/speed-evaluation.md`의 속도 평가 기준 +- [ ] `.workspace-skills/shared/quality-evaluation.md`의 품질 평가 기준 - [ ] 하위 repository 목록과 branch tracking 상태 - [ ] 최근 1주 커밋과 큰 변경 파일 - [ ] 관련 `agent-ops/roadmap/current.md`와 활성 milestone @@ -50,13 +53,28 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 - 같은 기능이 여러 repository에 분산되어 있는지 본다. - 책임 경계가 겹치거나 반대로 비어 있는 영역을 찾는다. - 공통 `agent-ops` sync와 실제 제품 변경을 분리한다. + - 여러 repo에 걸친 표준화/하네싱이 drift 방지, 실행 재현성, AI 작업 가능성에 미친 영향을 본다. -5. **로드맵/구현 불일치 확인** +5. **작업 속도 평가** + - `.workspace-skills/shared/speed-evaluation.md`의 기준으로 속도 종합평가, 운영 전파, 표준화/하네싱, AI 작업 가능성, 제품 진척, 정렬/기획, 검증 속도를 나눠 본다. + - 작업 속도 표의 첫 행은 반드시 `속도 종합평가`로 작성한다. + - `속도 종합평가`의 판단 칸에는 속도 등급, 10점 만점 점수, 보정 이유를 한 문장으로 쓴다. + - 일반 개발자 AI 미사용 대비와 시니어 개발자 AI 미사용 대비 추정 배율을 표로 제시한다. + - 주간 평가는 하루 단위 피크보다 지속성, 반복 sync 비용, repo 간 병목을 더 크게 본다. + - 제품 구현 근거가 약하면 `제품 진척` 축만 판정 보류로 두고, 표준화/하네싱 속도는 별도 성과로 인정한다. + +6. **작업 품질 평가** + - `.workspace-skills/shared/quality-evaluation.md`의 기준으로 표준화/하네싱, AI 작업 가능성, 일관성/드리프트 방지, 실행 가능성, 구현/제품 품질, 검증/감사 가능성을 평가한다. + - AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙/스킬/라우팅/ignore/output 기준을 제품 개발 인프라 품질로 평가한다. + - 제품 기능 구현이 없다는 이유만으로 표준화/하네싱 작업의 품질 점수를 낮추지 않는다. + - 작업 품질 표의 첫 행은 반드시 `작업 품질 종합평가`로 작성한다. + +7. **로드맵/구현 불일치 확인** - 활성 milestone과 실제 변경이 맞는지 확인한다. - 구현 잠금이 오래 남았거나 잠금 없이 구현으로 내려간 흔적이 있는지 본다. - archive 디렉터리는 명시 요청 없이 읽지 않는다. -6. **결과 작성** +8. **결과 작성** - `.workspace-skills/shared/output-format.md`의 주간 분석 형식을 따른다. - 다음 주 초점은 3개 이내로 제안한다. @@ -72,6 +90,25 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 | 흐름 | 관련 repo | 상태 | 다음 결정 | |------|-----------|------|-----------| +## 작업 속도 + +| 속도 항목 | 관측 근거 | 일반 개발자 AI 미사용 대비 | 시니어 AI 미사용 대비 | 판단 | +|-----------|-----------|----------------------------|------------------------|------| +| 속도 종합평가 | <전체 범위와 시간대> | <예: 3-6배> | <예: 2-3배> | <등급, 10점 만점 점수, 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 실행 레일 전파 근거> | <예: 3-6배> | <예: 2-3배> | <평가> | +| AI 작업 가능성 | | <예: 3-6배> | <예: 2-3배> | <평가> | + +## 작업 품질 + +| 품질 항목 | 관측 근거 | 평가 | 판단 | +|-----------|-----------|------|------| +| 작업 품질 종합평가 | <전체 변경 범위> | <예: 높음, 8/10> | <표준화/하네싱/검증 보정 이유> | +| 표준화/하네싱 | <공통 규칙과 하네싱 전파 근거> | <평가> | <판단> | +| AI 작업 가능성 | | <평가> | <판단> | +| 일관성/드리프트 방지 | | <평가> | <판단> | +| 구현/제품 품질 | <코드/테스트 근거> | <평가 또는 판정 보류> | <판단> | +| 검증/감사 가능성 | <검증/추적 근거> | <평가> | <판단> | + ## 불일치/중복 - <확인한 문제> @@ -87,6 +124,9 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 - [ ] `.workspace-skills/**`가 분석 대상에 포함되지 않았는가 - [ ] 공통 sync와 실제 제품 변경을 구분했는가 +- [ ] 작업 속도를 일반 개발자/시니어 개발자 AI 미사용 대비 표로 제시했는가 +- [ ] 작업 속도 표 첫 행에 `속도 종합평가`를 포함하고 판단 칸에 등급/점수/보정 이유를 썼는가 +- [ ] 작업 품질 표에 `작업 품질 종합평가`, 표준화/하네싱, AI 작업 가능성 평가를 포함했는가 - [ ] cross-repo 책임 경계와 의존성을 최소 1회 점검했는가 - [ ] 활성 roadmap/milestone과 실제 변경의 관계를 확인했는가 - [ ] archive 디렉터리를 명시 요청 없이 읽지 않았는가 @@ -95,5 +135,7 @@ description: workspace root 아래 여러 하위 Git repository의 최근 1주 - 주간 분석 중 근거 없이 새 roadmap 항목을 만들지 않는다. - 오래된 잠금 또는 보류 항목을 사용자 확인 없이 해제하지 않는다. +- 제품 기능 구현만을 진척 또는 품질의 기준으로 삼지 않는다. +- AI 미사용 대비 배율을 개인 성과나 확정 소요 시간처럼 단정하지 않는다. - `.workspace-skills/**`를 제품 repository로 평가하지 않는다. - 코드 구현 여부를 확인하지 않고 문서상 완료만으로 완료 판정을 내리지 않는다. diff --git a/AGENTS.md b/AGENTS.md index 8f41d2d..cf19f22 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일 diff --git a/CLAUDE.md b/CLAUDE.md index 8f41d2d..cf19f22 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일 diff --git a/GEMINI.md b/GEMINI.md index 8f41d2d..cf19f22 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -10,17 +10,20 @@ - `.tmp/**`, `.antigravitycli/**`, `**/.git/**`, `**/node_modules/**`, `**/build/**`, `**/dist/**`, `**/.dart_tool/**`, `**/coverage/**`는 일반 분석 대상에서 제외한다. - `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`는 사용자가 명시적으로 요청한 경우에만 읽는다. - 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다. +- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다. +- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다. - git 작업 중 기존 변경을 되돌리지 않는다. ## 스킬 라우팅 아래 요청은 작업 최초 1회 해당 `SKILL.md`를 읽고 수행한다. +짧은 자연어 요청도 같은 의미로 라우팅한다. -| 요청 성격 | SKILL.md | -|----------|----------| -| 오늘 작업 평가, 일간 하위 프로젝트 분석, daily review | `.workspace-skills/daily-subproject-review/SKILL.md` | -| 주간 하위 프로젝트 분석, cross-repo 점검, weekly review | `.workspace-skills/weekly-subproject-review/SKILL.md` | -| 큰 구현 전 점검, 구현 시작 가능 여부 확인, pre-implementation review | `.workspace-skills/pre-implementation-review/SKILL.md` | +| 요청 예시 | 요청 성격 | SKILL.md | +|----------|----------|----------| +| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | `.workspace-skills/daily-subproject-review/SKILL.md` | +| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | `.workspace-skills/weekly-subproject-review/SKILL.md` | +| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | `.workspace-skills/pre-implementation-review/SKILL.md` | ## 진입 파일