Initial commit: Add project files

docs/templates/ADR.md

@@ -0,0 +1,13 @@
+# ADR-XXX Title
+
+- Status: Proposed / Accepted / Superseded / Deprecated
+- Date:
+- Owners:
+- Source:
+- Context:
+- Decision:
+- Alternatives:
+- Consequences:
+- Fitness Functions:
+- Migration/Rollback:
+- Supersedes:

docs/templates/AI_CHANGE_CHECKLIST.md

@@ -0,0 +1,12 @@
+# AI Change Checklist
+
+- [ ] Source와 문서 위치가 있다.
+- [ ] Assumption/Unknown/Design Proposal을 구분했다.
+- [ ] 새 정책·임계값·컬럼·API를 임의 생성하지 않았다.
+- [ ] 변경 범위는 한 Slice/목적이다.
+- [ ] 실행한 명령과 exit code를 기록했다.
+- [ ] 실패/skip/미실행 테스트를 기록했다.
+- [ ] Golden/Data/Architecture/E2E 영향이 있다.
+- [ ] 민감정보가 없다.
+- [ ] rollback과 잔여위험이 있다.
+- [ ] 사람 승인자가 명시됐다.

docs/templates/DATA_CONTRACT.md

@@ -0,0 +1,11 @@
+# Data Contract
+
+- Source/license/SLA/schema version:
+- Timezone/unit/currency:
+- source_event_time / published_at / ingested_at:
+- effective_from/to / revision_no:
+- source_id / content_hash / dataset_id:
+- DQ PASS/WARN/QUARANTINED rules:
+- tradable_session rule:
+- lineage / watermark / replay:
+- Owner / steward / retention:

docs/templates/FEATURE_PACKET.md

@@ -0,0 +1,15 @@
+# Feature Packet
+
+- Requirement ID:
+- Slice ID:
+- User outcome:
+- Non-goals:
+- Source / Assumption / Unknown / Decision Required:
+- Policy/Data/API/DB/Job/UI/Test IDs:
+- PIT cutoff and units:
+- State transitions / invariants:
+- Failure paths / ProblemDetails:
+- Idempotency / concurrency / transaction:
+- Metrics / alerts / runbook / rollback:
+- Commands actually executed and artifacts:
+- Owner / reviewer / approver:

docs/templates/IMPROVEMENT_PROPOSAL.md

@@ -0,0 +1,18 @@
+# Model Improvement Proposal
+
+- Proposal ID / Expiry:
+- Base Model Version:
+- Proposal Type:
+- Problem statement:
+- Evidence IDs and hashes:
+- Counter-evidence:
+- Root-cause hypothesis:
+- Expected benefit:
+- Customer/operational/regulatory risks:
+- Data and license impact:
+- Algorithm/policy/metric contract impact:
+- Required Golden/OOS/PBO/DSR/cost tests:
+- Rollback plan:
+- Owner / Secondary:
+- Status: DRAFT / REVIEW_REQUIRED / APPROVED_FOR_RESEARCH / REJECTED / EXPIRED
+- Explicit boundary: no automatic code/config/model activation

docs/templates/MODEL_CHANGE.md

@@ -0,0 +1,18 @@
+# Model/Policy Change
+
+- Change ID:
+- Policy ID:
+- Source:
+- Assumption:
+- Unknown / Decision Required:
+- Old Version Set:
+- New Version Set:
+- Formula / threshold diff:
+- Characterization diff:
+- Golden diff:
+- Frozen OOS result:
+- Cost x2 result:
+- Market/asset/regime impact:
+- False-exit/Reentry/ES impact:
+- Rollback trigger:
+- Quant/Risk approvers:

docs/templates/MODEL_EVALUATION_EVIDENCE.md

@@ -0,0 +1,20 @@
+# Model Evaluation Evidence
+
+- Evaluation ID:
+- Operation Code / Schedule Version:
+- Scope / Cohort / Window:
+- Dataset ID / Hash:
+- Model / Config / Code / Contract Version:
+- Metric Definition Version:
+- PIT cutoff / Published-at rule:
+- Sample size / Missing / Quarantine:
+- Results and confidence intervals:
+- Baseline / Champion / Challenger:
+- Costs / Tax / FX / Slippage scenario:
+- Counter-evidence:
+- Operational integrity errors:
+- Gate result and blocking reasons:
+- Source / Assumption / Unknown / Decision Required:
+- Commands / Artifact hashes:
+- Independent validator:
+- Maker / Checker:

docs/templates/MODEL_OPERATIONS_RUNBOOK.md

@@ -0,0 +1,17 @@
+# Model Operations Runbook
+
+- Operation Code / Queue / Scope:
+- Owner / Secondary:
+- Due SLA / Max lag:
+- Inputs and frozen VersionSet:
+- Expected output:
+- Metrics and alerts:
+- TRANSIENT retry policy:
+- BUSINESS_HOLD resolution:
+- QUARANTINE resolution:
+- Dead-letter replay procedure:
+- Duplicate/idempotency check:
+- Data revision/correction procedure:
+- Rollback/disable scheduler procedure:
+- PII/secret handling:
+- Last rehearsal / Evidence hash:

docs/templates/RELEASE_EVIDENCE.md

@@ -0,0 +1,11 @@
+# Release Evidence
+
+- Release/commit/container digest:
+- Source coverage and supersession diff:
+- OpenAPI/DDL/Event/Job/UI contract diff:
+- Build/test/migration commands and results:
+- Golden/OOS/data/replay evidence:
+- Security/PII/license/SBOM evidence:
+- Metrics/alerts/runbooks/rollback rehearsal:
+- Capability flags and kill-switch state:
+- Approvals:

docs/templates/RUNBOOK.md

@@ -0,0 +1,14 @@
+# Runbook
+
+- Service/Job/Slice:
+- Owner / Secondary:
+- SLO/SLA:
+- Metrics/Alerts:
+- Detection:
+- Triage:
+- Kill-switch scope:
+- Safe retry/replay:
+- Reconciliation:
+- Rollback:
+- Evidence to retain:
+- Escalation:

docs/templates/SLICE_SPEC.md

@@ -0,0 +1,20 @@
+# Slice Spec: <VS-ID> <Name>
+
+- Requirement ID:
+- Policy/Data/Screen ID:
+- 사용자 결과:
+- 비목표:
+- 권한/Capability:
+- 선행 데이터와 PIT cutoff:
+- 상태전이:
+- Endpoint/Event/Job:
+- DB Migration/Read Model:
+- Idempotency/Concurrency:
+- Given/When/Then:
+- Tests:
+- Metrics/Alerts:
+- Runbook/Rollback:
+- Owner/Secondary:
+- Source:
+- Assumption:
+- Unknown/Decision Required:

docs/templates/TECH_DEBT_ITEM.md

@@ -0,0 +1,10 @@
+# Technical Debt Item
+
+- ID / priority:
+- Risk and interest:
+- Root cause:
+- Owner / secondary:
+- Remediation:
+- Trigger / due / gate:
+- Exit test:
+- Temporary control and expiry:

docs/templates/TRACEABILITY.md

@@ -0,0 +1,5 @@
+# Traceability
+
+| REQ | POLICY/DATA | SLICE | ENDPOINT/JOB | DB/EVENT | SCREEN/COMPONENT | TEST | METRIC/RUNBOOK | PR |
+|---|---|---|---|---|---|---|---|---|
+| | | | | | | | | |