261006_01_DOC: 공용 프런트엔드 참조 문서 및 에이전트 스킬 정비
This commit is contained in:
7
.agent/consumer-references/change-and-verification.md
Normal file
7
.agent/consumer-references/change-and-verification.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# KriFrontCommon Change and Verification
|
||||
|
||||
- Pin or constrain the package version according to the consumer repository's dependency policy and commit its lockfile changes.
|
||||
- Review release notes and the actual affected API before upgrading.
|
||||
- Run the consumer's focused type-check, test, and build commands after an upgrade.
|
||||
- Keep `.agent/project.md` near 2-3 KiB as a routing document. Move conditional schemas, endpoint inventories, examples, and issue history to routed `.agent/references/` documents instead of deleting them.
|
||||
- Do not modify KriFrontCommon or another consumer repository unless it is explicitly included in the approved task scope.
|
||||
9
.agent/consumer-references/package-and-runtime.md
Normal file
9
.agent/consumer-references/package-and-runtime.md
Normal file
@@ -0,0 +1,9 @@
|
||||
# KriFrontCommon Package and Runtime Contract
|
||||
|
||||
- Use the package root for runtime-neutral object, URL, date, string, and shared type utilities.
|
||||
- Use a focused subpath such as `@kri/common/http`, `@kri/common/browser`, `@kri/common/server`, `@kri/common/security`, `@kri/common/hooks`, `@kri/common/query`, `@kri/common/config`, `@kri/common/jotai`, or `@kri/common/noti-hub` for the corresponding capability.
|
||||
- Keep browser, server, and runtime-neutral imports on their intended side of the application boundary.
|
||||
- A consumer that uses React hooks, TanStack Query, or Jotai integrations must provide the compatible optional peer dependency required by its selected entry point.
|
||||
- Preserve the project's established HTTP client, authentication, error-policy, query-client, storage, and environment conventions when adopting a shared helper.
|
||||
- Validate external data at runtime; a shared TypeScript type alone does not validate an API response or persisted value.
|
||||
- Prefer named public exports and retain the consumer project's current module system and bundler conventions.
|
||||
7
.agent/consumer-references/react-compiler.md
Normal file
7
.agent/consumer-references/react-compiler.md
Normal file
@@ -0,0 +1,7 @@
|
||||
# React Compiler and Manual Memoization
|
||||
|
||||
- `createKriNextConfig` enables `reactCompiler: true` unless the project overrides it; confirm the effective configuration.
|
||||
- When enabled, rely on React Compiler instead of adding `useMemo`, `useCallback`, or `React.memo` as a routine performance precaution.
|
||||
- Use manual memoization only for required reference stability, an Effect or third-party contract, compiler-incompatible code, or a measured performance problem.
|
||||
- Preserve existing memoization unless approved and verified for removal.
|
||||
- Use `"use memo"` or `"use no memo"` only for a documented compiler boundary.
|
||||
Reference in New Issue
Block a user