evanca/flutter-ai-rules

Flutter AI Skills and Rules for Claude, Codex, Cursor, and Other AI-Powered IDEs

evanca/flutter-ai-rules는 36개의 작은 지침 파일("스킬") 모음으로, AI 코딩 도구(Claude Code, Codex, Cursor, Antigravity 등)가 일치하는 작업을 감지하면 자동으로 로드합니다. 콘텐츠는 공식 문서에서만 가져옵니다: Flutter, Dart, Firebase 및 각 패키지의 공식 문서. 개인 의견이나 임의 규칙은 포함되지 않습니다.

"스킬"이란 무엇인가

스킬은 SKILL.md 파일을 포함하는 폴더입니다. AI 에이전트는 짧은 설명을 읽고 작업이 일치한다고 판단한 다음 전체 지침을 자동으로 가져옵니다. 예: 인증 코드를 건드리면 Firebase Auth 지침이 로드되고, Riverpod 프로바이더를 건드리면 Riverpod 지침이 로드됩니다. 설정에 규칙을 붙여넣거나 @ 멘션을 입력할 필요가 없습니다.

빠른 시작

npx skills add evanca/flutter-ai-rules

이것으로 모든 것이 설치됩니다. **Node 22.20+**가 필요합니다(이전 버전은 즉시 실패). 모든 Node 버전(또는 Node 없음)에서 작동하는 대안:

하나의 스킬만 찾아보거나 설치: npx skills add evanca/flutter-ai-rules --list / --skill flutter-best-practices
플러그인으로 설치 (Claude Code, Codex, Cursor, Antigravity용) — 세트를 제자리에서 업데이트 (전체 명령은 README에 있음)
수동 복사: 스킬 폴더를 .claude/skills/, .cursor/skills/, .codex/skills/, .agents/skills/, 또는 .windsurf/skills/에 복사하거나 심볼릭 링크 — 또는 git clone 한 줄로 프로젝트에 전체 세트를 벤더링
스킬을 명시적으로 참조: "@.skills/bloc/SKILL.md를 읽고 테스트 커버리지를 만드세요."

Windsurf/Devin에는 플러그인 매니페스트가 없습니다(수동 복사가 경로입니다). GitHub Copilot은 SKILL.md를 전혀 읽지 않습니다 — 대신 레거시 규칙 파일을 사용하세요(아래 참조).

내용

36개의 스킬은 그룹화되어 있습니다:

카테고리	예	트리거 조건
Flutter/Dart 기초 (8)	모범 사례, 효과적인 Dart, Dart 3 업데이트, 앱 아키텍처, 오류 처리, Row/Column 레이아웃, 사전 캐싱	Flutter 코드 작성/검토, 프로젝트 스캐폴딩, 레이아웃 오류
상태 관리 (4)	Bloc, Riverpod, Provider, ChangeNotifier	프로바이더 설정, 상태 연결, 재빌드 최적화
테스트 및 검토 (5)	테스트, Mockito, Mocktail, Patrol E2E, 코드 검토	단위/위젯/골든 테스트, 모킹, PR 검토
Firebase (15)	Auth, Firestore, Storage, Analytics, Crashlytics, Messaging, Remote Config, Cloud Functions, App Check, Data Connect, AI 기능	모든 Firebase 작업 — 인증 상태, 스키마, 업로드, 이벤트, 기능 플래그 등
출시 및 제품 (4)	접근성, 포용적 디자인, RevenueCat 테스트, Dart Genkit 에이전트	a11y, i18n, 구매 테스트, Dart의 AI 에이전트

레거시 옵션: 규칙 및 결합 번들

스킬이 존재하기 전에 저장소는 두 가지 이전 형식을 제공했습니다. 둘 다 여전히 작동하고 유지 관리되지만, 스킬이 권장됩니다. 스킬은 관련이 있을 때만 로드되어 매 요청마다 컨텍스트를 소비하지 않기 때문입니다. 도구가 스킬을 지원하지 않거나 단일 정적 파일을 원하는 경우에만 레거시 경로를 사용하세요:

