55 lines (40 loc) · 1.93 KB

AGENTS.md - migration-kit

This workspace is for implementing the Migration Kit MVP.

Local instructions in this file take precedence for work inside /Users/Agent/ps-workspace/migration-kit.

Purpose

Use this workspace to:

build the CLI and library
keep implementation-facing docs in sync
manage fixtures, schemas, specs, and reports for the MVP

Session Startup

Before doing substantive work:

Read README.md
Read the key docs in /Users/Agent/ps-workspace/migration-kit/docs/
Prefer mvp-spec.md, cli-contract.md, and implementation-plan.md as the primary contracts

Working Rules

Treat this as an implementation repo, not an ideation workspace
Keep the MVP narrow:
- xlsx/csv -> PostgreSQL
- AI only for draft spec assistance
- deterministic validation/dry-run/load artifact/reconcile
Fail closed on unknown fields, unsupported transforms, and unapproved specs
Update local docs when implementation changes the contract

Directory Intent

docs/: project contracts and delivery documents
src/: implementation code
tests/: automated tests
fixtures/: sample source files and expected outputs
schemas/: target schema examples
specs/: mapping spec examples
artifacts/: generated load artifacts
reports/: generated validation/sign-off outputs

Editing Rules

Prefer contract-first changes
Do not widen scope into a generic ETL platform
Preserve reproducibility and auditability over convenience
Keep Korean by default in docs unless the file is already English-first

Good Outcomes

A good result in this workspace usually leaves:

working CLI progress
updated contracts when behavior changes
reproducible fixtures or tests