@infomind-ux/infoux-mcp 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +81 -0
- package/bin/server.js +331 -0
- package/data/contract.md +215 -0
- package/data/manifest.json +286 -0
- package/data/references/accessibility.md +243 -0
- package/data/references/forbidden-patterns.md +462 -0
- package/data/references/guide-import.md +93 -0
- package/data/references/html-semantics.md +475 -0
- package/data/references/krds-components.md +1426 -0
- package/data/references/krds-source.md +1125 -0
- package/data/references/krds-tokens.md +201 -0
- package/data/references/project-profiles.md +99 -0
- package/data/references/snippet-template.md +185 -0
- package/data/references/tailwind-mapping.md +53 -0
- package/data/rules.json +780 -0
- package/data/snippets/accordion.md +49 -0
- package/data/snippets/alert.md +37 -0
- package/data/snippets/badge.md +29 -0
- package/data/snippets/boilerplate.md +125 -0
- package/data/snippets/breadcrumb.md +26 -0
- package/data/snippets/btn.md +63 -0
- package/data/snippets/calendar.md +64 -0
- package/data/snippets/card.md +50 -0
- package/data/snippets/carousel.md +43 -0
- package/data/snippets/check-radio.md +55 -0
- package/data/snippets/disclosure.md +44 -0
- package/data/snippets/file-upload.md +34 -0
- package/data/snippets/form.md +68 -0
- package/data/snippets/header.md +56 -0
- package/data/snippets/list.md +64 -0
- package/data/snippets/main-menu.md +49 -0
- package/data/snippets/modal.md +54 -0
- package/data/snippets/pagination.md +41 -0
- package/data/snippets/progress.md +30 -0
- package/data/snippets/select.md +34 -0
- package/data/snippets/side-panel.md +57 -0
- package/data/snippets/spinner.md +24 -0
- package/data/snippets/step-indicator.md +38 -0
- package/data/snippets/switch.md +32 -0
- package/data/snippets/tab.md +52 -0
- package/data/snippets/table.md +63 -0
- package/data/snippets/tag.md +42 -0
- package/data/snippets/toast.md +48 -0
- package/data/snippets/tooltip.md +38 -0
- package/data/tokens.css +390 -0
- package/data/workflows/change-token.md +20 -0
- package/data/workflows/create-component.md +71 -0
- package/data/workflows/design-form.md +20 -0
- package/data/workflows/design-page.md +22 -0
- package/data/workflows/design-widget.md +19 -0
- package/data/workflows/init-project.md +68 -0
- package/data/workflows/review-ui.md +14 -0
- package/package.json +34 -0
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# init-project
|
|
2
|
+
|
|
3
|
+
> **언제 쓰나** — INFOUX 스타터 기반 새 프로젝트 초기화. 프로젝트 유형과 브랜드 토큰을 반영해 프로젝트 컨트랙트와 토큰을 설정한다. "새 프로젝트", "프로젝트 시작", "init project" 요청 시 사용.
|
|
4
|
+
|
|
5
|
+
`https://github.com/iux-pub/starter`를 기반으로 Tailwind v4 + 표준 CSS 프로젝트를 초기화한다.
|
|
6
|
+
|
|
7
|
+
## 확인 항목
|
|
8
|
+
|
|
9
|
+
- 프로젝트명
|
|
10
|
+
- 사이트 유형: 일반사이트 / 공공서비스 / 공공기관 / CMS·관리자 / 커머스·예약
|
|
11
|
+
- 브랜드 primary 색상
|
|
12
|
+
- 기본 폰트
|
|
13
|
+
- 타깃 브라우저
|
|
14
|
+
- 컨테이너 최대 너비
|
|
15
|
+
- 정부·공공 아이덴티티 요소 적용 여부
|
|
16
|
+
|
|
17
|
+
사이트 유형이나 공공 요소 적용 여부를 자료에서 확인할 수 없을 때만 사용자에게 질문한다.
|
|
18
|
+
|
|
19
|
+
## 실행 절차
|
|
20
|
+
|
|
21
|
+
1. 스타터를 clone하고 새 Git 저장소로 초기화한다.
|
|
22
|
+
2. `tokens/foundation.json`의 primitive 및 semantic 매핑을 프로젝트 값으로 수정한다.
|
|
23
|
+
3. 프로젝트 고유 CSS가 필요하면 `src/styles/project.css`를 만들고 `style.css`에서 import한다.
|
|
24
|
+
4. 루트 `AGENTS.md`에 프로젝트 유형, 실행 명령, 수정 금지 영역, 검증 명령을 명시한다.
|
|
25
|
+
5. 토큰·CSS를 빌드하고 전체 정적 검사를 실행한다.
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
git clone https://github.com/iux-pub/starter.git {project}
|
|
29
|
+
cd {project}
|
|
30
|
+
rm -rf .git
|
|
31
|
+
git init
|
|
32
|
+
npm install
|
|
33
|
+
npm run check
|
|
34
|
+
npm run build
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## 프로젝트 CSS 예시
|
|
38
|
+
|
|
39
|
+
```css
|
|
40
|
+
/* 프로젝트 전용 확장 */
|
|
41
|
+
:root {
|
|
42
|
+
--container-max-width: 1200px;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
.project-shell {
|
|
46
|
+
font-family: var(--font-sans);
|
|
47
|
+
color: var(--color-text);
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
브랜드 raw 색상은 CSS에 직접 쓰지 않고 `tokens/foundation.json`의 토큰 정의에서만 관리한다.
|
|
52
|
+
|
|
53
|
+
## 생성하는 AGENTS.md 핵심
|
|
54
|
+
|
|
55
|
+
- 가장 가까운 `AGENTS.md`가 해당 디렉터리 작업 규칙을 보강한다.
|
|
56
|
+
- UI 작성 전 사이트 유형을 판정한다.
|
|
57
|
+
- 색상 토큰, BEM, 시맨틱 HTML, WAI-ARIA, page shell 계약을 따른다.
|
|
58
|
+
- 개발팀 소유 코드와 UX팀 소유 CSS 경계를 명시한다.
|
|
59
|
+
- 완료 전 `npm run check`, `npm run lint:css`, `npm run build`를 실행한다.
|
|
60
|
+
- 자동 검사로 확인할 수 없는 키보드 순서, 스크린리더, 실기기는 수동 QA로 보고한다.
|
|
61
|
+
|
|
62
|
+
## 금지
|
|
63
|
+
|
|
64
|
+
- 전처리기 도입
|
|
65
|
+
- CSS에 raw hex/rgb/hsl 작성
|
|
66
|
+
- 폐기된 토큰 별칭 생성
|
|
67
|
+
- 정부 상징이나 공식 배너를 확인 없이 생성
|
|
68
|
+
- 검사 실패 상태로 초기화 완료 보고
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# review-ui
|
|
2
|
+
|
|
3
|
+
> **언제 쓰나** — INFOUX 기준으로 UI 구현을 리뷰하거나 규칙 준수 여부를 점검할 때 사용. 검사 결과만 나열하지 않고 Task Contract, 승인 패턴, 실제 구현의 차이를 우선 분석한다.
|
|
4
|
+
|
|
5
|
+
## 리뷰 순서
|
|
6
|
+
|
|
7
|
+
1. Task Contract 또는 작업 의도를 확인한다.
|
|
8
|
+
2. 사이트 유형과 선택한 page/component/widget 패턴이 맞는지 본다.
|
|
9
|
+
3. 기존 컴포넌트 재사용 가능성을 확인한다.
|
|
10
|
+
4. 시맨틱 HTML, ARIA 관계, 키보드, 포커스, 터치 영역을 검토한다.
|
|
11
|
+
5. 토큰, BEM, Tailwind v4, CSS layer 규칙을 검토한다.
|
|
12
|
+
6. 자동 검사는 마지막 증거로 실행한다.
|
|
13
|
+
|
|
14
|
+
발견 사항은 사용자 영향이 큰 순서로 파일과 위치를 제시한다. 검사 통과만으로 설계 의도가 맞다고 결론내리지 않는다.
|
package/package.json
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@infomind-ux/infoux-mcp",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "INFOMIND UX 퍼블리싱 기준(infoUX)을 MCP로 제공한다. 토큰·컴포넌트·규칙·접근성 기준을 에이전트가 직접 조회한다.",
|
|
5
|
+
"bin": {
|
|
6
|
+
"infoux-mcp": "bin/server.js"
|
|
7
|
+
},
|
|
8
|
+
"files": [
|
|
9
|
+
"bin/",
|
|
10
|
+
"data/",
|
|
11
|
+
"README.md"
|
|
12
|
+
],
|
|
13
|
+
"dependencies": {
|
|
14
|
+
"@modelcontextprotocol/sdk": "^1.30.0"
|
|
15
|
+
},
|
|
16
|
+
"engines": {
|
|
17
|
+
"node": ">=20.0.0"
|
|
18
|
+
},
|
|
19
|
+
"keywords": [
|
|
20
|
+
"infomind",
|
|
21
|
+
"ux",
|
|
22
|
+
"krds",
|
|
23
|
+
"design-system",
|
|
24
|
+
"mcp",
|
|
25
|
+
"model-context-protocol"
|
|
26
|
+
],
|
|
27
|
+
"homepage": "https://github.com/iux-pub/guide",
|
|
28
|
+
"repository": {
|
|
29
|
+
"type": "git",
|
|
30
|
+
"url": "git+https://github.com/iux-pub/guide.git",
|
|
31
|
+
"directory": "mcp"
|
|
32
|
+
},
|
|
33
|
+
"license": "ISC"
|
|
34
|
+
}
|