Communitygithub.com

solitasroh/rkit

초보자와 비개발자를 위한 정적 웹 개발 스킬입니다. HTML/CSS/JavaScript 및 Next.js App Router 기초를 다룹니다. 'init starter' 또는 'starter init' 명령어로 프로젝트를 초기화합니다.

rkit란 무엇인가요?

이 스킬은 코딩 초보자나 비개발자가 간단한 정적 웹사이트(포트폴리오, 랜딩 페이지, 개인 사이트 등)를 빠르게 만들 수 있도록 돕는 가이드 역할을 합니다. 사용자는 'init starter' 또는 'starter init' 프롬프트를 통해 프로젝트를 시작할 수 있으며, 순수 HTML/CSS/JavaScript(옵션 A) 또는 Next.js + Tailwind CSS(옵션 B) 중 하나를 선택할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 도구와 함께 사용하도록 설계되었으며, 프로젝트 초기화, 개발 가이드 제공, 초보자 질문에 대한 친절한 답변을 주요 액션으로 제공합니다. 또한 rkit-learning 출력 스타일을 통해 학습 포인트를 제공하고, 에이전트 메모리 기능으로 학습 진행 상황을 세션 간에 유지합니다. 단, 로그인, 데이터 저장, 관리자 페이지, 결제 기능 등 백엔드가 필요한 풀스택 애플리케이션 개발에는 적합하지 않으며, 이러한 요구사항이 생기면 Dynamic 레벨로 업그레이드하는 것이 권장됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/solitasroh/rkit/tree/HEAD/skills/starter

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

0. 문서 구조 (본 SKILL의 세 층)

  1. 도메인 본문 (§1 ~ §N): 이 SKILL의 프로토콜. 잠금 어휘 사용 0건이 verify-policy --check body-neutrality로 자동 검증됩니다.
  2. 방법론 본문 — 도메인 중립: Cycle 3에서 <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> 마커로 감싸진 영역.
  3. 도메인 예시 부록 (§A): MCU/MPU/WPF 도메인별 사례. SoT(policies/locked-vocab.json)에서 scripts/gen-locked-vocab.mjs가 자동 생성합니다.

직접 부록을 편집하지 마세요 — node scripts/gen-locked-vocab.mjs로 재생성됩니다.


초급(Starter) 스킬

액션

액션설명예시
init프로젝트 초기화 (/init-starter 기능)/starter init my-portfolio
guide개발 가이드 표시/starter guide
help초보자 도움말/starter help

init (프로젝트 초기화)

  1. 프로젝트 디렉터리 구조 생성 (HTML/CSS/JS 또는 Next.js)
  2. package.json 생성 (Next.js 선택 시)
  3. CLAUDE.md 생성 (레벨: Starter 지정)
  4. docs/ 폴더 구조 생성 (PDCA 문서용)
  5. .rkit/state/memory.json 초기화

guide (개발 가이드)

  • 현재 프로젝트 상태 분석
  • Starter 레벨에 적합한 다음 단계 제안
  • 1~3단계 중심의 파이프라인 가이드

help (초보자 도움말)

  • HTML/CSS/JS 기본 개념 설명
  • 자주 묻는 질문 답변
  • 예제 코드 제공

대상 사용자

  • 프로그래밍을 처음 배우는 사람
  • 간단한 웹사이트를 만들고 싶은 사람
  • 포트폴리오 사이트가 필요한 사람

기술 스택

옵션 A: 순수 HTML/CSS/JS (완전 초보자용)

HTML5        → 웹 페이지 구조
CSS3         → 스타일링
JavaScript   → 동적 기능 (선택 사항)

옵션 B: Next.js (프레임워크 사용)

Next.js 14+  → React 기반 프레임워크
Tailwind CSS → 유틸리티 CSS
TypeScript   → 타입 안전성 (선택 사항)

언어 등급 안내 (v1.3.0)

권장: 1등급 언어만 사용 (Python, TypeScript, JavaScript)

Starter 레벨은 AI 도구의 최대 지원을 받는 AI-네이티브 개발에 중점을 둡니다.

등급허용 여부사유
1등급✅ 예전체 AI 지원, Vibe Coding 최적화
2등급⚠️ 제한적대신 Dynamic 레벨 고려
3-4등급❌ 아니오Dynamic/Enterprise로 업그레이드

프로젝트 구조

옵션 A: HTML/CSS/JS

project/
├── index.html          # 메인 페이지
├── about.html          # 소개 페이지
├── css/
│   └── style.css       # 스타일
├── js/
│   └── main.js         # JavaScript
├── images/             # 이미지 파일
├── docs/               # PDCA 문서
│   ├── 01-plan/
│   └── 02-design/
└── README.md

