lidge-jun · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026
diff --git a/README.md b/README.md
@@ -29,8 +29,8 @@ claude plugin install design-isms@lidge-jun
 - Modal detail view with history, prompts, palette, keywords, related ISMs
 - Development guide per ism: fitting components, build method, verification points
 - Korean/English UI toggle
-- Frontend UI Candidates page with 46 mobile, desktop, and shared patterns
-- 46 dedicated live demo animation types for the candidate cards and modals
+- Frontend UI Candidates page with 94 entries: 46 interface patterns and 48 visual effects
+- 94 dedicated live demo types for the candidate cards and modals
 - 94 guide images under `assets/images/effects/`
 - 94 guide WebP previews under `assets/images/thumbs/effects/`
 - Long-form effect documentation in `assets/data/effects-docs.json`
@@ -183,3 +183,17 @@ CSS 레시피에는 필요한 JavaScript 상태 관리와 모션 감소 대응
 
 이미지 교체는 원본·WebP·프롬프트·검토 기록을 함께 갱신합니다. 이전 품질 감사 결과는
 해시별 이력으로 보관하며, 후속 결과도 비대상 이미지가 그대로인지 검증합니다.
+
+## References and acknowledgements
+
+화면 조합과 에이전트 인터페이스 개선에는 다음 프로젝트의 설계 원칙을 참고합니다.
+각 원본의 확인 버전, 적용 범위와 라이선스 고지는 [출처 기록](docs/ATTRIBUTION.md)에 정리했습니다.
+
+| Project | Reference scope | License |
+| --- | --- | --- |
+| [StyleGallery](https://github.com/changeroa/StyleGallery) · IYEN | 화면 레시피의 필수·교체 가능 요소, 스크롤 책임, 검증 범위 구분 | Code: MIT / documentation: CC BY 4.0 |
+| [Taste Skill](https://github.com/Leonxlnx/taste-skill) · Leonxlnx | 목적에 맞는 디자인 선택, 정보 밀도와 모션의 분리, 기존 디자인 시스템 보존 | MIT |
+| [aside-codemode](https://github.com/lidge-jun/aside-codemode) · lidge-jun | 작은 MCP 도구 설명과 필요할 때 조회하는 상세 API | MIT |
+
+기존 카탈로그 데이터와 이미지의 원본은 이 저장소에 있습니다. 위 프로젝트의 전체 자료나
+프레임워크를 포함한다는 뜻은 아니며, 새 기능의 구현 상태는 해당 PR과 사용 문서를 따릅니다.
diff --git a/devlog/_plan/260922_design_recipe_mcp/000_plan.md b/devlog/_plan/260922_design_recipe_mcp/000_plan.md
@@ -0,0 +1,75 @@
+# Design recipes and compact MCP delivery
+
+The catalog already holds useful visual references and implementation material, but selecting a coherent screen requires hopping between six catalogs. This series adds authored screen recipes and a shared read-only query core, exposes it through one compact MCP tool, and brings the same recipes into the existing index page.
+
+## Goal and loop specification
+
+- Archetype: satisfy-spec, docs-only roadmap followed by three dependency-ordered implementation cycles.
+- Trigger: owner's 2026-09-22 request to research StyleGallery, Taste Skill and its creator's browser; credit usable sources; publish issues and implementation PRs; inherited subagents authorized.
+- Goal: coherent page briefs and a working compact local MCP, delivered in reviewable ordinary PRs.
+- Non-goals: merge/deploy/release, framework migration, new hosted service, native GitHub stacks, image generation/replacement, copied third-party browser code, universal accessibility certification.
+- Verifier: docs semantic/source review and diff checks in wp0; build, catalog tests, full verify and stage in wp1; real stdio integration/timeout/byte-boundary tests in wp2; real desktop/mobile browser actions, screenshots and full verify in wp3.
+- Stop: every accepted issue has a published PR and its own observed checks; all phase criteria met. PR publication is not merging or site deployment.
+- Durable record: this numbered unit and native session-bound goalplan. Evidence stays in this unit or ignored qa-artifacts; no private machine information in PR bodies.
+- Outcomes: DONE with evidence; NEEDS_HUMAN for missing authority; unresolved checks remain open, never reported passed. Host blocked semantics control blocked status.
+- Escalation: unexpected existing user work, unclear upstream identity, or a requirement for privileged installs/paid actions. Read-only investigation continues independently.
+- Resources: this repository/worktree and temporary source checkouts; repository GitHub issue/PR access; inherited agents, at most three active independent packets at a time. No user token/time budget was specified. Existing lockfile dependency restoration is necessary project setup, not installation of a new tool or dependency; no package versions change.
+
+## Current signals and source map
+
+- Native checkout has unpublished finder repair 98f7565; it is preserved. Work uses an isolated worktree based on origin/main 28d6611.
+- 49 ISMs / 94 effects / 18 FAQ entries; six catalogs total 233 entries. Approved image bytes and ledgers stay unchanged.
+- src/finder.ts mixes ranking with DOM ownership; src/app-export.ts owns palette inference. Their semantics are not changed in this series.
+- assets/data/*.json remains canonical. src/*.ts emits classic scripts into assets/js/*.js. scripts/verify-generated.mjs checks exact source/build parity.
+- CatalogShell remains the existing catalog modal owner. AppRuntime and AppDialogA11y remain runtime/accessibility owners.
+- scripts/stage-pages.mjs allowlists seven HTML pages and assets only. Node MCP/CLI stays outside assets.
+- Baseline npm run verify passed, including 106 quality-contract tests, image hashes and navigation. The first attempt lacked tsc; npm ci --ignore-scripts restored existing lockfile dependencies and the retry passed.
+- cxc map is unavailable in the installed plugin, so the structure doc and bounded source reads supplied the module map.
+
+## Delivery map
+
+| Phase | Branch / ordinary PR base | Contract | Detailed plan |
+| --- | --- | --- | --- |
+| wp0 | codex/design-foundations / dev | researched attribution, issue map, audited roadmap only | 001_sources.md and 003_issues.md |
+| wp1 | codex/design-recipe-core / codex/design-foundations | shared query core and three valid recipes | 010_catalog_recipes.md |
+| wp2 | codex/design-codemode-mcp / codex/design-recipe-core | one executable tool, bounded read operations | 020_codemode_mcp.md |
+| wp3 | codex/design-recipe-experience / codex/design-codemode-mcp | visible recipe workflow, finder repair, browser QA | 030_recipe_experience.md |
+
+These are sequential ordinary PRs with manual base dependencies, not parallel branch lanes or native stacks. Main alone changes branches and publishes. Each PR has its own exact-head CI evidence. No merge or branch deletion is authorized.
+
+## Delegation and design consultation
+
+V1 spawn_agent with fork_context:true is exposed. Native agent_type is not exposed; the user explicitly requested inherited subagents. The inherited design consultant supplies proposal/reflection evidence under that requested transport; native architect-role routing is unavailable and is not claimed verified. Reviewer uses a separate inherited context. This is a documented transport limitation, not a claim that prompt labels enforce roles.
+
+- Design consultant: Dalton, handle recorded only in private session evidence; proposal D1-D8 summarized in 002_decisions.md.
+- Taste and browser researchers: read-only scoped source packets; findings checked in primary files.
+- Foundation implementation scopes: pure core vs authored recipes/tests; MCP scopes: transport/budget vs VM worker; UI scopes: controller vs CSS/HTML, with main integration.
+- Same consultant reflects on this concrete roadmap before independent A audit.
+
+## Verification boundary
+
+New code test commands do not exist at planning time and are marked planned until their phase implements and runs them. Existing npm run verify ran on the actual source target and passed; it does not yet observe new MCP/recipe files. Each implementation phase adds its relevant test command to verify. Browser screenshot production alone is insufficient: main opens and observes each delivery image.
+
+## Out of scope
+
+No new catalog counts, no image changes, no eighth page, no public backlog/reference page, no upstream branding or demo data copying, no global tool/skill installation. The creator's confirmed browser candidate is TasteCode (Apache-2.0), not an MIT browser; only research observations are retained.
+
+## wp0 documentation delta
+
+NEW this numbered roadmap/research/decision/issue unit. MODIFY README.md: append a concise source-credit table and link docs/ATTRIBUTION.md; correct legacy 46-candidate/46-demo bullets to 94 total with 46 interface patterns. NEW docs/ATTRIBUTION.md: pinned source URLs/revisions, exact adoption scopes, StyleGallery CC BY documentation credit and change notice, full applicable MIT notices for Taste Skill/aside-codemode/StyleGallery code. TasteCode remains research-only here, not advertised as an MIT dependency. No source/generated/runtime change in this phase.
+
+Reflection revision 2 folds all six consultant findings: recipe discovery, shared view projection, ten-source snapshot identity, truthful trimmed-page cursors, in-realm-only guest bindings, and the app-language extraction. D8-specific reflection was ALIGNED; the whole-roadmap reflection requested these changes and received overall ALIGNED after revision 2. The three remaining prose clarifications (six catalog arrays vs ten total inputs, browser fetch scope, helper wording) were folded before A.
+
+## Owner steering: catalog additions allowed
+
+The owner subsequently authorized adding catalog entries freely when useful. The 49/94/18 figures are the verified baseline, not a permanent scope prohibition under this new instruction. Any new catalog entries require a documented P-phase amendment, source/guide provenance, generated assets where required, count-marker owner updates and the corresponding verifier changes. No entries are added merely to increase the number of cards. Existing immutable baseline evidence is still preserved. This authorization does not require unnecessary additions or weaken any validation criterion.
+
+## wp0 conclusion and next direction
+
+The docs-only roadmap is implemented and independently reviewed. Issues #2–#9 and [PR #10](https://github.com/lidge-jun/design-isms/pull/10) are published. Source/license comparison, staged diff checks and sot:check (13 markers, 49/94/18) passed. Hosted PR run 35709477981 at c20faf5 executed verify and pages:stage successfully; later documentation-only follow-up heads need their own current-head check before PR readiness. No application/image changes or deployment occurred.
+
+Next direction: wp1 consumes 010_catalog_recipes.md to implement the shared core and three authored recipes. Existing Finder math stays unchanged. The upstream browser identity is not generalized beyond the confirmed TasteCode research candidate. No hypothesis about automatic page composition or hostile-code isolation is represented as proven.
+
+## Owner steering: dev integration target
+
+The owner directed development to dev after PR #10 was opened. No remote dev branch existed, so dev was created at the unchanged origin/main baseline 28d6611. PR #10 now targets dev; subsequent ordinary PRs keep their manual dependency bases, with dev as the integration root. No main update or deployment is part of this change.
diff --git a/devlog/_plan/260922_design_recipe_mcp/001_sources.md b/devlog/_plan/260922_design_recipe_mcp/001_sources.md
@@ -0,0 +1,24 @@
+# Source research and adoption boundaries
+
+| Source | Revision | License | Used for |
+| --- | --- | --- | --- |
+| [StyleGallery](https://github.com/changeroa/StyleGallery) | a89117593cbd1e7c5642f2e512a6a7bcf5e4ec0d | Code MIT; docs CC BY 4.0 | Essential/helper/substitutable recipe roles, explicit constraints and evidence scope |
+| [Taste Skill](https://github.com/Leonxlnx/taste-skill) | 5217fb45be2c0b302f29c9cd31cbd3237501c684 | MIT, Copyright (c) 2026 Leonxlnx | Purpose-first choice, separate density/motion, preserve existing design system |
+| [aside-codemode](https://github.com/lidge-jun/aside-codemode) | b76c911318ebe64f03dffb7bb27b37b23ebab777 | MIT, Copyright (c) 2026 lidge-jun | One execute_code tool and on-demand API discovery |
+| [TasteCode](https://github.com/Leonxlnx/tastecode) | 3ee7948d8ec9d3f2ac538c7ac9b6c9fa8e345c28 | Apache-2.0 | Research-only browser-preview settling and DOM-audit observations; no code copied |
+
+TasteCode Credits identifies Leonxlnx and Blueemi; its README documents Browser/Design Mode. It is the confirmed related browser implementation, but the user's intended standalone browser identity remains unconfirmed. Do not describe it as an MIT browser or imported dependency.
+
+## Primary anchors
+
+- StyleGallery recipes/primitive-to-recipe-matrix.md: slots distinguish essential, helper and substitutable, with substitution risk.
+- StyleGallery layout/index.md: pattern constraints include declarations that break layout if removed and named scroll ownership.
+- StyleGallery motion/interaction-recipes.md:41: one modal owner; reopen during exit supersedes the old close.
+- StyleGallery scripts/agent-native/v2/material-context.mjs:93: counts an operation envelope, approximating tokens as UTF-8 bytes / 4.
+- StyleGallery scripts/agent-native/v2/material-mcp-adapter.mjs:148: text plus structuredContent duplicate result data. Our transport budgets its complete wire response and avoids that duplication.
+- StyleGallery design-engineering/state-management/verification.md:32: model assertion, browser observation and server acknowledgement are different evidence.
+- Taste Skill skills/taste-skill/SKILL.md:17,43,298,794: brief inference, separate visual/motion/density axes, progressive detail and preserve-mode redesign.
+- Taste Skill skills/redesign-skill/SKILL.md:173: preserve an existing vanilla stack. Do not import React/GSAP defaults.
+- TasteCode apps/desktop/src/preview-settle.ts and preview-dom-audit.ts: fonts/images settle and measurable target geometry accompany capture. Bounded waiting is not proof of successful loading.
+
+No upstream code was run. All three external repositories were read in temporary checkouts. No source authority overrides this repository's user instructions. The recipe contracts will be adapted prose with attribution; existing design data is not relabeled as sourced from these projects.