Migration Kit

xlsx/csv -> PostgreSQL 마이그레이션을 대상으로, Blue Team이 spec을 만들고 Red Team이 이를 독립 검수해 go / review-needed / blocked를 판정하는 CLI-first MVP다.

Status

• MVP 로드맵 구현과 roadmap wrap-up 완료
• 현재 남은 일은 next product cut 결정과 소규모 optional backlog 정리
• 최신 기준 검증: make check -> 41 passed

Core Surface

• 사용자 명령:
  • smk init
  • smk draft-spec
  • smk validate-spec
  • smk approve-spec
  • smk dry-run
  • smk export-load
  • smk reconcile
• 내부 개발 하네스:
  • smk workflow-init
  • smk workflow-advance
  • smk workflow-status

Implemented Baseline

• source: csv, xlsx 단일 시트
• target metadata: schema yaml, optional code table/hints
• draft adapter:
  • heuristic-bootstrap
  • openai-responses:<model-name>
  • alias: heuristic, local-heuristic
• deterministic fail-closed:
  • unknown field / transform / transform params
  • spec approval missing
  • source parsing failure
  • unknown draft adapter
  • export artifact summary mismatch
• PII-safe defaults:
  • evidence/report/reject artifacts masking 우선

Regression Baseline

• members: go
• members-review-needed: review-needed
• members-export-integrity: tampered export -> fail-closed
• applications: blocked
• policy baseline:
  • delivery-loop.yaml
  • variation-loop.yaml

Quick Start

make setup-dev
./.venv/bin/smk init ./demo
./.venv/bin/smk --project-dir ./demo draft-spec --source fixtures/members.csv --schema schemas/target-schema.yaml --out specs/draft-spec.yaml
./.venv/bin/smk --project-dir ./demo validate-spec --spec specs/mapping-spec.yaml
./.venv/bin/smk --project-dir ./demo approve-spec --spec specs/mapping-spec.yaml --approver lead01 --note "reviewed"
./.venv/bin/smk --project-dir ./demo dry-run --source fixtures/members.csv --spec specs/mapping-spec.yaml --out-dir runs/demo-01
./.venv/bin/smk --project-dir ./demo export-load --run runs/demo-01 --format csv --out artifacts/load-demo-01.csv
./.venv/bin/smk --project-dir ./demo reconcile --run runs/demo-01 --out reports/sign-off-demo-01.md
make check

Verification

• local:
  • make setup-dev
  • make check
• scripts:
  • bootstrap-dev.sh
  • check.sh
• CI:
  • ci.yml

Reference Docs

• current status:
  • Roadmap
  • Context Memory
  • Next Product Cut
• product contracts:
  • MVP Spec
  • CLI Contract
  • Implementation Plan
  • Test Plan
• internal workflow:
  • Development Workflow