claude-novice 0.2.0

package/config/bootstrap-manifests/vercel.json

@@ -0,0 +1,69 @@
+{
+  "schema_version": 1,
+  "manifest_revision": 1,
+  "reviewed_at": "2026-07-20",
+  "tier": 1,
+  "service_id": "vercel",
+  "binary": "vercel",
+  "docs_url": "https://vercel.com/docs/cli",
+  "installers": [
+    {
+      "os": ["darwin", "linux", "win32"],
+      "package_manager": "npm",
+      "package_coordinate": "vercel",
+      "argv": ["npm", "install", "--global", "vercel"],
+      "min_version": "39.0.0",
+      "global_changes": ["npm global prefix에 vercel 실행 파일 추가"]
+    },
+    {
+      "os": ["darwin"],
+      "package_manager": "homebrew",
+      "package_coordinate": "vercel-cli",
+      "argv": ["brew", "install", "vercel-cli"],
+      "min_version": "39.0.0",
+      "global_changes": ["Homebrew Cellar에 vercel-cli 설치"]
+    }
+  ],
+  "detect": {
+    "argv": ["vercel", "--version"],
+    "success": { "exit_code": 0 }
+  },
+  "version_check": {
+    "argv": ["vercel", "--version"],
+    "success": { "exit_code": 0, "stdout_regex": "\\d+\\.\\d+\\.\\d+" }
+  },
+  "auth_status": {
+    "argv": ["vercel", "whoami"],
+    "success": { "exit_code": 0 },
+    "unauthenticated": { "exit_code_not": 0 }
+  },
+  "login": {
+    "argv": ["vercel", "login"],
+    "interactive": true,
+    "user_completes": ["브라우저/이메일 인증"],
+    "success_verify": "auth_status"
+  },
+  "logout": {
+    "argv": ["vercel", "logout"]
+  },
+  "credential_store": {
+    "storage": "~/.local/share/com.vercel.cli (또는 OS별 데이터 디렉토리)의 auth.json 파일",
+    "secure_storage": false,
+    "plaintext_fallback": true,
+    "abort_auto_login_on_plaintext": false,
+    "abort_note": "Vercel CLI는 토큰을 로컬 파일로 저장한다. 파일 권한과 위치를 로그인 전 사용자에게 고지한다.",
+    "disclosure": "로그인 토큰이 홈 디렉토리 아래 auth.json에 저장된다. 'vercel logout'으로 제거할 수 있다."
+  },
+  "uninstall": {
+    "npm": ["npm", "uninstall", "--global", "vercel"],
+    "homebrew": ["brew", "uninstall", "vercel-cli"]
+  },
+  "side_effects": [
+    "전역 npm/homebrew 패키지 추가",
+    "홈 디렉토리에 CLI 설정·인증 파일 생성"
+  ],
+  "noninteractive_policy": {
+    "login": "guided_manual",
+    "reason": "vercel login은 브라우저/이메일 인증이 필요하므로 claude -p·CI에서는 안내만 한다"
+  }
+}

package/config/levels.json

@@ -0,0 +1,33 @@
+{
+  "schema_version": 1,
+  "default_level": 1,
+  "capsule_max_chars": 800,
+  "tombstone_max_chars": 300,
+  "glossary_max_chars": 5000,
+  "levels": {
+    "1": {
+      "fade_threshold": 3,
+      "term_explanation": "explain-until-fade",
+      "action_narration": "before-and-after",
+      "visualization": "steps3plus-or-branch-or-risk-or-recovery",
+      "cost_loop_intervention": "low-threshold",
+      "repeat_failure_threshold": 2
+    },
+    "2": {
+      "fade_threshold": 3,
+      "term_explanation": "explain-until-fade",
+      "action_narration": "key-decisions-only",
+      "visualization": "major-branches",
+      "cost_loop_intervention": "repeat-detected",
+      "repeat_failure_threshold": 3
+    },
+    "3": {
+      "fade_threshold": 0,
+      "term_explanation": "on-request-only",
+      "action_narration": "architecture-and-userflow",
+      "visualization": "on-request-or-risk",
+      "cost_loop_intervention": "explicit-anomaly-only",
+      "repeat_failure_threshold": 5
+    }
+  }
+}

package/config/safety-rules.json

