Initial commit: OpenClaw 워크스페이스 버전관리 시작
설정·스크립트·스킬·문서·큐레이션 메모리 추적. 시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)· 백업(clobbered/bak)·dream 캐시는 .gitignore로 제외. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,32 @@
|
||||
# Architecture
|
||||
|
||||
## Goal
|
||||
이 저장소는 에이전트가 이해하고 수정하기 쉬운 구조를 유지하는 것을 목표로 한다.
|
||||
|
||||
## Principles
|
||||
- 구조는 단순하게 유지한다.
|
||||
- 경계는 명확하게 둔다.
|
||||
- 숨은 규칙보다 문서화된 규칙을 우선한다.
|
||||
- 에이전트가 읽을 수 없는 지식은 없는 지식으로 간주한다.
|
||||
|
||||
## Recommended Layers
|
||||
프로젝트 특성에 맞게 조정하되, 아래처럼 역할을 분리한다.
|
||||
|
||||
- Types / Schema
|
||||
- Config
|
||||
- Repository / Data Access
|
||||
- Service / Domain Logic
|
||||
- Runtime / API / App Layer
|
||||
- UI (해당 시)
|
||||
|
||||
## Constraints
|
||||
- 비즈니스 로직은 경계가 분명한 계층 안에 둔다.
|
||||
- 데이터 입출력은 경계에서 검증한다.
|
||||
- 공통 규칙은 문서와 도구로 강제한다.
|
||||
- 복잡한 예외 규칙은 최소화한다.
|
||||
|
||||
## Agent-friendly Design
|
||||
- 파일은 너무 커지지 않게 유지한다.
|
||||
- 이름은 역할이 드러나게 짓는다.
|
||||
- 암묵적 규칙보다 명시적 규칙을 택한다.
|
||||
- 관련 문서는 코드 가까이에 둔다.
|
||||
@@ -0,0 +1,24 @@
|
||||
# Quality Gates
|
||||
|
||||
모든 변경은 아래 품질 게이트를 통과해야 한다.
|
||||
|
||||
## Required
|
||||
- 요구사항 충족
|
||||
- 관련 테스트 추가 또는 수정
|
||||
- 기존 테스트 통과
|
||||
- 관련 문서 업데이트
|
||||
- 주요 가정과 제한사항 명시
|
||||
|
||||
## Review Checks
|
||||
- 아키텍처 규칙 위반 없음
|
||||
- 과도한 복잡도 없음
|
||||
- 회귀 위험 검토됨
|
||||
- 오류 처리 누락 없음
|
||||
- 관측 가능성(로그/메시지/추적) 필요 시 반영됨
|
||||
|
||||
## Blockers
|
||||
- 핵심 로직 변경인데 테스트가 없음
|
||||
- 요구사항과 다른 동작
|
||||
- 문서와 실제 구현이 불일치
|
||||
- 보안, 권한, 데이터 손상 위험
|
||||
- 확인되지 않은 가정을 사실처럼 구현함
|
||||
@@ -0,0 +1,47 @@
|
||||
# Workflows
|
||||
|
||||
## Default Flow
|
||||
1. 요청 수신
|
||||
2. Orchestrator가 작업 분해
|
||||
3. acceptance criteria 정의
|
||||
4. Developer가 구현
|
||||
5. Reviewer가 10점 만점 기준으로 검수 점수를 부여한다.
|
||||
6. 점수가 8점 미만이면 Orchestrator는 Reviewer 피드백을 포함해 다시 Developer에게 재작업을 요청한다.
|
||||
7. 이 루프는 최대 3번까지 반복한다.
|
||||
8. 점수가 8점 이상이면 승인 후 완료한다.
|
||||
9. 3회 재작업 이후에도 8점 미만이면 BLOCKED로 전환하고 사람 판단을 요청한다.
|
||||
|
||||
## Status
|
||||
- NEW
|
||||
- PLANNED
|
||||
- IN_PROGRESS
|
||||
- IN_REVIEW
|
||||
- CHANGES_REQUESTED
|
||||
- DONE
|
||||
- BLOCKED
|
||||
|
||||
## Review Retry Policy
|
||||
- Reviewer는 모든 검수 결과에 10점 만점 기준 점수를 포함한다.
|
||||
- 점수 8점 이상: 통과 가능
|
||||
- 점수 8점 미만: 재작업 필요
|
||||
- 최대 재작업 횟수: 3회
|
||||
- 3회 초과 시 Orchestrator는 자동 재시도를 중단하고 사람에게 에스컬레이션한다.
|
||||
|
||||
## When to Create an Exec Plan
|
||||
아래 중 하나라도 해당하면 exec plan을 만든다.
|
||||
- 작업이 30분 이상 걸릴 가능성이 있음
|
||||
- 여러 파일/여러 단계가 연관됨
|
||||
- 요구사항 해석이 중요함
|
||||
- 리스크나 의존성이 있음
|
||||
|
||||
## Reporting Format
|
||||
각 에이전트는 결과를 짧고 구조적으로 보고한다.
|
||||
- what changed
|
||||
- why
|
||||
- validation
|
||||
- risks
|
||||
- next action
|
||||
|
||||
## Notes
|
||||
- 이 템플릿은 Git, SVN 같은 소스관리 도구 없이도 사용할 수 있다.
|
||||
- 버전 관리 도구가 있다면 연결해도 되지만 필수는 아니다.
|
||||
Reference in New Issue
Block a user