agentleFS
insightfloinsightflo/edu-deck-skills/AGENTS.md

edu-deck-skills

AGENTS.md7 starsChanged 2 days agoApache-2.0View on GitHub

한국어 교육 덱(단일 HTML) 스킬 묶음 저장소. 진입은 edu-deck/SKILL.md, 공통 자산은 edu-deck/shared/.

The file

Files
AGENTS.md

edu-deck-skills 작업 안내

한국어 교육 덱(단일 HTML) 스킬 묶음 저장소. 진입은 edu-deck/SKILL.md, 공통 자산은 edu-deck/shared/.

규칙

  • 생성 셸 shared/assets/shell.html·pack-shell.html 은 직접 고치지 않는다. python3 shared/dev/port.py 로만 재생성.
  • 클래스·속성 계약(data-step/add/only/lit/until, .chk, aside.notes, st-* 클래스, localStorage 키, window.EDU_STUDY/deckGo/deckInfo)은 다른 모듈이 의존하므로 함부로 바꾸지 않는다.
  • dist/, workspace/, shared/--help/, TASK-*.md, 캐시는 gitignore 대상. 작업 산출물·덱 결과물은 저장소 밖(EDU_DECK_OUTPUT_DIR 또는 ./outputs)에 둔다.
  • 외부 자산 복사 금지: 라이선스 확인 전 것은 가져오지 않는다(effective-html 은 MIT, licenses/ 참조). Koboyo 갤러리는 스킬 밖 파일만 쓰고 덱에 쓰는 아이콘만 복사.
  • PPTX 파워포인트 요청은 ppt-master/SKILL.md(네이티브 편집 가능 PPTX 생성, hugohe3/ppt-master MIT 사본 — 원본 무수정)로 보낸다.

검사

cd edu-deck/shared
EDU_DECK_TEST_DECK=<실덱경로> python3 -m unittest discover -s dev -p 'test_*py'   # 505+개(skip 7)
python3 dev/test_pack_browser.py <아웃풋폴더>    # 64/64
python3 scripts/build_deck.py <덱폴더> && python3 scripts/check_deck.py <결과.html>
python3 scripts/style_preset.py --verify         # 스타일 프리셋 16종 WCAG 4.5:1 대비·스키마 전수 검사
python3 ../../bookstyle-html/scripts/build_book.py <북폴더> -o <북.html> --check && python3 ../../bookstyle-html/scripts/preview.py check <북.html>

