사람함께에이전트▾
사람 — 직접 정하고 책임지는 비즈니스 규칙과 흐름. 직접 읽어보세요.
함께 — 개념은 알아두고, 세부 규칙은 에이전트가 따릅니다.
에이전트 — 에이전트가 따르는 규칙과 레퍼런스. 필요할 때 찾아보세요.
akan quality는 코드베이스의 모양이 흐트러지고 있다는 것을 알려 줍니다. 문법 오류가 아니라서, 누군가 측정하기 전에는 드러나지 않는 문제들입니다.akan.file.recommended-max-linesorder.service.ts에서 OrderService 옆에 선언한 헬퍼 함수입니다.akan.convention.serviceakan.ssr.module-missing-server-viewakan.ssr.client-static-markup.tsx 파일을 고칠 때마다 실행하세요. 렌더 비율은 UI 변경이 소리 없이 깎아 먹을 수 있는 유일한 숫자입니다.akan.<scope>.<name> 이름을 가진 검사 하나이며, 경고마다 그 경고를 낸 규칙이 적힙니다.ui/와 lib/의 JSX 엘리먼트 가운데 서버에서 렌더링되는 비율입니다.scan(기본값)은 모든 경고를 출력한 뒤 SSR 비율과 권장 규칙을 이어서 보여 줍니다.ssr은 SSR 비율을 먼저 출력하고, 경고는 scope가 ssr인 것만 남깁니다.scan은 전부를, ssr은 렌더 비율만 다룹니다.-f이며, json은 도구가 읽도록 각 경고의 fix까지 담은 전체 결과를 출력합니다.akan quality 한 번으로 경고와 비율을 모두 확인합니다. 줄여 보면 이런 모양입니다:<file>:<line>:1 - warning <rule>: <message>. global 경고는 파일이 하나로 정해지지 않아 그 자리에 <global>이 찍힙니다.note: related location은 함께 걸린 위치를 하나씩, fix:는 고치는 법을 알려 줍니다.akan quality ssr을 씁니다. 비율을 먼저 출력하고 ssr 경고만 남깁니다.st.do.set…On…을 불러서, 그 필드가 에이전트 도구로 공개되지 않습니다.*.abstract.md가 300줄을 넘었으니, 코드로 드러나지 않는 내용만 남깁니다.<Class>Options 인터페이스 말고 다른 것을 선언했습니다."use client"로 시작하는 파일의 엘리먼트는 모두 클라이언트로, 나머지는 서버로 셉니다.workspace 합계 행이 붙습니다.<- below the 50% target이 붙습니다.akan quality ssr은 비율을 먼저 보여 주고, 그 뒤에 ssr 경고만 출력합니다:package.json, tsconfig.json, .env가 있는 워크스페이스 루트에서 실행합니다.apps/와 libs/ 아래의 .ts, .tsx(.d.ts 제외)와 모든 *.abstract.md를 읽습니다..gitignore에 걸리는 경로와 node_modules, .git은 읽지 않습니다..service.ts 안의 헬퍼처럼, 모듈 파일이 자기 역할에 맞지 않는 것을 선언한 경우입니다.//! 마커를 봅니다.akan quality ssr은 이 scope만 남깁니다.akan quality ssr --format json도 모양은 같고, warnings만 scope가 ssr인 것으로 줄어듭니다.rule, scope, severity, message, fix가 있고, 해당하면 file, line, locations도 붙습니다.scope, serverMass, clientMass, serverShare(0~1)가 들어 있습니다.<X>Props 말고 로컬 타입·함수를 둡니다.//!·/*! 마커는 압축 후에도 남으므로 // FIXME:로 씁니다.index.ts가 aa, dumb, someCommonLogic 같은 스캐폴드 자리표시자를 export합니다.Order description 같은 스캐폴드 문구가 남아 있습니다.declare global, Window 인터페이스, .prototype. 수정은 저수준 통합 파일 하나에 모아 둡니다.lib/ 바로 아래에 cnst.ts, option.ts 같은 지원 파일이 아닌 파일이 있습니다..tsx 이름이 허용된 역할이 아닙니다. OrderCard.tsx 같은 경우입니다.akan.convention.<role>은 이 목록 밖의 최상위 선언마다 뜹니다. 모델 이름이 Order일 때의 예입니다:OrderInput, OrderObject, LightOrder, Order, OrderInsight, enumOf 클래스export const dictionaryOrderFilter, Order, OrderModelOrderServiceOrderInternal, OrderSlice, OrderEndpointOrderStoreui/, page/의 파일과 모듈 파일은 이름이 겹쳐도 됩니다. 다만 .constant.ts의 enumOf 클래스는 이름이 겹치면 안 됩니다.
ui/와 lib/만 잽니다. 비율과 규칙 여섯 개는 apps|libs/*/ui/와 apps|libs/*/lib/ 아래의 .tsx만 읽고 테스트는 뺍니다. page/, webkit/, srvkit/, common/은 대상이 아니므로 라우트 파일은 이 숫자를 움직이지 못하고, 거기에 붙인 "use client"도 마찬가지입니다."use client"가 있지만 hook, 이벤트 핸들러, store, 브라우저 API를 하나도 쓰지 않으니 이 줄을 지웁니다.useEffect(…, [])가 fetch.*나 데이터를 불러오는 st.do.* 액션을 부르는데, 라우트가 먼저 불러올 수 있습니다.Unit이나 View가 없습니다..Template.tsx가 useState를 부르지만, Template의 폼 상태는 store에 둡니다.st, fetch를 import하는 파일은 "use client"를 지우라고 하지 않고, 패키지 컴포넌트를 그리는 컴포넌트도 건너뜁니다.Zone, Template, Util과 index_.tsx의 lazy() 경계는 불필요한 "use client"로 잡지 않습니다.onClick 안의 fetch나 의존성 배열이 있는 effect는 마운트 시점 로드가 아닙니다.lib/ 아래 _로 시작하는 폴더에는 Unit이나 View를 요구하지 않습니다.