콘텐츠로 이동

릴리스 게이트 상세 (v4.56.0)

README.ko.md의 상태·기여하기 요약을 뒷받침하는 전체 증빙 문구 모음이에요. 영어판 전체 증빙은 RELEASE-GATES.md를 참고하세요. 릴리스 정책 가드(npm run release:metadata)는 README.ko.md와 이 문서를 함께 검사해요.

상태 상세

핵심 디자인 컨설팅 워크플로우는 로컬 릴리스 기준으로 준비되어 있어요. 웹사이트 개선 컨트롤 타워는 docs/website-console/index.html zero-dependency static Web App과 website-improvement route/skill/command로 제공되며, Site Profile, audit checklist, MCP readiness, refactor prompt, browser-local handoff evidence tracking, verified bundle evidence metadata, generated bundle contract verification, repair report --out file output-file persistence가 붙은 bundle repair preview/apply와 packed-tarball evidence preservation smoke coverage가 붙은 CLI/bundle evidence export, handoff report를 관리해요. 로컬 학습 선호도는 design-ai learn, preview-first starter profile bootstrap인 learn --init, 명시적 learn --feedback keep/improve/avoid guidance, local QA warn/fail 결과를 저장하는 명시적 check --learn --yes capture, learning.json과 skill 파일을 수정하지 않는 focused learn --agent-backlog --report --out agent-backlog.md agent backlog artifact와 반복 check-capture 신호를 후보 skill instruction delta로 바꾸고 --report --out skill-proposals.md Markdown review artifact, read-only --review-file decision join, --patch --out skill-proposals.patch unified diff handoff를 저장할 수 있는 preview-only learn --propose-skills, git / canonical repository remote와 metadata alignment / learning / 선택형 또는 sibling --learning-usage sidecar summary와 stale selected id 및 profile mismatch readiness warning / 선택형 --learning-eval checkpoint summary와 freshness metadata / sibling learning-eval.json checkpoint 자동 인식 / active learning profile이 checkpoint 생성 뒤 바뀌었거나 checkpoint metadata와 맞지 않을 때 freshness warning / learning usage/eval path가 들어가는 next-action command의 shell-safe quoting / learning profile audit 또는 usage sidecar drift가 있을 때 usage-aware learn --curate --usage-file로 이어지는 next-action / archive cleanup 전에 learn --curate --report --out learning-curation-report.md를 저장하도록 안내하는 workspace report next-action / 학습 profile에 entry가 있지만 checkpoint가 없을 때 learn --eval-template bootstrap next-action hint / release-script 상태를 한 번에 보고 --strict readiness gate로 실패 처리할 수 있는 read-only design-ai workspace dogfood readiness snapshot, Website Console JSON export에서 sample workspace 생성, design-ai site --init Website Console project init workspace coverage in installed-bin and one-shot paths, design-ai site --init --bundle --out <dir> Website Console init handoff bundle도 설치된 binary와 one-shot 경로에서 확인, prompt template listing, --mcp-check 기반 deterministic MCP readiness check와 --mcp-check --probes 기반 read-only MCP probe check, --mcp-plan 및 --mcp-plan --probes 기반 Markdown or JSON MCP action plan export, --graph --json 기반 portable workflow graph export, --bundle --out 기반 전체 handoff bundle export, --bundle-check --strict --json 기반 handoff bundle checksum 검증, bundle digest 검증, generated bundle contract 검증, --bundle-compare --strict --json 기반 handoff bundle 비교, --bundle-handoff --strict --json 기반 검증된 bundle digest에서 대상 repo handoff prompt 생성, --bundle-repair --yes --json 기반 local handoff bundle repair, refactor task generation, task 선택이 가능한 단일 prompt template export, Markdown report/prompt bundle 변환을 처리하는 design-ai site, 안전한 --out file output과 --force overwrite control을 지원하는 전체 portable learn --backup --json profile export, local profile 또는 portable JSON을 --from-file / --stdin으로 받아 공유 전 민감정보를 가리는 redacted learn --redact --json profile export, 비파괴 learn --verify import validation, 읽기 전용 learn --diff portable JSON profile comparison, portable backup에서 active profile을 교체하고 자동 rollback backup과 선택형 --backup-file path를 제공하는 preview-first learn --restore, sibling rollback backup inventory를 보여주는 읽기 전용 learn --restore-backups, 오래된 rollback backup을 preview-first로 정리하는 learn --restore-backups --prune --keep N, portable learn --import dry-run/confirmed profile merge, recency fallback 없이 matching preference와 selection reason을 확인하는 query-filtered learn --list --explain / learn --export, cleanup suggestion을 포함하는 읽기 전용 learn --audit / learn --stats, 로컬 prompt/pack usage sidecar 활동을 요약하는 읽기 전용 learn --usage, active profile에서 runnable checkpoint JSON을 만드는 learn --eval-template, deterministic local learning selection QA와 --strict failure gate 및 sanitized checkpoint metadata를 위한 읽기 전용 learn --eval checkpoint report, 안전한 learn --audit --fix --dry-run preview와 확인형 --fix --yes cleanup, duplicate/sensitive entry를 sibling archive JSON으로 보존하고 learn --curate --report --out Markdown audit trail과 profile mismatch, stale selected id, unused active entry advisory usage review를 제공하는 archive-first learn --curate preview/apply flow, brief-relevance ranking, category/limit 범위 지정, selection scoring metadata, audit summary가 붙고 raw brief 대신 selected entry id와 짧은 brief hash만 learning.usage.json sidecar에 남기는 선택형 prompt/pack --with-learning으로 사용할 수 있고, AI 모델 학습이나 fine-tuning은 여전히 현재 배포 범위 밖이에요.

