[STORY][CFP] RefactorAgent Reusability 1급 축 신설 — ISO/IEC 25010 유지보수성 gap 충당 (중복검출 트리거 + output 슬롯 + cross-cutting/repo-분리 scope 예외 + 측정 연동)

[mccho-mclayer]

배경 (실증 결과)

세션 실증 결과 RefactorAgent 의 코드 품질 향상이 ISO/IEC 25010 유지보수성 5축(Modularity / Reusability / Analysability / Modifiability / Testability) 중 Modularity 1축만 1급으로 다루고, 사용자가 지목한 Reusability(재사용성)는 명시 공백임이 실측으로 확인됨.

실증 증거 (RefactorAgent.md 실측)

1. "재사용성/reusability" 0회 — 재사용 관련은 (b) "DRY/WET" 1구절 + to-be "공통화 가능 지점" 1 bullet 뿐 (L42, L111).
2. 검출 기제가 size-only(줄 수/메서드 수, L41) → 중복(clone/duplication)에 구조적 맹목. 50줄 메서드가 10파일 복붙돼도 각 파일 300줄 미만이면 전 트리거 통과.
3. output template = (a)/(b)/(c) 3슬롯 — 재사용 제안 home 없음, self-check 도 재사용 누락 미검사 (L58-79).
4. scope guard(L51 "요건 충족 범위로 한정" + L142 "계획서 범위 밖 리팩토링 금지")가 cross-cutting 재사용 추출(본질적으로 global)을 구조적 억제.
5. 향상 측정 metric/feedback loop 부재 (읽기전용 advisory, L138) → "제대로 향상" unfalsifiable.
6. sibling deputy 도 code reusability 1급 미소유 (DataArch de-dup = OLAP data, ModuleArch = boundary axis) → 진짜 균열.
7. repo-level 분해(macro-cohesion) mandate 0 (RefactorAgent·ModuleArch 양쪽).

근거 표준: ISO/IEC 25010:2023 Product quality model — Maintainability 하위축에 Reusability 명시.

결정 (권장 1안)

RefactorAgent 에 Reusability 를 카테고리 (a)와 동급 1급 축으로 신설:

1. 중복 검출 정량 트리거(clone/duplication 신호) 추가
2. output template 에 재사용성 전용 슬롯 + self-check 항목 추가
3. cross-cutting 재사용 추출은 escalation-tier 로 scope guard 예외 명문화
4. repo-level 분해(macro-cohesion)를 동축 수용 — 단 RefactorAgent 는 결합도/응집도 pressure 제안(advocacy)만, 경계 확정은 ModuleArch + ArchitectAgent (axis disjoint 유지)
5. 측정 연동 — ArchitectAgent 통합/구현리뷰 게이트와 before/after 신호 연결 hook

axis disjoint (ADR-086 self-application)

• RefactorAgent (reusability/decoupling advocacy — 중복·DRY·공통추출·repo-split pressure) ↔ ModuleArchitectAgent (boundary authority — module/package/aggregate 경계 placement) = disjoint. RefactorAgent 는 pressure 식별·제안, ModuleArch+chief 는 경계 결정.

범위 (단일 PR)

• plugins/codeforge-design/agents/RefactorAgent.md — reusability 축 신설
• skills/deputy-mandate/SKILL.md (wrapper canonical) — RefactorAgent mandate 갱신 (primary axis matrix + DDD pattern mapping)
• plugins/codeforge-design/CLAUDE.md (mirror) — sibling sync
• archive/adr/ADR-042-agent-model-selection-policy.md — Amendment 11 (+ ADR-086 axis 분석 + 5-checklist embed)
• plugins/codeforge-design/.claude-plugin/plugin.json — 0.25.4 → 0.26.0 (MINOR, additive mandate)
• mclayer/marketplace — version sync PR (선행 merge, ADR-063)

lane 적용

• 요구사항/요구사항리뷰/설계: 본 Issue 본문에 통합 (Orchestrator 실증 선행)
• 구현 + 구현리뷰(dual-peer Claude+Codex 적대 검증): 실행
• 통합테스트/보안테스트/배포/배포리뷰: wrapper-self N/A

검증 기준

• axis disjoint(RefactorAgent advocacy ↔ ModuleArch authority) 명시
• SSOT 3원본(RefactorAgent.md / deputy-mandate SKILL.md / CLAUDE.md mirror) byte-consistent
• doc frontmatter/section schema PASS, invariant-check PASS
• ADR-042 Amendment 11 번호 정합 + ADR-086 5-checklist 충족
• no-overclaim (실측 근거 인용)

🤖 Generated with Claude Code

[github-actions]

⚠️ Phase progression invariant violation (CFP-85 / CFP-90)

Story Issue closed at non-terminal phase: phase:설계-리뷰.

Expected: phase:보안-테스트 (default after security test PASS) OR phase:완료 + gate:design-review-pass + gate:retro-complete (CFP-1577 lifecycle 완주 — CFP-2149) OR early-close:<reason> label (Epic 종료 / 중복 / Out-of-scope reclassify 등 명시).

Action required (one of):

1. 올바른 progression: Issue 재open → 정상 lane 진행 → terminal phase 도달 후 close
2. Early close 정당화: early-close:<reason> label 부착 (예: early-close:duplicate, early-close:reclassified, early-close:epic-rolled-up)

본 alert = policy_violation defect 추적 source (ADR-025 stop discipline metric).

자동 재open 안 함 (manual decision 의무).

[github-actions]

[PMO] Retro mandatory check (CFP-138 / ADR-045)

Phase 2 PR #2366 merged Phase marker absent (option C-prime PR — L5 fallback, CFP-654).
First attempt (PR merge + 5min grace) 후에도 gate:retro-complete label 부재 — retro 자동 작성 trigger 필요.

Action required:

1. PMOAgent re-spawn (Orchestrator 자동 또는 사용자 요청)
2. retro file 작성 → /wrapper/retros/-cfp-NNN-.md
3. Story §11 schema update (retro_file / retro_summary / learnings_count / feedback_back_to_codeforge)
4. gate:retro-complete label add (PMOAgent self-write)

Retry policy (ADR-045 D-4 cumulative offset from PR merge):

• First attempt: PR merge + 5min (grace period — 본 attempt fail)
• Retry 1: PR merge + 10min (5min wait)
• Retry 2: PR merge + 20min (10min wait)
• Retry 3: PR merge + 35min (15min wait, final attempt)
• Total attempts = 4 (1 initial + 3 retries)
• Total max latency = 35min from PR merge → ESCALATE 사용자 + Story close 차단 유지

본 alert 는 retry 시 중복 게시 안 함 (idempotent).

NOTE: Phase 1 PR scope 본 workflow = first attempt 만 implement. retry 1/2/3 state machine = Phase 2 PR scope deferred (ADR-045 §D-4 Phase 2 implementation spec).