engineering-foundation

# Agent Teams 엔지니어링 파운데이션 이 저장소는 Agent Teams 저장소를 위한 버전 관리형 엔지니어링 정책, 도구 및 적합성을 제공합니다. 재사용 가능한 개발 도구만 포함하며, 제품 런타임 코드는 이를 가져올 수 없습니다. 각 소비자는 자체 도메인 모델, 패키지 카탈로그, 의존성 권한, 보안 분류 및 ADR에 대해 권위를 유지합니다. ## 범위 - 엄격한 데이터 전용 소비자 구성 및 버전 관리 스키마 - 실행 가능한 워크스페이스 선언 및 소스 의존성 정책 - 관리되는 인라인 억제 및 릴리스된 공개 API 호환성 - 정적 실행 사양 및 소비자 게이트 연결 - 저장소 워크플로우, SBOM, 출처 및 패키지 콘텐츠 보안 정책 - 휴대용 에이전트 지침 및 변경 파일 사전 점검 라우팅 - 기존 패키지 스크립트 품질 게이트의 옵트인 결정적 구성 - 공유 Oxlint 및 TypeScript 7 기준 프리셋 - 명시적 레지스트리 및 로컬 링크 모드 - 결정적 연결, 상태, 분리 및 레지스트리 검증 - 폐쇄적 결정적 `의도 -> 계획 -> 적용 -> 영수증` 스캐폴딩 - 관리되는 문서 카탈로그, 결정적 비예약 계획, 생성 전용 게시 및 정확한 버전 복구 명령 - 격리된 패키지 콘텐츠 및 소비자 검증 - 불변 공개 npm 버전을 위한 릴리스 자동화 기능은 검증된 저장소에서 점진적으로 추출됩니다. 기능은 동등성 픽스처와 소비자 적합성 테스트가 있을 때만 여기로 이동합니다. `workspace.dependency-declarations` 및 `architecture.source-dependencies`는 활성 상태이며 도그푸딩됩니다. 저장소는 명시적 `packages` 패키지 루트와 함께 스키마 v2를 사용하며, 게시된 v1 계약은 기존 소비자를 위해 로드 가능한 상태로 유지됩니다. ## 명령 ```bash pnpm install pnpm check:changed pnpm check:fast pnpm check pnpm verify pnpm package:check pnpm quality:gate:fast pnpm foundation:qualification ``` 소비자는 다음을 사용합니다: ```bash pnpm foundation:check pnpm foundation:attach -- /absolute/path/to/engineering-foundation pnpm foundation:status pnpm foundation:detach pnpm foundation:assert-dev-only pnpm foundation:assert-registry ``` 모든 저장소는 변경 없이 휴대용 문서 설정을 미리 볼 수 있습니다: ```bash docs-protocol init --project-id example/widgets \ --owner documentation/team --dry-run --json ``` 검토된 다이제스트를 적용한 후 `docs.config.yaml`이 자동으로 발견됩니다. 검색 및 경계 컨텍스트는 일회용 프로젝션으로 유지됩니다: ```bash docs-protocol find "tenant isolation" --fuzzy docs-protocol context "tenant isolation" --fuzzy --max-documents 12 docs-protocol check ``` 관리되는 문서 작성은 설치된 Docs Protocol CLI를 사용합니다. `owner` 및 `summary`는 명시적 의도 권한이며 Foundation 기본값을 받지 않습니다: ```bash agent-teams-docs find "tenant isolation" agent-teams-docs new --type adr --id ADR-0083 \ --title "Tenant isolation" --owner architecture/tooling \ --summary "Defines the tenant-isolation boundary and its verification evidence." \ --dry-run agent-teams-docs doctor agent-teams-docs recover agent-teams-docs-managed upgrade --to docs-YYYY-MM-DD-N --target-generation 2 --json ``` 드라이 런을 검토한 후 `agent-teams-docs new`를 `--apply`로 반복하고, 정확한 도달 가능성 지침을 따르며, 소비자의 표준 저장소 검사를 실행합니다. `foundation:check`는 하나의 결정적 종합 보고서를 생성하고 모든 선언된 기능을 적용합니다. 선택적 `repository.agent-workflow` 기능은 코딩 에이전트 전반에 걸쳐 `AGENTS.md`를 표준으로 유지하고 `check:changed`를 공유 Foundation 구현을 통해 라우팅합니다. 필수 CI는 여전히 독립적인 실패 폐쇄 레인으로 완전한 `verify` 증거를 실행합니다. `foundation:assert-dev-only`는 런타임 의존성 배치를 거부합니다. `foundation:assert-registry`는 추가로 선언된 정확한 버전이 일치하는 pnpm 잠금 파일 임포터, npm 패키지 항목, sha512 무결성 및 링크, 소스 URL, 오버라이드 또는 패치 없이 스냅샷을 가지고 있음을 증명합니다. 스캐폴딩 커널은 엄격한 스키마와 저널링된 파일시스템 어댑터를 노출합니다. 테스트 전용 적합성 픽스처와 하나의 일반 개인 Node TypeScript 라이브러리 경계 레시피를 포함합니다. 후자는 패키지 봉투만 생성합니다. 소비자 비즈니스 패키지, 역할, 소유자 문서 및 기능 슬라이스는 소비자 소유로 유지됩니다. [소유권](docs/architecture/ownership.md), [일관성 증거 게이트](docs/architecture/consistency-evidence-gate.md), [거버넌스 기능 수용 검토](docs/research/governance-capability-acceptance-review.md), [로컬 개발](docs/development/local-mode.md) 및 [릴리스 절차](docs/release.md)를 참조하세요. 전체 문서 색인은 [docs/README.md](docs/README.md)입니다.