이랑이
da85b92a6b
Sprint 006 전체 구현 — F3/F2 의 QA 측면 완성:
Schema:
- src/qa/schema.ts — QaTemplate, QaChecklistResult, QaArtifact Zod 스키마
- Zod + DodCheck 재사용
Templates (6종 YAML):
- qa-templates/scaffold-v1.yaml — README/LICENSE/gitignore/lockfile/strict
- qa-templates/feature-v1.yaml — tests/typecheck/no-console/no-any/tests-added
- qa-templates/bugfix-v1.yaml — regression-test/root-cause/no-scope-creep
- qa-templates/refactor-v1.yaml — tests/typecheck/no-behavior-change
- qa-templates/migration-v1.yaml — rollback/dry-run/data-loss/backup (critical)
- qa-templates/infra-v1.yaml — config-validated/secrets/rollback
Core:
- src/qa/template.ts — YAML loader, extends 체인 resolution, 프로젝트별 extras
- src/qa/verdict.ts — verdict 규칙 (critical/major → REQUEST_CHANGES,
minor/recommendation 만 → APPROVE_WITH_NITS, 절대 REQUEST_CHANGES 안 됨)
- src/qa/runtime.ts — runQaTemplate: Contract check handlers 재사용
manual 체크는 resolver 주입 가능 (없으면 SKIP 기본값)
CLI:
- rails qa run <type> [-s sprint-id] [-w workdir]
- rails qa show <artifact-id>
- rails qa templates (목록)
Tests (19 신규, 101 total pass):
- computeVerdict 7가지 시나리오 (APPROVE / APPROVE_WITH_NITS / REQUEST_CHANGES / ABORT)
- minor-only 는 절대 REQUEST_CHANGES 안 된다는 rule 명시 테스트
- Template loader + listTemplates + extends merge
- runtime: file_exists pass/fail + manual resolver 주입 + artifact 저장
- scaffold-v1 실파일 로드 확인
검증: tsc --noEmit ✓ | vitest 101/101 ✓ | build ✓
rails qa templates → 6개 전부 출력 ✓
사용자 메모리 feedback_qa_thorough.md 준수:
- 체크 항목 수 제한 없음
- 각 템플릿이 타입별로 세분화됨
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
hanarang-rails
4자매가 달릴 결정론적 레일 — HaNaRang Rails
hanarang-harness의 후계작. 기존 하네스가 "권고 기반 파이프라인"이라 자매들이 레일을 벗어나 끊기고 엇갈리던 문제를 강제 기반 결정론 파이프라인으로 재설계한다.
왜 다시?
hanarang-harness에서 발견된 6가지 실패 모드:
| 코드 | 증상 | 원인 |
|---|---|---|
| F1 | 하네스 skill bypass — 자매가 worker 혼자 스폰하고 처리 | skill 진입 강제 없음 |
| F2 | DoD 자동 강제 실패 — build 통과 = 완료로 간주 | sprint contract / validator 없음 |
| F3 | QA 단계 누락 — 사용자가 수동으로 다랑이 호출 | 자동 라우팅 없음 |
| F4 | 핸드오프 멘션 불안정 — 잘못된 자매 호출 | Lobster 분기가 LLM에 의존 |
| F5 | 중간 끊김 — request-timed-out 반복, xhigh 무한대기 | 재시도/fallback 정책 없음 |
| F6 | 환경 검증 누락 — "서버에 Docker 없음" 으로 skip 용인 | 환경 전제 검사 없음 |
6가지 원칙
- 결정론적 라우터 — LLM 판단이 아니라 XState FSM으로 자매 간 전이
- Sprint Contract 강제 — DoD를 Zod 스키마로 정의, validator가 pass/fail 판정
- Skill 강제 진입 — skill bypass를 hook으로 감지해 차단
- 상태 전이 기반 핸드오프 — 멘션은 사용자 알림 전용, 자매 간 통신은 FSM 상태
- 재시도/에스컬레이션 — timeout 자동 재시도, N회 실패 시 사용자 에스컬레이션
- QA 체크리스트 강제 — 스프린트 타입별 템플릿, 다랑이가 체크박스 다 채워야 pass
아키텍처 개요
사용자 (디스코드)
│
▼
┌────────────────────────────────────┐
│ hanarang-rails orchestrator │
│ (XState FSM + SQLite + validator) │
└──────────────────┬─────────────────┘
│
┌───────────┼───────────┬───────────┐
▼ ▼ ▼ ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ 하랑 │ │ 나랑 │ │ 다랑 │ │ 이랑 │
│Planner│ │ Impl │ │ QA │ │Deploy│
└──────┘ └──────┘ └──────┘ └──────┘
│ │ │ │
└───────────┴─ OpenClaw spawn ──────┘
│
▼
┌────────────┐
│ Discord 알림│ ← 사용자 알림 전용
└────────────┘
기술 스택
| 레이어 | 선택 |
|---|---|
| 런타임 | Node 22 + TypeScript (strict) |
| 상태 머신 | XState v5 |
| 스키마 | Zod |
| 영속화 | SQLite (better-sqlite3) |
| 프로세스 | execa + AbortController |
| CLI | citty |
| 로그 | pino |
| 디스코드 | discord.js v14 |
| 테스트 | Vitest |
상태
🚧 기획 단계 — .plans/ 디렉토리 참조.
자세한 내용:
.plans/OVERVIEW.md— 프로젝트 전체 개요.plans/failure-audit.md— 실패 감사.plans/design/— 설계 문서.plans/sprints/— 스프린트 상세
라이선스
MIT