@@ -0,0 +1,263 @@
+{
+  "schema_version": 1,
+  "reviewed_at": "2026-07-21",
+  "input_caps": {
+    "command_bytes": 65536,
+    "single_file_bytes": 1048576,
+    "total_candidate_bytes": 5242880
+  },
+  "protected_branches": {
+    "builtin": [
+      "main",
+      "master",
+      "production",
+      "release/*"
+    ],
+    "override_policy": "add-only"
+  },
+  "target_classes": [
+    "development",
+    "preview",
+    "staging",
+    "production",
+    "unknown"
+  ],
+  "target_flag_hints": {
+    "production": [
+      "--prod",
+      "--production",
+      "-e production",
+      "--env production",
+      "--environment production"
+    ],
+    "preview": [
+      "--preview",
+      "-e preview",
+      "--env preview"
+    ],
+    "staging": [
+      "-e staging",
+      "--env staging",
+      "--environment staging"
+    ]
+  },
+  "shell_rules": {
+    "rm": {
+      "deny_paths": [
+        "/",
+        "~",
+        "$HOME",
+        ".",
+        "..",
+        "*"
+      ],
+      "reason": "홈·루트·프로젝트 루트·상위 경로 삭제는 복구 불가"
+    },
+    "dangerous_commands_deny": [
+      "dd",
+      "mkfs",
+      "mkfs.ext4",
+      "mkfs.xfs",
+      "shred",
+      "diskutil"
+    ],
+    "powershell_dangerous_deny": [
+      "Format-Volume",
+      "Clear-Disk",
+      "Remove-Partition"
+    ]
+  },
+  "deploy_clis": {
+    "vercel": {
+      "destructive_verbs": {
+        "rm": {
+          "production": "deny",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "deny"
+        },
+        "remove": {
+          "production": "deny",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "deny"
+        },
+        "rollback": {
+          "production": "delegate",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "delegate"
+        }
+      },
+      "deploy_verbs": [
+        "deploy",
+        ""
+      ],
+      "secret_scan_on_deploy": true
+    },
+    "supabase": {
+      "destructive_verbs": {
+        "db reset": {
+          "production": "deny",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "deny"
+        },
+        "projects delete": {
+          "production": "deny",
+          "preview": "deny",
+          "staging": "deny",
+          "development": "deny",
+          "unknown": "deny"
+        },
+        "db push": {
+          "production": "delegate",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "delegate"
+        }
+      }
+    },
+    "gh": {
+      "destructive_verbs": {
+        "repo delete": {
+          "production": "deny",
+          "preview": "deny",
+          "staging": "deny",
+          "development": "deny",
+          "unknown": "deny"
+        },
+        "release delete": {
+          "production": "delegate",
+          "preview": "delegate",
+          "staging": "delegate",
+          "development": "delegate",
+          "unknown": "delegate"
+        }
+      }
+    }
+  },
+  "mcp_rules": {
+    "destructive_name_patterns": [
+      "delete",
+      "drop",
+      "remove",
+      "destroy",
+      "truncate",
+      "reset",
+      "purge",
+      "wipe"
+    ],
+    "action": {
+      "production": "deny",
+      "preview": "delegate",
+      "staging": "delegate",
+      "development": "delegate",
+      "unknown": "deny"
+    }
+  },
+  "secret_patterns": [
+    {
+      "id": "aws-access-key-id",
+      "pattern": "\\bAKIA[0-9A-Z]{16}\\b",
+      "description": "AWS Access Key ID"
+    },
+    {
+      "id": "aws-secret-access-key",
+      "pattern": "(?i)aws[_-]?secret[_-]?access[_-]?key\\s*[:=]\\s*['\"]?[A-Za-z0-9/+=]{40}",
+      "description": "AWS Secret Access Key 할당"
+    },
+    {
+      "id": "github-token",
+      "pattern": "\\b(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9]{36,255}\\b",
+      "description": "GitHub token"
+    },
+    {
+      "id": "github-fine-grained-pat",
+      "pattern": "\\bgithub_pat_[A-Za-z0-9_]{22,255}\\b",
+      "description": "GitHub fine-grained PAT"
+    },
+    {
+      "id": "slack-token",
+      "pattern": "\\bxox[baprs]-[A-Za-z0-9-]{10,250}\\b",
+      "description": "Slack token"
+    },
+    {
+      "id": "stripe-secret-key",
+      "pattern": "\\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9]{24,247}\\b",
+      "description": "Stripe secret key"
+    },
+    {
+      "id": "openai-api-key",
+      "pattern": "\\bsk-[A-Za-z0-9_-]{20,}T3BlbkFJ[A-Za-z0-9_-]{20,}\\b",
+      "description": "OpenAI API key"
+    },
+    {
+      "id": "anthropic-api-key",
+      "pattern": "\\bsk-ant-[A-Za-z0-9_-]{24,}\\b",
+      "description": "Anthropic API key"
+    },
+    {
+      "id": "google-api-key",
+      "pattern": "\\bAIza[0-9A-Za-z_-]{35}\\b",
+      "description": "Google API key"
+    },
+    {
+      "id": "private-key-block",
+      "pattern": "-----BEGIN (?:RSA |EC |DSA |OPENSSH |PGP )?PRIVATE KEY(?: BLOCK)?-----",
+      "description": "PEM private key block"
+    },
+    {
+      "id": "jwt",
+      "pattern": "\\beyJ[A-Za-z0-9_-]{10,}\\.[A-Za-z0-9_-]{10,}\\.[A-Za-z0-9_-]{10,}\\b",
+      "description": "JWT"
+    },
+    {
+      "id": "supabase-service-role-hint",
+      "pattern": "(?i)service[_-]?role[_-]?key\\s*[:=]\\s*['\"]?eyJ[A-Za-z0-9_.-]{20,}",
+      "description": "Supabase service role key 할당"
+    },
+    {
+      "id": "generic-assignment",
+      "pattern": "(?i)\\b(?:api[_-]?key|secret|token|passwd|password|credential)s?\\b\\s*[:=]\\s*['\"]([A-Za-z0-9/+_=-]{20,})['\"]",
+      "description": "고엔트로피 비밀값 할당 (entropy 보조 판정 대상)",
+      "entropy_check": true
+    }
+  ],
+  "entropy": {
+    "min_length": 20,
+    "shannon_threshold": 3.5,
+    "placeholder_allowlist": [
+      "(?i)^(?:x+|0+|1234|test|example|sample|dummy|placeholder|your[_-]|changeme|redacted|<[^>]+>|\\$\\{[^}]+\\}|%[A-Z_]+%)",
+      "(?i)(?:example|sample|dummy|placeholder|fixture|fake)"
+    ]
+  },
+  "scan_file_extensions_skip": [
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".webp",
+    ".ico",
+    ".pdf",
+    ".zip",
+    ".gz",
+    ".tar",
+    ".mp4",
+    ".mp3",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".eot"
+  ],
+  "scan_path_skip": [
+    "tests/fixtures/",
+    "test/fixtures/",
+    "__fixtures__/"
+  ]
+}