옵션 B: Next.js

project/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # 공통 레이아웃
│   │   ├── page.tsx        # 메인 페이지
│   │   └── about/
│   │       └── page.tsx    # 소개 페이지
│   └── components/         # 재사용 가능한 컴포넌트
├── public/                 # 정적 파일
├── docs/                   # PDCA 문서
├── package.json
├── tailwind.config.js
└── README.md

핵심 개념 설명

HTML (웹 페이지 구조)

<!-- 기본 구조 -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>내 웹사이트</title>
    <link rel="stylesheet" href="css/style.css">
</head>
<body>
    <header>헤더</header>
    <main>주요 콘텐츠</main>
    <footer>푸터</footer>
</body>
</html>

CSS (웹 페이지 스타일링)

/* 기본 스타일 */
body {
    font-family: 'Inter', sans-serif;
    margin: 0;
    padding: 0;
}

/* 가운데 정렬 */
.container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 20px;
}

/* 반응형 (모바일 지원) */
@media (max-width: 768px) {
    .container {
        padding: 10px;
    }
}

Next.js App Router (페이지 생성)

// app/page.tsx - 메인 페이지
export default function Home() {
  return (
    <main className="container mx-auto p-4">
      <h1 className="text-3xl font-bold">
        환영합니다!
      </h1>
    </main>
  );
}

// app/about/page.tsx - 소개 페이지
// URL: /about
export default function About() {
  return (
    <div className="container mx-auto p-4">
      <h1>소개</h1>
      <p>저는 ...</p>
    </div>
  );
}

Tailwind CSS (빠른 스타일링)

// 자주 사용되는 클래스
<div className="
  container    // 가운데 정렬
  mx-auto      // 좌우 여백 자동
  p-4          // 패딩 16px
  text-center  // 텍스트 가운데 정렬
  text-xl      // 큰 텍스트
  font-bold    // 굵은 텍스트
  bg-blue-500  // 파란색 배경
  text-white   // 흰색 텍스트
  rounded-lg   // 둥근 모서리
  hover:bg-blue-600  // 마우스 오버 시 색상 변경
">

배포 방법

GitHub Pages (무료)

1. GitHub 저장소 생성
2. 코드 푸시
3. Settings → Pages → Source: main 브랜치
4. https://username.github.io/repo-name 에서 접속

Vercel (Next.js 권장)

1. vercel.com 가입 (GitHub 연동)
2. "New Project" → 저장소 선택
3. "Deploy" 클릭
4. URL이 자동으로 생성됨

제한 사항

❌ 로그인/회원가입 (서버 필요)
❌ 데이터 저장 (데이터베이스 필요)
❌ 관리자 페이지 (백엔드 필요)
❌ 결제 기능 (백엔드 필요)

업그레이드 시점

다음이 필요하다면 Dynamic 레벨로 이동하세요:

→ "로그인 기능이 필요해요"
→ "데이터를 저장하고 싶어요"
→ "관리자 페이지가 필요해요"
→ "사용자들이 서로 소통할 수 있게 하고 싶어요"

Starter 레벨을 위한 rkit 기능 (v1.5.1)

출력 스타일: rkit-learning (권장)

최상의 학습 경험을 위해 학습 출력 스타일을 활성화하세요:

/output-style rkit-learning

이 기능은 다음을 제공합니다:

  • 각 작업 후 학습 포인트 (무엇을 했고 왜 했는지 설명)
  • TODO(learner) 마커를 통한 직접 실습 유도
  • 초보자 난이도에 맞춘 개념 설명

에이전트 메모리 (자동 활성화)

rkit 에이전트는 세션 간 학습 진행 상황을 자동으로 기억합니다. 별도의 설정이 필요 없습니다. starter-guide 에이전트는 user 범위 메모리를 사용하므로, 다른 프로젝트에서도 학습 맥락이 유지됩니다.

에이전트 팀

Starter 레벨 프로젝트에서는 에이전트 팀을 사용할 수 없습니다. Dynamic 레벨로 업그레이드하면 2명의 팀원과 함께하는 병렬 PDCA 모드가 열립니다.


자주 하는 실수

실수해결 방법
이미지가 안 보여요경로 확인 (./images/photo.jpg)
CSS가 적용되지 않아요link 태그 경로 확인
페이지 이동이 안 돼요href 경로 확인 (./about.html)
모바일에서 깨져요<meta name="viewport"> 태그 확인

관련 스킬