client-component-architecture

Enforce a three-tier React component architecture with Page, Feature, and Hook layers.

Updated Aug 27, 2026
Ready to run
npx skills add https://github.com/juchanhwang/missionary --skill client-component-architecture
๐Ÿ’ฌ Prompt for ChatGPT / Claude Chatโ–ผ
Please help me install this Agent Skill.
Skill: client-component-architecture
Source: https://github.com/juchanhwang/missionary/tree/main/.claude/skills/client-component-architecture
Command: npx skills add https://github.com/juchanhwang/missionary --skill client-component-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

React ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ UI๋ฅผ ํŽ˜์ด์ง€-๋ ˆ์ด์•„์›ƒ ์…ธ(Page, Compositor), ์ž๊ธฐ ์™„๊ฒฐ์  Feature ์ปดํฌ๋„ŒํŠธ, ๋กœ์ง ์ถ”์ƒํ™” ๊ณ„์ธต์ธ Hook์œผ๋กœ ๊ตฌ์„ฑํ•˜๋Š” 3๊ณ„์ธต ์•„ํ‚คํ…์ฒ˜๋ฅผ ๊ฐ•์ œํ•˜๊ณ  ๊ฐ€์ด๋“œํ•ฉ๋‹ˆ๋‹ค. ์ด ๊ตฌ์กฐ๋ฅผ ํ†ตํ•ด ์„ค๊ณ„ ์ผ๊ด€์„ฑ, ์ฝ”๋“œ ๋ฆฌ๋ทฐ ํšจ์œจ์„ฑ, ์žฌ์‚ฌ์šฉ์„ฑ์„ ๋†’์ด๊ณ  ์‹ ๊ทœ ํŒ€์›์ด ๋น ๋ฅด๊ฒŒ ์˜จ๋ณด๋“œ๋˜๋„๋ก ๋•์Šต๋‹ˆ๋‹ค.

Core Features & Use Cases

  • Page๋Š” Compositor ์—ญํ• ์„ ๋งก์•„ ๋ ˆ์ด์•„์›ƒ๊ณผ ๋น„๋™๊ธฐ ๊ฒฝ๊ณ„๋งŒ ๋‹ด๋‹นํ•˜๊ณ , ๋ฐ์ดํ„ฐ ํŒจ์นญ์ด๋‚˜ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง์€ ํ”ผํ•ฉ๋‹ˆ๋‹ค.
  • Feature Component๋Š” ์ž์ฒด Hook์œผ๋กœ ๋ฐ์ดํ„ฐ์™€ ์ƒํƒœ๋ฅผ ์†Œ์œ ํ•˜์—ฌ ๋…๋ฆฝ์ ์œผ๋กœ ํ…Œ์ŠคํŠธยท์ด๋™ยท์‚ญ์ œ๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
  • Hook Layer๋Š” ๋ฐ์ดํ„ฐ ํŒจ์นญ(useGet*), UI ์ƒํƒœ(use*) ๋ฐ ์‚ฌ์ด๋“œ ์ดํŽ™ํŠธ(use*Action)๋กœ ์—ญํ• ๋ณ„๋กœ ๋ถ„๋ฆฌ๋ฉ๋‹ˆ๋‹ค.
  • Use Case: ์ƒˆ๋กœ์šด ํŽ˜์ด์ง€๋ฅผ ๋„์ž…ํ•  ๋•Œ Page-์ผ๊ด€์„ฑ ์œ ์ง€, ๊ฐ Feature์˜ ์žฌ์‚ฌ์šฉ์„ฑ, ํŒ€ ๊ฐ„ ํ˜‘์—… ํšจ์œจ์„ ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.

Quick Start

Adopt the three-tier React architecture by designating a Page as the Compositor, self-contained Feature components, and a Hook layer for logic.

Frequently Asked Questions about client-component-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure React components to separate business logic from UI layout?โ–ผ

Use a three-tier React component architecture where Page acts as a Compositor for layout and async boundaries, Feature components own their UI state, and Hook layers isolate data fetching and side effects. This ensures clear separation of concerns.

What is the best way to organize React hooks for data fetching and state management?โ–ผ

Organize React hooks by splitting roles into useGet* for data fetching, use* for UI state, and use*Action for side effects. This dedicated hook layer isolates logic and ensures predictable UI development.

How do I enforce consistent React architecture during code reviews?โ–ผ

Enforce React architecture during code reviews by verifying Page components avoid business logic, Feature components are self-contained and testable, and hooks follow the useGet*, use*, and use*Action role conventions.

Why should a React Page component avoid data fetching and business logic?โ–ผ

A React Page component should avoid business logic because it serves strictly as a Compositor for layout and asynchronous boundaries. Delegating logic to Feature components and Hooks maintains design consistency and improves code reusability.

Does the three-tier React component architecture work for large scalable applications?โ–ผ

Yes, the three-tier React component architecture supports large scalable applications by isolating self-contained Feature components and separating Hook roles. This structure maintains team collaboration, testability, and predictable UI development at scale.