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:
hyowons
2026-06-04 15:10:57 +09:00
commit 549545bde6
199 changed files with 49671 additions and 0 deletions
+32
View File
@@ -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
- 파일은 너무 커지지 않게 유지한다.
- 이름은 역할이 드러나게 짓는다.
- 암묵적 규칙보다 명시적 규칙을 택한다.
- 관련 문서는 코드 가까이에 둔다.
+24
View File
@@ -0,0 +1,24 @@
# Quality Gates
모든 변경은 아래 품질 게이트를 통과해야 한다.
## Required
- 요구사항 충족
- 관련 테스트 추가 또는 수정
- 기존 테스트 통과
- 관련 문서 업데이트
- 주요 가정과 제한사항 명시
## Review Checks
- 아키텍처 규칙 위반 없음
- 과도한 복잡도 없음
- 회귀 위험 검토됨
- 오류 처리 누락 없음
- 관측 가능성(로그/메시지/추적) 필요 시 반영됨
## Blockers
- 핵심 로직 변경인데 테스트가 없음
- 요구사항과 다른 동작
- 문서와 실제 구현이 불일치
- 보안, 권한, 데이터 손상 위험
- 확인되지 않은 가정을 사실처럼 구현함
+47
View File
@@ -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 같은 소스관리 도구 없이도 사용할 수 있다.
- 버전 관리 도구가 있다면 연결해도 되지만 필수는 아니다.