NEXA Implement — Command Workflow (engineer)

Migration = có code legacy. Engineer trỏ NEXA vào source cũ → scan → reverse-engineer tài liệu → gate → build. Lệnh chạy tuần tự dưới đây.

01INIT — tạo workspacePASS

nexa init --type migration --name my-proj --customer ACME --language ja --structure v3

Input

tên dự án, khách hàng, ngôn ngữ, loại=migration

Output

363 file scaffold v3 (00-intake..06-delivery)

02INTAKE — đăng ký domain + workflowPASS

nexa intake --mode migration --domain "CDP:Customer Data Platform:people,staff,billing"

Input

domain + module list

Output

workflow INTAKE-RD-BD-DD-MIGRATION-TEST-DELIVERY; domain CDP registered

03SCAN — build KB từ source legacyPASS

nexa scan --root run --no-doc-pipeline # trỏ vào legacy source

Input

source VB.NET/Oracle (1598 .SQL + 107 .vb)

Output

KB .fare/: 1366 bảng, 545 symbol, db-map, module-map (4 module), dependency-map

04RD — reverse-engineer tài liệu1/3 (infra)

nexa rd --domain CDP --provider stub # stub = chạy offline, không cần LLM live

Input

KB + domain

Output

RD docs: EXTERNAL_IF_LIST + SYSTEM_OVERVIEW + SYSTEM_ARCHITECTURE (JP), trace legacy screen-id

05COVERAGE — đo độ phủ legacy↔docWARN

nexa coverage --gate warn

Input

KB symbols + docs

Output

Code 100% (545/545); Docs 49.6% → WARN (<60)

06GATE — kiểm tra chất lượngG5/G6 PASS

nexa audit --phase rd && nexa gate run G1,G5,G6 && nexa validate

Input

RD docs + artifact-matrix

Output

G5 cross-ref PASS · G6 provenance PASS · validate 0 gaps (G1 chờ đủ RD)

07BD / DD — thiết kế (dry-run trước)planned

nexa bd --dry-run # 7 stage nexa dd --dry-run

Input

RD approved + KB

Output

BD: SCREEN_LIST/API_LIST/TABLE_LIST/DB_SCHEMA/SCREEN_FLOW/JOB_LIST/C4 → DD per-screen

Greenfield = không legacy, không scan. Engineer chạy chuỗi BA-writer thẳng từ brief khách hàng → code. Mỗi stage = 1 skill, gate bằng validator.

01RD — phân tích yêu cầuPASS

/rd-analysis # hoặc skill nexa-rd-writer, từ brief

Input

brief KH (project-profile + _PRODUCT.md)

Output

RD: 9 func-req + 7 data + 6 NFR (ID+actor+priority+AC-hint)

02US — user storiesPASS

/nexa-us-writer → output/02-us/us.md && node validators/validate-us.cjs

Input

Output

6 story INVEST + 18 AC Given-When-Then

03UC — use cases + gate18/20

/nexa-uc-writer && node validators/validate-uc.cjs --dir output/03-uc

Input

Output

2 UC 13-field Cockburn · validate-uc 2/2 PASS @18/20

04SD — thiết kế màn hìnhPASS

/nexa-sd-writer --project-output → output/04-sd/

Input

UC + mockup/brief

Output

4 màn Format-A 6-col song ngữ (MH-01..04)

05AD — activity diagramXML✓

/nexa-ad-builder --project-output → .drawio

Input

UC flow

Output

activity .drawio, 41 cell, 0 dangling edge

06MD — sequence diagramrender✓

/nexa-md-builder && npx -y @mermaid-js/mermaid-cli -i seq.mermaid -o seq.png

Input

UC happy-path

Output

sequence .mermaid → render PNG 48KB (14 bước, 4 phase)

07PIPELINE GATE — chain + verify6/6 PASS

node run-pipeline.cjs output --json # chạy đủ 6 validator

Input

output/ 6 stage

Output

run-pipeline 6/6 PASS · consistency + cross-ref + layout-lint

08CODE — build app19 màn

/vibecode # RD→BD→DD→work-packet→code (cần LLM provider)

Input

BA docs (RD..MD)

Output

Vite+React+TS+Tailwind app, 19 màn, MSW mock backend