learn --signals는 local learning audit, usage sidecar, route/prompt/pack/learning eval signal, check learning capture, deterministic agent development backlog, workspace readiness를 하나로 묶어 보여주는 읽기 전용 registry예요. learn --agent-backlog --report --out agent-backlog.md는 같은 deterministic backlog만 분리해서 JSON/Markdown artifact와 strict gate로 확인하는 focused read-only surface예요. learn --signals --report --out learning-signals.md는 같은 registry를 공유 가능한 Markdown handoff artifact로 저장하고, learn --signals --strict는 signal registry나 agent backlog가 warn/fail이면 non-zero로 종료하므로 내부 에이전트와 AI 디밸롭 상태를 로컬 gate로 확인할 수 있고, learning.json 수정이나 외부 AI API 호출은 하지 않아요.

learn --propose-skills는 반복된 check --learn --yes 신호를 후보 skill, evidence sources, proposed instruction delta, verification command, risk level로 정리하는 preview-only 리포트예요. --min-evidence N으로 proposal 기준을 높이거나 낮출 수 있고, --report --out skill-proposals.md를 쓰면 실제 skill 편집 전에 reviewer-friendly Markdown artifact로 저장할 수 있어요. --review-file skill-proposals.review.json은 applied/rejected proposal decision을 읽기 전용으로 합쳐 strict proposal gate를 정리하고, --review-file skill-proposals.review.json --review-check은 현재 proposal이 review file로 닫히는지 read-only readiness check로 검증하며, --review-file skill-proposals.review.json --apply-plan은 accepted proposal을 수동 skill 편집 계획으로 바꾸지만 파일은 수정하지 않아요. --review-template --out skill-proposals.review.json은 현재 pending proposal id를 JSON review scaffold로 저장하며, --patch --out skill-proposals.patch는 unresolved proposal을 unified diff preview로 저장하지만 skill 파일은 수정하지 않아요. --strict를 붙이면 pending proposal 또는 upstream signal readiness 경고가 있을 때 non-zero로 종료하지만, 실제 skill 수정은 이 명령에서 수행하지 않아요.

