이랑이
bac114d469
- CLAUDE.md 를 .claude/rules/ 4파일로 분할 (project/stack/principles/workflow) - Plans.md 루트 인덱스 (스프린트 목차 + 참조만) - hooks/ pre/post-tool.sh 스켈레톤 (no-op, Sprint 002에서 구현) - .plans/OVERVIEW.md — 목표/범위/성공기준 8개 - .plans/failure-audit.md — F1~F6 실패 감사 (증거 기반) - .plans/design/ 6개 문서: * state-machine.md (XState v5 FSM 설계) * sprint-contract.md (Zod schema + validator) * skill-enforcement.md (4계층 방어) * handoff.md (상태 전이 기반 자매 통신) * retry-policy.md (backoff + escalation) * qa-template.md (체크리스트 runtime) - .plans/sprints/ 8개 스프린트 명세 (SPRINT-000~007) - .plans/migration/from-hanarang-harness.md (자산 매트릭스 + 단계별 가이드) 총 17개 문서, 약 2146 lines. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
68 lines
3.3 KiB
Markdown
68 lines
3.3 KiB
Markdown
# SPRINT-007 — hanarang-harness 마이그레이션 + 실서비스 투입
|
|
|
|
> **목표**: 기존 hanarang-harness 사용자(=나봄하랑, 4자매)가 hanarang-rails 로 옮겨 실사용. 기존 프로젝트(아랑 등)에 바로 적용.
|
|
|
|
## Type
|
|
`migration`
|
|
|
|
## Prerequisites
|
|
- Sprint 001 ~ 006 완료
|
|
- `.plans/migration/from-hanarang-harness.md` 확정
|
|
- 기존 hanarang-harness-archive 에 대한 read-only 접근
|
|
|
|
## Scope
|
|
|
|
- `rails migrate from-hanarang-harness <path>` CLI — 기존 repo 를 읽어 hanarang-rails 세팅으로 변환
|
|
- scaffold.sh 기능 포팅 → `rails scaffold` (프로젝트별 `.plans/` 구조 생성)
|
|
- install.sh --role 기능 포팅 → `rails install --role <role>`
|
|
- doctor.sh 기능 확장 → `rails doctor` + environment_prerequisites 체크
|
|
- hanarang-harness 의 agent md 파일 → `rails agents import`
|
|
- 4자매 LXC (104~107) 에 rails 설치 스크립트
|
|
- 아랑(Arang) 프로젝트를 rails 로 운영 (첫 실사용 프로젝트)
|
|
- 기존 bridge.sh 제거 + discord.js bridge 로 교체
|
|
- 문서: `docs/migration-guide.md`, `docs/operations.md`
|
|
|
|
## Non-Goals
|
|
|
|
- 기존 hanarang-harness repo 영구 삭제 (archive 유지)
|
|
- 모든 기존 프로젝트 일괄 마이그레이션 (아랑만 first)
|
|
- 백업/롤백 자동화 (수동)
|
|
|
|
## Tasks
|
|
|
|
| # | 내용 | DoD | Status |
|
|
|---|---|---|---|
|
|
| 7.1 | `rails migrate from-hanarang-harness` 스캐너 | source 분석 레포트 | cc:TODO |
|
|
| 7.2 | `.plans/` 구조 변환 로직 | hanarang-harness .plans/ → rails .plans/ | cc:TODO |
|
|
| 7.3 | agent md 파일 포팅 (`rails agents import`) | 4자매 프롬프트 유효 | cc:TODO |
|
|
| 7.4 | `rails scaffold <project>` — .plans/ 구조 생성 | scaffold test | cc:TODO |
|
|
| 7.5 | `rails install --role <role>` — 4자매 LXC 설치 | install test | cc:TODO |
|
|
| 7.6 | `rails doctor` — env prereq + 4자매 gateway | erang 실기동 확인 | cc:TODO |
|
|
| 7.7 | discord.js bridge 배포 (기존 bridge.sh 대체) | 디스코드 알림 동작 | cc:TODO |
|
|
| 7.8 | 4자매 LXC (104~107) 에 rails 배포 | 전 자매 `rails --version` 동일 | cc:TODO |
|
|
| 7.9 | 아랑(Arang) 프로젝트에 rails 적용 | 첫 실제 Sprint 완주 | cc:TODO |
|
|
| 7.10 | 운영 문서 작성 (`docs/operations.md`) | 트러블슈팅 가이드 포함 | cc:TODO |
|
|
| 7.11 | hanarang-harness → hanarang-rails 체인지로그 | `CHANGELOG.md` 작성 | cc:TODO |
|
|
| 7.12 | 회고 문서 (`.plans/retro/hanarang-harness-retro.md`) | 교훈 정리 | cc:TODO |
|
|
|
|
## Definition of Done
|
|
|
|
### 자동
|
|
- `rails migrate from-hanarang-harness ../hanarang-harness-archive` 성공
|
|
- `rails install --role planner` → 4자매 LXC 에 rails 설치 확인
|
|
- `rails doctor` 가 4자매 gateway 전부 OK
|
|
- 아랑 프로젝트 Sprint 001 을 rails 로 실행 → end-to-end 완주 (사용자 개입 최소)
|
|
|
|
### 수동
|
|
- [ ] 디스코드 포럼 포스트가 정상 생성되는지
|
|
- [ ] 4자매 멘션 알림이 정상 전달되는지
|
|
- [ ] 에스컬레이션 상황에서 사용자가 1번에 이해할 수 있는지
|
|
- [ ] 기존 hanarang-harness 의 실패 모드 F1~F6 재현 시도 → 모두 재현 불가
|
|
|
|
## Exit Criteria
|
|
|
|
- 나봄하랑이 실제로 rails 를 사용 중
|
|
- 아랑 프로젝트 (또는 후속 프로젝트) 의 최근 1주일 파이프라인 전수 성공률 ≥ 90%
|
|
- 에스컬레이션 발생 시 원인과 복구 경로가 명확
|
|
- 기존 hanarang-harness 로 복귀할 이유 없음
|