package/config/service-capabilities.json

@@ -0,0 +1,51 @@
+{
+  "schema_version": 1,
+  "reviewed_at": "2026-07-20",
+  "capability_priority": ["cli", "mcp", "chrome", "guided_manual"],
+  "downgrade_rules": {
+    "cli": "Tier 1 preflight 실패 또는 사용자가 CLI 설치를 거부하면 mcp로 낮춘다. Tier 2 CLI는 사용자가 근거 확인 후 명시 동의(confirmed_by_user)한 경우 사용",
+    "mcp": "정적 allowlist 정확 일치(+verified provenance) 또는 런타임 등록 서버+명시 동의가 아니면 chrome으로 낮춘다",
+    "chrome": "Claude in Chrome 미연결·제3자 provider 환경이면 guided_manual로 낮춘다"
+  },
+  "mcp_user_consent_note": "정적 allowlist 외에, 사용자가 Claude runtime에 등록한 서버(registered)이고 이번 작업에 명시 동의(userConsent)한 경우 동의한 tool 범위 안에서 허용한다. 자동 설치는 하지 않으며 PreToolUse 게이트가 계속 적용된다.",
+  "mcp_allowlist_entry_schema": {
+    "service_id": "서비스 식별자 (services 키와 일치)",
+    "server": "runtime에서 식별되는 MCP server 이름 (mcp__<server>__ 접두사의 <server>)",
+    "transport": "stdio | http | sse",
+    "publisher": "공식 배포자 신원 (provenance 대조용)",
+    "docs_url": "https 공식 근거",
+    "tools": ["자동 실행을 허용하는 tool base name 목록"],
+    "capabilities": ["이 MCP가 담당할 capability (bootstrap 등)"]
+  },
+  "mcp_allowlist": [],
+  "chrome_policy": {
+    "mode": "visible-only",
+    "user_completes": ["login", "captcha", "mfa", "final-submit"]
+  },
+  "services": {
+    "vercel": {
+      "capabilities": {
+        "bootstrap": "cli",
+        "provisioning": "guided_manual",
+        "env_setup": "guided_manual",
+        "deploy": "guided_manual"
+      },
+      "manifest": "bootstrap-manifests/vercel.json"
+    },
+    "github": {
+      "capabilities": {
+        "bootstrap": "cli",
+        "oauth_app_setup": "guided_manual"
+      },
+      "manifest": "bootstrap-manifests/github-cli.json"
+    },
+    "supabase": {
+      "capabilities": {
+        "bootstrap": "cli",
+        "provisioning": "guided_manual",
+        "db_admin": "guided_manual"
+      },
+      "manifest": "bootstrap-manifests/supabase.json"
+    }
+  }
+}

