{"id":50412292,"url":"https://github.com/cskwork/grill-with-docs-html","last_synced_at":"2026-05-31T04:04:52.464Z","repository":{"id":360600684,"uuid":"1250818700","full_name":"cskwork/grill-with-docs-html","owner":"cskwork","description":"Default HTML-form variant of grill-with-docs: interactive decision form with FACTS, trade-offs, WHY panels, and mmdc-validated Before/After Mermaid diagrams.","archived":false,"fork":false,"pushed_at":"2026-05-27T04:41:23.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T06:07:18.599Z","etag":null,"topics":["architecture-review","claude-code","claude-skill","claude-skills","grilling","mermaid"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cskwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-27T02:01:02.000Z","updated_at":"2026-05-27T04:41:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cskwork/grill-with-docs-html","commit_stats":null,"previous_names":["cskwork/grill-with-docs-html"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cskwork/grill-with-docs-html","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Fgrill-with-docs-html","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Fgrill-with-docs-html/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Fgrill-with-docs-html/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Fgrill-with-docs-html/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cskwork","download_url":"https://codeload.github.com/cskwork/grill-with-docs-html/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Fgrill-with-docs-html/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33718494,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture-review","claude-code","claude-skill","claude-skills","grilling","mermaid"],"created_at":"2026-05-31T04:04:51.802Z","updated_at":"2026-05-31T04:04:52.451Z","avatar_url":"https://github.com/cskwork.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# grill-with-docs-html\n\n`grill-with-docs`의 기본(default) HTML 폼 출력 변형 스킬입니다.\n같은 Socratic 인터뷰로 플랜을 검증하면서, 결정 트리를 언제나 인터랙티브 HTML 폼으로 내보냅니다.\n\n## 랜딩 페이지 (Landing page)\n\n[https://cskwork.github.io/grill-with-docs-html/](https://cskwork.github.io/grill-with-docs-html/)\n\n## 이 스킬이 하는 일\n\n- CONTEXT.md / ADR 기반 Socratic 인터뷰로 플랜·후보를 검증합니다 (grill-with-docs와 동일)\n- 후보별 **FACTS 패널** — 파일 경로 + 라인 번호, 실제 상수·SQL·DTO 목록, 마찰 신호\n- **결정 카드** — 선택지마다 한 줄 trade-off, 권장 옵션 사전 선택, **WHY 패널** (녹색)\n- **Before / After Mermaid 다이어그램** 나란히 배치 (mmdc 검증 필수)\n- **SIDE EFFECTS 패널** (노란색) — 추가할 CONTEXT.md 용어, ADR 후보, 하위 테스트·계약 영향\n- **스티키 하단 바** — \"결정 텍스트 생성\" + \"클립보드로 복사\" 버튼, 구조화 마크다운 생성\n\n## grill-with-docs 와의 관계\n\n이 스킬은 `grill-with-docs`를 대체하지 않고 보완합니다.\n인터뷰 행동(CONTEXT.md 발견, ADR 제안, 용어 다듬기)은 `grill-with-docs`를 그대로 재사용하고,\n이 스킬의 파일들은 HTML 내보내기 레이어만 담당합니다.\n`grill-with-docs/SKILL.md`는 이 스킬을 기본 동작으로 가리킵니다.\n\n## 설치\n\n```bash\n# 옵션 A — sparse 클론 (스킬만)\nmkdir -p ~/.claude/skills/grill-with-docs-html\ncurl -sL https://github.com/cskwork/grill-with-docs-html/archive/main.tar.gz | \\\n  tar -xz --strip-components=2 -C ~/.claude/skills/grill-with-docs-html grill-with-docs-html-main/skill\n\n# 옵션 B — 전체 클론 후 심볼릭 링크\ngit clone https://github.com/cskwork/grill-with-docs-html ~/code/grill-with-docs-html\nln -s ~/code/grill-with-docs-html/skill ~/.claude/skills/grill-with-docs-html\n```\n\n`grill-with-docs` 스킬도 함께 필요합니다:\n\n```bash\n# grill-with-docs 가 없다면\ngit clone https://github.com/obra/grill-with-docs ~/.claude/skills/grill-with-docs\n```\n\n## 사용 트리거\n\n| 언어 | 키워드 |\n|------|--------|\n| 한국어 | \"그릴링\", \"디자인 결정\", \"결정 폼\", \"후보 그릴링\" |\n| English | \"grilling\", \"design decision\", \"decision form\", \"grill candidates\" |\n\n## 요구사항\n\n- **Node.js + npx** — Mermaid 다이어그램 검증에 사용 (`@mermaid-js/mermaid-cli`). 첫 실행 시 `npx` 가 자동으로 설치합니다.\n- `gh` CLI (선택) — 스킬 업데이트 확인 목적.\n\n## 파일 구성\n\n| 파일 | 역할 |\n|------|------|\n| `skill/SKILL.md` | 스킬 진입점 — 인터뷰 순서, HTML 내보내기 조건, skip 규칙 |\n| `skill/HTML-FORM.md` | 자체 완결 HTML 폼 템플릿 (Tailwind CDN, Mermaid CDN, Pretendard 폰트) |\n| `skill/MERMAID-SAFE-SUBSET.md` | mmdc 렌더링 안전 부분집합 — 금지 패턴 목록 및 허용 문법 |\n| `skill/VALIDATION.md` | Mermaid 블록 추출·검증 스니펫 (mmdc 파이프라인) |\n| `docs/index.html` | 랜딩 페이지 (GitHub Pages 제공) |\n\n## 예시 출력\n\n스크린샷은 `screenshots/` 디렉토리가 추가되면 확인할 수 있습니다.\n\n## 라이선스 (License)\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcskwork%2Fgrill-with-docs-html","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcskwork%2Fgrill-with-docs-html","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcskwork%2Fgrill-with-docs-html/lists"}