rules/ — 6개의 광범위한 기초 파일(효과적인 Dart, 앱 아키텍처, 오류, Dart 3 업데이트, 테스트, 코드 검토). 프롬프트에서 이름으로 참조합니다. 패키지별 지침(Bloc, Riverpod, Firebase, Mockito 등)은 이제 스킬 전용입니다.
combined/ — 7개의 주제 번들, 각각 전체 및 6,000자 미만 변형(Windsurf의 하드 제한에 맞추기 위해). 하나를 규칙 설정에 붙여넣습니다.
GitHub Copilot — 결합 번들을 .github/copilot-instructions.md에 복사하거나, 규칙 파일을 .github/instructions/에 Dart 전용 프론트매터로 복사하거나, 번들을 루트 AGENTS.md에 붙여넣습니다(Copilot, Codex, Antigravity에서 동시에 작동).

도구별 크기 지침

README에는 각 도구의 공식 문서화된 크기 권장 사항 표가 포함되어 있습니다(2026-07-11 액세스). 주요 내용:

Claude Code — CLAUDE.md 200줄 미만(소프트); SKILL.md 500줄 미만(소프트); 설명 1,536자(하드)
Cursor — 규칙 500줄 미만(소프트); SKILL.md 숫자 제한 없음
OpenAI Codex — 규칙 제한 없음; 스킬 번들은 50 MB zip / 25 MB 파일 / 500 파일로 제한
Antigravity — 규칙 파일당 12,000자(하드); SKILL.md 제한 명시 없음
Windsurf — 전역 규칙 6,000자; 파일당 12,000자(둘 다 하드); SKILL.md 제한 없음
GitHub Copilot — 지침 약 2페이지 미만(소프트); 저장소 수준 SKILL.md 지원 없음

이 저장소는 가장 엄격한 제한(Windsurf의)을 충족하기 위해 결합 번들을 6,000자 미만으로 유지합니다. "하드"는 강제/잘림을 의미하고, "소프트"는 품질 권장 사항입니다.

설계 철학: 의견 없음

모든 것이 공식 문서로 추적 가능 — 각 소스에 링크가 제공됩니다.
스킬은 서로 모순될 수 있습니다 — 소스가 그렇기 때문입니다(예: 두 패키지가 다른 폴더 레이아웃을 권장). 둘 다 표시됩니다.
콘텐츠는 일정에 따라 업스트림에서 다시 가져옵니다 — 따라서 스킬은 공식 지침의 변경을 추적합니다.
원하는 대로 자유롭게 변경할 수 있습니다 — 저장소 자체는 객관성을 유지합니다.

기여 및 라이선스

Fork하고, 스킬(skills/ 내) 또는 규칙(rules/ 내)을 추가/수정하고, PR을 엽니다.
하나의 필수 요구 사항: 추가되거나 변경된 모든 것에 공식 문서 링크를 포함합니다. 소스가 ATTRIBUTION.md에 없으면 라이선스와 함께 추가합니다. 라이선스가 허용적이지 않으면 인용 대신 지침을 다시 설명합니다.
라이선스: 저장소 자체 콘텐츠(주제 선택, 트리거 설명, 표현/구조)는 MIT. 기본 문서는 자체 조건을 유지 — Flutter/Dart/Firebase는 대부분 CC BY 4.0, 코드 샘플은 BSD-3 또는 Apache 2.0, 패키지 README는 MIT/Apache 2.0, 그리고 일부 소스(Apple, Google Play, RevenueCat)는 공개 라이선스가 아니므로 복사가 아닌 사실로 다시 설명됩니다. 재배포는 CC BY 저작자 표시에 따라 소스 링크를 유지해야 합니다. 전체 매핑은 ATTRIBUTION.md에 있습니다.

결론

한 번의 설치로 AI 코딩 에이전트에 필요한 시점에 정확히 나타나는 문서 기반 Flutter/Dart/Firebase 지침을 제공합니다 — 수동 설정 없음, 컨텍스트 비대 없음, 임의 규칙 없음. 플러그인은 업데이트를 유지하고, 수동 복사는 다른 모든 곳에서 작동하며, 레거시 규칙 파일은 스킬을 지원하지 않는 도구를 지원합니다.