현재 상태(2026-11-13)

  • 실사용 피드백 반영 2차(2026-11-14, 4969b80a): 셸·검사기 잔여 3건(Devin TASK-shell-feedback) — ① compact·인쇄에서 비활성 장이 가로로 무너지던 것 수정(responsive.css flex-direction:column, 팩 런타임은 .slide.active 에만 column 이 있었음) ② check_deck '텍스트 계열 나열' 오탐 완화 — 저작자 그림 img/figure/svg(ico·aria-hidden 제외)·data-visual 을 시각 계열 인정(VISUAL_CONTENT_SEL) ③ verify_sources '칩 없는 수치' 오탐 완화 — part-divider/check/closing 화이트리스트+칩 블록·kicker/meta 줄·'예시/가상' 마커(loose_exempt), 무칩 본문 수치는 WARN 유지. 신규 시험 dev/test_shell_feedback 15종(브라우저 compact/print 스택 검증 포함).
  • PPT 시각 자산 브리지 + 실사용 우선 정책(2026-11-14, brandme 교훈): PPT 요청이 ppt-master 로 넘어가도 차트(chart_gen 15종)·아키텍처 도식(arch/iso_layout)·아이콘·스타일 파레트는 우리 자산으로 만들어 삽입 — shared/references/ppt-visual-bridge.md + 신규 shared/scripts/svg2png.py(SVG→PNG, --css/--scope 로 덱 토큰 해결, chart_gen 실물 1200px 렌더 검증). edu-deck/SKILL.md 0단계 연결. 정책: 새 재료·경로 추가를 억제하고 기존 자산의 실사용률을 먼저 올린다(brandme 1~2차=템플릿 기본값만 사용→"없어 보임", 3차=자산 반입 후에야 만족).
  • 검수 게이트 티어제(2026-11-14, 사용자 지시 — 생성 후 검수 과중 완화): edu-deck-solo 6단계·edu-deck-series 4단계를 **기본 게이트(기본값: check_deck 전수·verify_sources 기본·표지+축소판 1장 눈검사·자기 점검 3문, 10~20분)**와 **심화 게이트(조건부: 대외·규정·시리즈 다수·사용자 요청 시만 — 전 장 축소판 육안·--fetch 원문 대조·반응형 6화면·독립 심미 크리틱·팩 전수)**로 분리. design-critique.md §0.5 티어 명시. 말투 교정 재검사는 정적 전수로 충분. 컨설팅 덱은 대외 발표용이라 심화 유지.
  • line-art-animation 편입(2026-11-14): line-art-animation/ 최상위 바이트 사본(JDhruv14/line-art-animation v0.1.0 MIT © 2026 — SKILL.md 97줄·lib 4종 TS(ink/gait/motion/daynight, 의존 0)·references 6종·examples 2종(walker·village)·scripts 3종·media 7.4MB, .git 제외 무수정, licenses/LINE-ART-ANIMATION-MIT.txt·THIRD-PARTY-NOTICES 기록). 라우팅: edu-deck 0단계 "라인아트/손그림 장면" → ../line-art-animation/SKILL.md. E2E 실증: node 24 npm install→ typecheck 통과·vite build 200ms(walker+village 번들). 한국어 실물 데모(사용자 참고 ~/Downloads/server-room.html — 밤 팔레트 서버실 씬)는 별개 후속 과제.
  • style-html 흡수(2026-11-14): 제3자 soverin.cloud 강의안 덱 스킬(라이선스 미표기 → 클린룸 개념 참조만, workspace/absorb/style-html-analysis.md)에서 6건 선별 흡수 — ① 셸 자동 발표 강화: 하단 막대 A 토글 칩(#edAutoBtn)+이 장 남은 시간 칩(#edAutoClock, ≤15초 빨강·≤5초 깜빡, autoWhole 즉시 참값·eduAuto.left 노출, 시맨틱 불변) + talk 덱 ed-clock '· A m:ss' 꼬리표·presenter 동기 ② check_deck data-sec 누락 WARN에 어림 권장 초(표지 30·파트 15·마무리 45·본문 글자÷12+pre×25+그림×5, 70~180 클램프) ③ 표지 17변형 bento(3×3 아이콘 벤토+수치 카드) ④ 도식 래퍼 .win-frame(55-window-frame — 점 3·창 제목·꼬리표, screen-cite와 달리 증거 규율 없음) ⑤ 32-screen-cite quote-text 텍스트 인용 변형(.sc-quote 원문 그대로·.sc-tag '원문 표현') ⑥ 파트 톤(38-part-divider data-tone 1..7 → build가 data-part-tone 전파, 소비 3곳만 eyebrow 점·아젠다 점·구분 강조, 미지정 무변경). 예제 examples/style-demo 9장·시험 +28(test_talk_autoplay 등 4파일). 미흡수: mobile 검사(축소 읽기 철학)·fig_upscale(외부 모델)·og_image(bookstyle 중복)·Paperlogy(OFL 1.1 확인했으나 기존 타이포 유지)·상아 전역 테마(기본 베이스 이미 라이트 페이퍼).
  • draft v2 승격 + 표지 루프 변형 draft-loop(2026-11-13): technical-reveal 2차 개념 흡수 — 제3자 파생 덱(loop-cover, 사용자 제공)의 행동 개념만 클린룸 참조(소스 코드 미열람·식별자 0복사, 분석 workspace/absorb/loop-cover-analysis.md). ①draft 렌더러 v2: 스캔라인 런→윤곽 체인(소벨→NMS→히스테레시스→직진 선호 트레이스→RDP, ≤700체인·분석 장변≤720 1회) + 구성선 피크·플로터 헤드(십자+X/Y 녹아웃) + 치수 카운트업(폭·높이+원 피팅 R/내부거리) + 크로스페이드→−45° 브러시 마스크 리빌(≤0.3배 오프스크린·병렬 털·keepLines 0). 계약 불변(2400ms·캔버스 즉시 정리·오염 폴백·정적 미생성). ②draft-loop(8000ms 드로잉+2500ms 홀드 순환, 홀드 라인 13% 잔류, HUD 위상+ENT nnn/nnn, 요소 인덱스 시드 결정적): 표지·개념 hero 전용, 슬라이드 이탈·dblclick/G 완주→실물 정착, check_deck LOOP_FX 3000ms 면제+캔버스 WARN 양쪽. 셸 port.py 재생성·시험 10종 추가(test_fx_draft 20종)·예제 draft-demo 4장(표지 루프 추가)·MOTION_LIBRARY/expression/fx.html 10종 갱신·THIRD-PARTY-NOTICES 2차 참조 기록. 게이트: 풀스위트 604 OK(skip 15, pi 2차 재실행 — 1차는 stash 경합 오염)·draft-demo 0E0W·privacy-talk 0E0W·클린룸 grep 0·v1/v2 비교 캡처 입증. 독립 시각 크리틱 미실행(agy 쿼터 초과·claude OAuth 401 — workspace/qa/draftv2/ 셀프 점검 기록, 계정 회복 후 재크리틱 권장).
  • ppt-master 편입 + codex-ppt 개념 흡수(2026-11-13): ① ppt-master/ 최상위 편입(hugohe3/ppt-master skills/ppt-master/ 바이트 사본 v6.9.0 — 네이티브 DrawingML PPTX: 슬라이드 마스터·도형·데이터 차트·표 전부 편집 가능, SKILL.md·workflows·scripts·templates·references 무수정, licenses/PPT-MASTER-MIT.txt). 라우팅: edu-deck 0단계 "PPT(PPTX) 만들어 달라" → ../ppt-master/SKILL.md. ② codex-ppt-skill(ningzimu, MIT)은 이미지 기반 비편집 방식이라 폴더 채택 취소 — 대신 12종 스타일 명세·미리보기를 edu-deck/shared/assets/style-sheets/ 로(licenses/CODEX-PPT-SKILL-MIT.txt, design.md 12절 참고 갤러리), 승인 게이트 개념을 우리말 재작성해 edu-deck-solo 3단계(구성안 승인)·3.6(대표 샘플 승인) 하드 게이트 + authoring.md 9절 "한 덱 한 스타일" + series 상속 문구로 반영. 동작 확인: attribution_guard.py EXIT 0·routing.md 26링크 해소. 보고: workspace/codex-ppt-absorb-report.md.
  • technical-reveal 흡수 — 9번째 공통 기법 draft(2026-11-12): 래스터 <img>가 도면(격자+중심선→소벨 스캔라인 런 플롯→치수 카운트업→실물 크로스페)드로 재구성되는 등장 기법 2400ms. 클린룸(원본 코드·팔레트·식별자 0 복사 — MIT, licenses/TECHNICAL-REVEAL-MIT.txt·THIRD-PARTY-NOTICES 기록). 채택처: 표지·개념 hero 이미지 단독, screen-cite(32) 실물 인용 금지. check_deck 신설 "캔버스" WARN(외부 http(s) src — 오염 시 fx-draft-degraded 폴백). 예제 examples/draft-demo(3장, data: URI PNG 자체 생성). 시험 dev/test_fx_draft 10종. 게이트: 풀스위트 594(skip 8) OK·draft-demo check 0E0W·privacy-talk PASS. 분석·보고: workspace/absorb/tech-reveal-{analysis,report}.md.
  • unslop 수정 + kodoc 흡수(2026-11-12): ① bookstyle-html/assets/kit/book.css AI-slop 전항목 제거(그라디언트 텍스트·hue 채움·글로우·glass·eyebrow·radial·text-shadow·900→700·음수 자간)+컨설팅 chart_gen.mjs SO WHAT→시사점·core.css .bar/components.css .lv-bar 단색화·스니펫 라벨/굵기 정리(unslop, CC BY 4.0 — 감사 기준, THIRD-PARTY-NOTICES 기록). ② kodoc 흡수 5종: scripts/vendor/svg-lint/ 벤더 바이트 사본(bybit-exchange MIT, SHA256SUMS·test_svg_lint_vendor), scripts/diagram_lint.py 어댑터(data-lint="svg-diagram" 표식 도식만 — 생성기 arch_layout·iso_layout·chart_gen 자동 부여, 토큰 팔레트 자체 검사, 상류 하우스 기하 규칙은 사유 주석 후 필터, 내부 실패 fail-closed) → check_deck.py·check_consulting.py 연결, check_deck.py DESIGN_LINT_JS 5규칙→INFO(취향, --style에서 WARN), bookstyle-html/scripts/preview.py check --release 배포 게이트(외부 자원·alt·이미지 권리·TODO), bookstyle-html/tests/viewer_smoke.mjs 뷰어 스모크 12/12. 게이트: unittest 552·실덱 7종 check_deck PASS·book release 0건·regen 전부 diff=0. 보고: workspace/unslop-kodoc-report.md.
  • bookstyle-html 스킬 편입 & 스타일 프리셋 16종 계층 신설(2026-11-11): ① bookstyle-html/(600×820 쪽 펼침 넘김 인사이트북 단일 HTML 스킬, assets/kit/{book.css,shell.html,viewer.js}·scripts/{build_book,preview,og_image}.py, 사내 자체 제작 자산 라이선스 클린 확인) 최상위 편입 + edu-deck/SKILL.md 라우팅 연결 + 실물 예제 북(examples/book-demo/book-demo.html, 8쪽) preview.py check 0건 검증. ② edu-deck/shared/presets/*.yaml 고유 장르 프리셋 16종(seoul-editorial·hanji-warm·nordic-slate 등 — 개념 참조: shiraki.design, 재배포 금지로 원본 값·문구 미복제, 전수 독자 창작) 및 scripts/style_preset.py(--list·--verify·--apply, shell.html·check_deck.py 무수정 src/preset.css 주입 방식)·dev/test_style_presets.py·적용 예제(examples/preset-demo/) 완성 + scripts/tone_router.py에 PRESETS 16종 6축 시그니처·preset 후보 3종 추천·--recent-preset 감점 연동(unittest 532개 PASS). 보고: workspace/absorb/ABSORB-REPORT.md, workspace/absorb/tone-preset-report.md.
  • consulting-deck 스킬 완성(2026-11-09): 스킬 문서 8종(SKILL.md 7단계 + references 7종)·차트 생성기 11타입(consulting-deck/charts/chart_gen.mjs, 시험 58종)·실행 도구 3종(assets/consult.css 4방향 exec·dense·editorial·tech / checks/check_consulting.py 근거 원장 대조 / regen.py --check 재생성 계약)·edu-deck 진입 라우팅 연결·심볼릭 등록(~/Projects/skills/consulting-deck). 실물 데모 2종: A ai-transform 12장(.consult-tech, BCG AI Radar 2026 실인용+가상 혼합 원장, Architecture Kit 결합 stack 축① 아키텍처 장) · B it-cost 11장(.consult, 전수 가상). 갤러리 컨설팅 섹션(카드 11장·실물 재생). agy 시각 QA 1차 FAIL→생성기 결함 6종 수정→재검증 양 데모 PASS. 개념 출처: zairuilab/consulting-deck(Apache-2.0)·McKinsey Vizro(Apache-2.0) 개념만 재작성.
  • 워크플로 도식 계열 11종 추가(42~52): sankey-flow·decision-tree·kanban-board·version-graph·event-fanout·route-tour·waterfall·mesh-network·heatmap-grid·swimlane·cycle-ring — 계열 52·변형 253·실행 이름 42(+기법 5)·모션 GIF 47. 원본 참고: ~/Projects/flowmotion-gallery(AI Studio 앱 — 모션 개념·시나리오만 참고, 코드 복사 없음). 지시서 shared/dev/TASK-workflow-series.md.
  • Architecture Motion Graphics Kit(2026-11-08): 시맨틱 JSON → 도식 생성기 2종(scripts/arch_layout.mjs — dagre 3.1.3 vendor·iso_layout.mjs — Networkify 기하 이식)·시그니처 arch-trace(42번째 실행 이름)·references/architecture.md 저작 가이드·architecture-sources.md 재사용 기록·examples/arch-demo 6장면(마이크로서비스·레이어드·토폴로지·아이소 DC·HA 페일오버 6단계·하이브리드 클라우드). Deerin+arch-pi(deepseek) 2워커.
  • 자산 흡수(2026-11-07 후반): klic-prd-motion → 공통 기법 3종(bar-grow·card-deal·blinds, TASK-fx-absorb)·concentric-radius-guide → DESIGN_TOKENS 중첩 반경 규칙. quiz-ab 기본 변형 넘침 수정(TASK-quiz-ab)·뷰어 더블클릭=장 내 끝까지 재생(TASK-dblclick-finish).
  • 클린룸 재작성 캠페인 완료(엔진·CSS·스니펫 28종·자습 계층; 커밋 1c2d281→aab1a7f).
  • 다양성 개편 완료: legacy 테마 17종(assets/css/themes.css, deck.json theme, 기본 classic 포함. 2026-11-12 신규 8종: mono·brick·honey·mint·violet·coral·olive·espresso + 실시간 미리보기 패널 ?themes=1·T키·?theme=, themes.js·theme-switch.css. 단축키 재배정(2026-11-12): 테마=T, 도움말=H(#help 오버레이 토글), 발표 타이머=X)·표지 변형 17종(2026-11-14 벤토 추가)·arc 6종(기본 standard 포함)·scripts/tone_router.py, 팩 라우터 scripts/pack_router.py. 새 덱은 만들기 전에 팩/legacy 중 하나를 에이전트가 판단해 정한다(기본값 없음, 애매하면 사용자에게 한 번 묻는다. 규칙: edu-deck/SKILL.md "경로 결정"). 한 덱에 두 경로를 섞을 수 없다.
  • 자유 모드 완료(커밋 07779cb): 기본은 자유 모드 — 조각·팩 템플릿·arc 메뉴·아키타입 표는 참고 예시이고 지시가 아니다. 재료 사용 4방식(그대로·변형·조합·새로 작성)·작업 덱 src 수정 권한·품질 판단 기준은 shared/references/authoring.md 한 곳에 있다. check_deck.py는 안전 가드(깨짐·접근성·계약)만 ERROR로 막고 취향 규칙은 INFO(--style에서 WARN 상세). data-archetype 없는 장도 허용(엔진 자동 배정). 가이드 모드는 세 경로(고침 3회 실패 자동 폴백·지시·위임)로만 진입한다(규칙: edu-deck/SKILL.md "자유 모드와 가이드 모드").
  • design-craft(문서만): references/design.md 신규(디자인 판단 기준 — 회상 색인→판단→경계 골격, ppt-master·better-web-ui 원리 각용), outline 표 두 곳에 리듬 열(앵커·밀집·숨고르기) 추가, 표지 직접 설계에 방향 3안 비교 절차 추가(edu-deck-solo/SKILL.md 34·82·121행).
  • 회귀 기준선: unittest 671(skip 15 — EDU_DECK_TEST_DECK에 덱 폴더 경로 지정 기준. 파일 경로면 test_extract_copy 3종 클래스 추가 스킵. test_visual_motion arch-flow 샘플링 간헐 플레이크는 기존 문서화됨) + arch-demo 6/6 + arch-si 13/13 + pack_browser 64/64 + 컨설팅 데모 2종(check_deck·check_consulting·regen) PASS. contrast-matrix 450셀 PASS(음성 케이스 포함). link_audit 446/446.
  • PPT 경로 편입(2026-11-13, fa771ba8): "PPT(PPTX) 만들어" 요청 → 최상위 ppt-master/(MIT·네이티브 편집 가능 — E2E 실증: 7장·도형 167·텍스트 프레임 79·이미지 0, outputs/ppt-e2e). 승인 게이트(구성안·3.6 대표 샘플)·스타일 시트 12종(assets/style-sheets/)·authoring §9 통일감은 codex-ppt(MIT) 개념 흡수 — codex-ppt 스킬 자체는 이미지 기반 비편집으로 제외.
  • 아키텍처 재료 전면 개편(2026-11-10, a4534e5): 중첩 쓴(zones.parent)+솔리드 헤더 바·맨해튼 직교 라우터(사선 0)+buses 백본 T-드롭(간선 캡 외과)+haPairs·복합 노드 템플릿(equip·cluster·rack-group)+마이크로 타이포 계약(k-t-spec/eq/qty 12px 하한·문서·테스트 동반)·SI 장비 2톤 아이콘 16종(assets/icons/si.svg)·.arch-blueprint 테마+bp-head·sidePanel BOM·legend bar — 원본 대비 분석 workspace/ref-arch-compare.md, arch-si a1a 노드 25·중첩 3·캔버스 99% 실측. 근거·보고: workspace/p3/arch-overhaul-report.md.
  • 디자인 QA 내재화 완료(2026-11-10): 공통 심미 크리틱 shared/references/design-critique.md(6단계·9항목·Blocker/Major/Minor·취향 강제 금지·agy 호출 계약) 전 스킬 연결, capture_deck.py shared 승격. Track A: consult.css 헤어라인 재작성(c-rule-rows·c-sidecar·--c-num-font)·chart_gen 사이드카/bridge/targetQuadrant. 검증 4멈(privacy-talk·seminar 신규·arch-si·ai-transform) FAIL→PASS 입증.
  • 대기: 없음 — GitHub Pages는 main push로 자동 반영(실측 확인·별도 게시 작업 없음), 배포 zip은 불필요로 폐기(2026-11-11 사용자 결정). 한계: 테마는 색·그림자·반경만 바꾸고 장 배치는 같음.
  • 작업자: Devin 은 항상 1개만. 추가 작업자는 pi(glm-zcode/glm-5.3-flash, max).
  • 위임: Devin 우선(이 폴더는 devin 신뢰 경로 등록됨), pi 는 조율·검증. herdr 사용: hc run --name <이름> --bg devin --permission-mode dangerous + hc send 로 지시.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.