package/config/terms.json

@@ -0,0 +1,198 @@
+{
+  "schema_version": 1,
+  "reviewed_at": "2026-07-20",
+  "terms": [
+    {
+      "term": "repository",
+      "explanation": "프로젝트의 모든 파일과 변경 기록을 담는 저장소",
+      "aliases": ["repo", "저장소", "리포지토리", "레포"],
+      "category": "git"
+    },
+    {
+      "term": "commit",
+      "explanation": "현재 변경을 하나의 저장 지점으로 기록하는 것",
+      "aliases": ["커밋"],
+      "category": "git"
+    },
+    {
+      "term": "branch",
+      "explanation": "원본을 건드리지 않고 변경을 시도할 수 있는 독립 작업 줄기",
+      "aliases": ["브랜치"],
+      "category": "git"
+    },
+    {
+      "term": "merge",
+      "explanation": "두 작업 줄기의 변경 내용을 하나로 합치는 것",
+      "aliases": ["머지", "병합"],
+      "category": "git"
+    },
+    {
+      "term": "push",
+      "explanation": "내 컴퓨터의 저장 기록을 원격 저장소로 올리는 것",
+      "aliases": ["푸시", "푸쉬"],
+      "category": "git"
+    },
+    {
+      "term": "pull",
+      "explanation": "원격 저장소의 최신 변경을 내 컴퓨터로 가져오는 것",
+      "aliases": ["풀"],
+      "category": "git"
+    },
+    {
+      "term": "clone",
+      "explanation": "원격 저장소 전체를 내 컴퓨터로 복제하는 것",
+      "aliases": ["클론", "복제"],
+      "category": "git"
+    },
+    {
+      "term": ".gitignore",
+      "explanation": "Git이 추적하지 않을 파일 목록을 적어 두는 설정 파일",
+      "aliases": ["깃이그노어", "gitignore"],
+      "category": "git"
+    },
+    {
+      "term": "terminal",
+      "explanation": "글자로 명령을 입력해 컴퓨터를 조작하는 창",
+      "aliases": ["터미널", "콘솔", "console"],
+      "category": "terminal"
+    },
+    {
+      "term": "CLI",
+      "explanation": "마우스 대신 명령어 문장으로 프로그램을 다루는 방식",
+      "aliases": ["command line", "커맨드라인", "명령줄"],
+      "category": "terminal"
+    },
+    {
+      "term": "shell",
+      "explanation": "터미널에서 입력한 명령을 해석해 실행하는 프로그램",
+      "aliases": ["셸", "쉘", "bash", "zsh"],
+      "category": "terminal"
+    },
+    {
+      "term": "directory",
+      "explanation": "파일을 묶어 두는 폴더",
+      "aliases": ["디렉토리", "디렉터리", "폴더", "folder"],
+      "category": "terminal"
+    },
+    {
+      "term": "path",
+      "explanation": "파일이나 폴더가 있는 위치를 나타내는 주소",
+      "aliases": ["경로", "패스"],
+      "category": "terminal"
+    },
+    {
+      "term": "working directory",
+      "explanation": "지금 명령이 실행되는 기준 폴더",
+      "aliases": ["작업 디렉토리", "현재 디렉토리", "cwd"],
+      "category": "terminal"
+    },
+    {
+      "term": "frontend",
+      "explanation": "사용자가 화면에서 직접 보고 누르는 부분",
+      "aliases": ["프론트엔드", "프론트", "front-end"],
+      "category": "web"
+    },
+    {
+      "term": "backend",
+      "explanation": "화면 뒤에서 데이터 처리와 규칙을 담당하는 부분",
+      "aliases": ["백엔드", "백앤드", "back-end"],
+      "category": "web"
+    },
+    {
+      "term": "API",
+      "explanation": "프로그램끼리 정해진 형식으로 요청과 응답을 주고받는 창구",
+      "aliases": ["에이피아이"],
+      "category": "web"
+    },
+    {
+      "term": "framework",
+      "explanation": "앱의 뼈대와 규칙을 미리 제공하는 개발 도구 묶음",
+      "aliases": ["프레임워크", "프레임웍"],
+      "category": "web"
+    },
+    {
+      "term": "server",
+      "explanation": "요청을 받아 데이터나 화면을 돌려주는 컴퓨터 또는 프로그램",
+      "aliases": ["서버"],
+      "category": "web"
+    },
+    {
+      "term": "localhost",
+      "explanation": "내 컴퓨터 안에서만 접속되는 개발용 주소",
+      "aliases": ["로컬호스트", "로컬 서버", "127.0.0.1"],
+      "category": "web"
+    },
+    {
+      "term": "database",
+      "explanation": "데이터를 구조적으로 저장하고 찾아 쓰는 창고",
+      "aliases": ["데이터베이스", "DB", "디비"],
+      "category": "database"
+    },
+    {
+      "term": "schema",
+      "explanation": "데이터를 어떤 형태와 규칙으로 저장할지 정한 설계도",
+      "aliases": ["스키마"],
+      "category": "database"
+    },
+    {
+      "term": "migration",
+      "explanation": "데이터베이스 구조 변경을 기록하고 순서대로 적용하는 것",
+      "aliases": ["마이그레이션"],
+      "category": "database"
+    },
+    {
+      "term": "query",
+      "explanation": "데이터베이스에 데이터를 요청하거나 변경하는 명령문",
+      "aliases": ["쿼리"],
+      "category": "database"
+    },
+    {
+      "term": "OAuth",
+      "explanation": "비밀번호를 넘기지 않고 다른 서비스 계정으로 로그인 권한을 빌려주는 방식",
+      "aliases": ["오어스", "소셜 로그인"],
+      "category": "database"
+    },
+    {
+      "term": "token",
+      "explanation": "로그인 상태나 권한을 증명하는 임시 출입증 문자열",
+      "aliases": ["토큰", "액세스 토큰", "access token"],
+      "category": "database"
+    },
+    {
+      "term": "deploy",
+      "explanation": "만든 앱을 다른 사람이 쓸 수 있게 서버에 올리는 것",
+      "aliases": ["배포", "디플로이"],
+      "category": "deploy"
+    },
+    {
+      "term": "preview deployment",
+      "explanation": "정식 공개 전에 변경 내용을 미리 확인하는 임시 배포",
+      "aliases": ["프리뷰 배포", "미리보기 배포", "preview"],
+      "category": "deploy"
+    },
+    {
+      "term": "production",
+      "explanation": "실제 사용자가 쓰는 운영 환경",
+      "aliases": ["프로덕션", "운영 환경", "prod", "실서비스"],
+      "category": "deploy"
+    },
+    {
+      "term": "environment variable",
+      "explanation": "코드 밖에서 주입하는 설정값으로, 환경마다 다르게 지정할 수 있다",
+      "aliases": ["환경변수", "환경 변수", "env", "env var"],
+      "category": "deploy"
+    },
+    {
+      "term": "secret",
+      "explanation": "API 키나 비밀번호처럼 외부에 노출되면 안 되는 비밀값",
+      "aliases": ["시크릿", "비밀값", "API 키", "api key"],
+      "category": "deploy"
+    },
+    {
+      "term": "build",
+      "explanation": "작성한 코드를 실행 가능한 형태로 변환하고 묶는 과정",
+      "aliases": ["빌드"],
+      "category": "deploy"
+    }
+  ]
+}