기여하기 게이트 상세

  • 릴리스 PR 또는 태그 전에는 npm run release:check를 core gate로 실행해요. npm test CLI unit test, npm run audit:strict 8개 audit, git diff --check whitespace check, npm run package:check package contents check, npm run release:metadata release metadata check 및 release metadata JSON product_readiness_checked: true Product Readiness guard coverage, npm run release:self-test release self-test 검증, installed-bin과 one-shot npm exec --package <tarball> 경로를 포함한 npm run package:smoke packed-tarball smoke, design-ai workspace --strict --json workspace strict 실패/성공 readiness checks와 workspace --learning-usage sidecar summary와 workspace --learning-eval checkpoint summary와 freshness metadata와 design-ai workspace workspace learning restore-backups readiness 및 restore rollback backup inventory, design-ai site --stdin --json Website Console export validation, design-ai site --stdin --next-actions --json --out file --force Website Console next-action operator checklist --out file 저장 확인, design-ai site --stdin --next-actions --out file --force Website Console next-action human checklist --out file 저장 확인, design-ai site --sample Website Console sample workspace coverage, design-ai site --intake-template Website Console intake template coverage for JSON stdout, Markdown stdout, Markdown --out, JSON --out, and --language ko Korean JSON/Markdown plus Korean Markdown --out in installed-bin and one-shot paths, design-ai site --from-intake Website Console from-intake filled Markdown intake import coverage for workspace JSON stdout, stdin workspace JSON stdout, stdin next-actions JSON stdout, stdin next-actions JSON --out file output-file persistence, stdin next-actions human --out file output-file persistence, stdin workspace JSON --out file output-file persistence, workspace JSON --out file output-file persistence, from-intake task generation, stdin from-intake task JSON --out output-file persistence, from-intake task handoff bundle generation, stdin from-intake task handoff bundle generation, stdin handoff bundle generation, and from-intake handoff bundle generation in installed-bin과 one-shot paths, design-ai site --init Website Console project init workspace coverage in installed-bin and one-shot paths, design-ai site --init --bundle --out <dir> Website Console init handoff bundle도 설치된 binary와 one-shot 경로에서 확인, design-ai site --prompt-list --json Website Console prompt template listing, design-ai site --stdin --mcp-check --json Website Console MCP readiness 검증, design-ai site --stdin --mcp-check --probes --json Website Console MCP readiness probe JSON with --out file-write confirmation, shared MCP probe output-file smoke assertions, MCP check 내장 probe next-step commands, MCP check 내장 command 실행 smoke coverage 검증, design-ai site --stdin --mcp-plan Website Console MCP action plan 생성, design-ai site --stdin --mcp-plan --probes Website Console MCP probe action plan 생성, design-ai site --stdin --mcp-plan --probes --json Website Console MCP probe action plan JSON with --out file-write confirmation plus embedded MCP action plan probe output-file commands plus MCP action plan human report output command parity plus MCP action plan emitted human report command smoke coverage plus MCP action plan emitted check JSON command smoke coverage plus MCP action plan emitted self-archive command smoke coverage plus shared MCP action plan command mapping self-test coverage 생성, design-ai site --stdin --graph --json Website Console workflow graph 생성, design-ai site --stdin --bundle --out <dir> Website Console handoff bundle 생성, design-ai site <bundle-dir> --bundle-check --strict --json Website Console handoff bundle checksum 검증, bundle digest 검증, generated bundle contract 검증, design-ai site <bundle-dir> --bundle-compare <other-bundle-dir> --strict --json Website Console handoff bundle 비교와 bundle digest 비교 및 packed-tarball과 public-registry smoke에서 warning-state Website Console bundle-compare strict 경고 실패가 동일 warning bundle의 sameBundle true 유지와 strict에서 non-zero 종료를 보존하는지도 확인, design-ai site <bundle-dir> --bundle-handoff --strict --json Website Console 대상 repo handoff prompt와 검증된 handoff bundle digest, design-ai site <bundle-dir> --bundle-repair --yes --json Website Console bundle repair preview/apply drift recovery와 repair report --out file output-file persistence, 공용 repair guidance smoke helper, 공용 repair report assertion helper, design-ai site --stdin --tasks Website Console refactor task generation, design-ai site --stdin --prompt codex-implementation --task task-homepage-cta Website Console task-selected single prompt generation, human design-ai version과 JSON design-ai version --json machine-readable version metadata, design-ai help top-level help, design-ai help --json topic catalog with probe-capable Website Console site help usage, command alias help와 functional alias 출력, command-specific help topic 출력 및 shared Website Console site help topic example smoke assertions 및 design-ai site website-workspace.json --next-actions --out website-next-actions.md next-actions Markdown 도움말 예시 plus from-intake stdin help examples (cat company-website-intake.ko.md | design-ai site --from-intake --stdin --out website-workspace.json --force, cat company-website-intake.ko.md | design-ai site --from-intake --stdin --next-actions --out website-next-actions.md --force, cat company-website-intake.ko.md | design-ai site --from-intake --stdin --tasks --out website-workspace.tasks.json --force, cat company-website-intake.ko.md | design-ai site --from-intake --stdin --bundle --tasks --out website-handoff-bundle) 검증, 세 가지 list catalog domain의 human/JSON 출력, human / JSON corpus discovery 출력, route JSON 출력, route catalog 출력, route stdin 입력, 명시적 show --lines 출력과 route --explain 출력 검증, unknown command failure, unknown help-topic failure, unknown list-domain failure, unknown search-dir failure, unknown route-id suggestion, unknown option suggestion, unknown value suggestion, numeric range failure 검증, prompt JSON 출력, prompt markdown 출력, prompt from-file 출력, prompt stdin 출력, pack JSON 출력, pack markdown 출력, pack from-file 출력, pack stdin 출력, prompt/pack 강제 --out overwrite 및 prompt/pack file-write confirmation, check examples 출력, check artifact 출력, check stdin 출력, check all-routes 출력, check learning capture output, human design-ai audit --strict --quiet 출력과 JSON design-ai audit --strict --quiet --json machine-readable repository-audit output, JSON design-ai learn --feedback output plus learn feedback --out file-write confirmation, JSON design-ai learn --init output, JSON design-ai learn --backup output, JSON design-ai learn --redact output, design-ai learn --redact --from-file output, design-ai learn --redact --stdin output, learn JSON --out file-write confirmation과 forced overwrite coverage, JSON design-ai learn --verify output과 learn verify --out file-write confirmation, JSON design-ai learn --restore preview/apply output과 learn restore --out file-write confirmation, learn restore rollback backup verification, learn restore --backup-file path coverage, design-ai learn --restore-backups restore rollback backup inventory coverage, design-ai learn --restore-backups --prune restore rollback backup pruning coverage, JSON design-ai learn --import dry-run/apply output과 learn import --out file-write confirmation, human / JSON design-ai learn --stats profile summary output과 learn stats --out file-write confirmation, query-filtered human learn list explanation and export JSON output, brief-relevant prompt/pack learning selection, prompt/pack learning usage sidecar recording, human / JSON design-ai learn --usage usage sidecar report plus learn usage --out file-write confirmation, human / JSON design-ai learn --signals learning signal registry plus design-ai learn --signals --strict --json strict gate plus learn signals --out file-write confirmation, human / JSON design-ai learn --eval-template checkpoint generation plus generated checkpoint strict validation, human / JSON design-ai learn --eval checkpoint report plus learn eval --out file-write confirmation plus learn eval --strict failure gate, human / JSON design-ai learn --audit cleanup suggestion output과 learn audit --out file-write confirmation, human design-ai update --dry-run output, design-ai update --dry-run --json machine-readable update plan, design-ai doctor --strict human diagnostics 출력, design-ai doctor --json machine-readable diagnostics 출력, human design-ai install 출력과 design-ai install --json machine-readable install lifecycle output, human design-ai status 출력과 JSON status, design-ai status --json machine-readable install-state output, human design-ai uninstall 출력과 design-ai uninstall --json machine-readable uninstall lifecycle output 검증을 한 번에 확인해요.
  • 같은 npm run release:check gate는 Website Console bundle mcp-probes.json saved-payload guard 단계를 package contents, release self-tests, packed-tarball smoke로 함께 보존해요.
  • 같은 npm run release:check gate는 Website Console bundle boundary metadata guard 단계도 bundle-check JSON/human and bundle-handoff JSON/prompt boundary metadata plus full release:self-test evidence recording through unit tests, strict audits, whitespace checks, package contents, release metadata, release self-tests, and packed-tarball smoke와 함께 보존해요.
  • 같은 npm run release:check gate는 Product Readiness release policy full gate guard for Website Console bundle boundary metadata full release:check evidence도 unit tests, strict audits, whitespace checks, package contents, release metadata, release self-tests, packed-tarball smoke와 함께 보존해요.
  • 같은 npm run release:check gate는 Product Readiness release policy full gate evidence guard도 unit tests, strict audits, whitespace checks, package contents, release metadata, release self-tests, packed-tarball smoke와 함께 보존해요.
  • Packed-tarball smoke는 installed-bin과 one-shot npm exec --package <tarball> 경로에서 route eval, prompt eval, pack eval checkpoint output도 확인해요.
  • Packed-tarball smoke는 installed-bin과 one-shot npm exec --package <tarball> 경로에서 design-ai learn --signals --report --out learning-signals.md Markdown signal report, learn signals JSON --out file-write confirmation, design-ai learn --agent-backlog --report --out agent-backlog.md focused agent backlog Markdown report와 agent backlog JSON --out file-write confirmation, design-ai learn --agent-backlog --strict --json agent backlog strict gate, focused agent backlog readiness summaries, optionalGapDetails JSON field coverage, check index JSON field coverage, Markdown check index section coverage, check-capture optional-gap semantics도 확인해요. 이 smoke coverage는 optional refresh-only runbook selection reason도 보존해서 no-command agent backlog output이 refresh를 executable handoff command가 아닌 status metadata로 다루는지 확인해요.
  • Packed-tarball smoke는 installed-bin과 one-shot npm exec --package <tarball> 경로에서 design-ai learn --propose-skills --min-evidence 3 --json threshold skipping, learn skill proposals JSON --out file-write confirmation, design-ai learn --propose-skills --report --out skill-proposals.md Markdown review artifact, design-ai learn --propose-skills --review-file skill-proposals.review.json --json read-only review decision join, design-ai learn --propose-skills --review-file skill-proposals.review.json --review-check --json read-only review-file readiness check, design-ai learn --propose-skills --review-file skill-proposals.review.json --review-check --report --out skill-proposal-review-check.md read-only review-check Markdown report, design-ai learn --propose-skills --review-file skill-proposals.review.json --apply-plan --json read-only accepted proposal apply plan, design-ai learn --propose-skills --review-file skill-proposals.review.json --apply-plan human apply-plan command contract summary와 Command contract section, design-ai learn --propose-skills --review-file skill-proposals.review.json --apply-plan --report --out skill-proposal-apply-plan.md read-only apply-plan Markdown report, design-ai learn --propose-skills --review-template --out skill-proposals.review.json JSON review template, design-ai learn --propose-skills --patch --out skill-proposals.patch unified diff handoff, design-ai learn --propose-skills --strict --json expected-failure skill proposal readiness gate도 확인해요.
  • npm publish가 끝난 뒤에는 npm run registry:smoke로 공개 npm exec --package 설치 경로, human design-ai version과 JSON design-ai version --json machine-readable version metadata, design-ai help top-level help, design-ai help --json topic catalog with probe-capable Website Console site help usage, functional alias 출력, 세 가지 list catalog domain의 human/JSON 출력, human / JSON corpus discovery 출력, route JSON 출력, route catalog 출력, route stdin 입력, 명시적 show --lines 출력과 route --explain 출력 검증, unknown command failure, unknown help-topic failure, unknown list-domain failure, unknown search-dir failure, unknown route-id suggestion, unknown option suggestion, unknown value suggestion, numeric range failure 검증, prompt JSON 출력, prompt markdown 출력, prompt from-file 출력, prompt stdin 출력, pack JSON 출력, pack markdown 출력, pack from-file 출력, pack stdin 출력, prompt/pack 강제 --out overwrite 및 prompt/pack file-write confirmation, check examples 출력, check artifact 출력, check stdin 출력, check all-routes 출력, check learning capture output, human design-ai audit --strict --quiet 출력과 JSON design-ai audit --strict --quiet --json machine-readable repository-audit output, public registry JSON design-ai learn --verify output과 public registry learn verify --out file-write confirmation, public registry JSON design-ai learn --backup output과 public registry learn backup --out file-write confirmation, public registry human / JSON design-ai learn --stats profile summary output과 public registry learn stats --out file-write confirmation, human design-ai update --dry-run output, design-ai update --dry-run --json machine-readable update plan, design-ai doctor --strict human diagnostics 출력, design-ai doctor --json machine-readable diagnostics 출력, human design-ai install 출력과 design-ai install --json machine-readable install lifecycle output, human design-ai status 출력과 JSON status, design-ai status --json machine-readable install-state output, human design-ai uninstall 출력과 design-ai uninstall --json machine-readable uninstall lifecycle output을 확인해요.
  • Registry smoke는 공개 npm registry design-ai workspace --strict --json strict 실패/성공 readiness checks도 published package path에서 확인해요.
  • Registry smoke는 공개 npm registry design-ai workspace --learning-eval learning-eval.json --strict --json checkpoint summary와 freshness metadata, auto-detected learning usage sidecar summary도 published package path에서 확인해요.
  • Registry smoke는 공개 npm registry design-ai workspace workspace restore-backups readiness와 restore rollback backup inventory도 published package path에서 확인해요.
  • Registry smoke는 공개 npm registry design-ai site Website Console export validation, 공개 npm registry design-ai site --stdin --next-actions --json next-action operator checklist 계약 및 mcpProbeCounts probe count telemetry와 shared smoke assertion self-test coverage for Website Console next-actions MCP probe counts 및 공개 npm registry design-ai site --stdin --next-actions --json --out file --force next-action operator checklist --out file 저장 확인 및 공개 npm registry design-ai site --stdin --next-actions --out file --force next-action human checklist --out file 저장 확인, sample workspace, prompt template 목록, MCP readiness, MCP readiness probe, MCP readiness probe JSON with --out file-write confirmation plus shared MCP probe output-file smoke assertions plus embedded MCP check probe next-step commands plus executable embedded MCP check probe command smoke coverage plus human MCP check probe command guidance and output-file smoke coverage plus embedded MCP check probe human report output command, MCP action plan, MCP probe action plan, MCP probe action plan JSON with --out file-write confirmation plus embedded MCP action plan probe output-file commands plus MCP action plan human report output command parity plus MCP action plan emitted human report command smoke coverage plus MCP action plan emitted check JSON command smoke coverage plus MCP action plan emitted self-archive command smoke coverage plus shared MCP action plan command mapping self-test coverage, handoff bundle, bundle-check JSON/human and bundle-handoff JSON/prompt boundary metadata for deterministic-local, no-external-call, and no-target-repo-mutation handoff validation, bundle-check/compare/handoff mcpProbeCounts probe count telemetry plus package smoke self-test coverage for Website Console bundle MCP probe counts plus bundled Website Console mcp-probes.json saved probe evidence payload assertion instead of the full site --mcp-check --probes --json response, bundle-repair, refactor task 생성, task-selected prompt 생성도 published package path에서 확인해요.
  • Registry smoke는 public registry JSON design-ai learn --feedback output plus public registry learn feedback --out file-write confirmation, public registry design-ai learn --feedback --from-file, public registry design-ai learn --feedback --stdin, public registry JSON design-ai learn --init preview/apply output, public registry learn init duplicate-skip output도 확인해요.
  • Registry smoke는 public registry JSON design-ai learn --restore preview/apply output, public registry learn restore --out file-write confirmation, public registry learn restore rollback backup verification, public registry learn restore --backup-file path coverage, public registry design-ai learn --restore-backups restore rollback backup inventory coverage, public registry design-ai learn --restore-backups --prune restore rollback backup pruning coverage도 확인해요.
  • Registry smoke는 public registry JSON design-ai learn --import dry-run/apply output과 public registry learn import --out file-write confirmation과 public registry JSON design-ai learn --redact output, public registry design-ai learn --redact --from-file, public registry design-ai learn --redact --stdin, public registry learn redact --out file-write confirmation도 확인해요.
  • Registry smoke는 public registry human / JSON design-ai learn --audit cleanup suggestion output과 public registry learn audit --out file-write confirmation과 public registry design-ai learn --audit --fix --dry-run cleanup preview 및 confirmed apply output도 확인해요.
  • Registry smoke는 public registry query-filtered learn list explanation/export JSON output, public registry brief-relevant prompt/pack learning selection, prompt/pack learning usage sidecar recording, public registry prompt/pack --with-learning, public registry design-ai learn --eval-template checkpoint generation, public registry generated checkpoint strict validation도 확인해요.
  • Registry smoke는 public registry learning readiness Markdown report coverage도 확인해서 design-ai learn --signals --report --out learning-signals.md와 design-ai learn --agent-backlog --report --out agent-backlog.md가 published package path에서 Readiness check index section을 보존하는지 검증해요.