Drop one file. Tell your AI to read it. Done.

A single 7,000-line markdown bootstrap that turns Claude Code, ChatGPT Codex CLI, Cursor, and GitHub Copilot into a disciplined teammate — 13-section rules, 5 safety hooks, session-resume, dual-write memory, and bilingual GitHub files. Zero install. One source of truth.

# Fetch the bootstrap file
curl -fsSL https://raw.githubusercontent.com/kernalix7/ai-project-setup/main/AI_PROJECT_SETUP.md > AI_PROJECT_SETUP.md

# Open your AI tool, then say:
#   "Read AI_PROJECT_SETUP.md and execute it."
#   "AI_PROJECT_SETUP.md 읽고 실행해줘"

# 1–3 minutes later, verify:
./tmp-igbkp/verify-setup.sh   # → Pass: 83  Fail: 0  Warn: 0

Works with

_{English  ·  한국어  ·  Setup file  ·  Contributing  ·  Security  ·  Changelog}

curl -fsSL https://raw.githubusercontent.com/kernalix7/ai-project-setup/main/AI_PROJECT_SETUP.md \
  > AI_PROJECT_SETUP.md

claude       # or: codex, cursor ., or VS Code with Copilot

./tmp-igbkp/verify-setup.sh
# → Pass: 83  Fail: 0  Warn: 0 — All required checks passed

your-project/
|-- CLAUDE.md              -> symlink to .priv-storage/CLAUDE.md
|-- AGENTS.md              -> symlink to .priv-storage/CLAUDE.md   # Codex / Copilot
|-- .cursorrules           -> symlink to .priv-storage/CLAUDE.md   # Cursor
|-- WORK_STATUS.md         -> current work state (project content)
|
|-- .priv-storage/         [gitignored] all AI tooling lives here
|   |-- CLAUDE.md                   # 13-section project rules (~10kB cap)
|   |-- CLAUDE.local.md             # per-developer overrides
|   |-- POST_SETUP_INDEX.md         # 50-line pointer (saves ~25k tokens/session)
|   |-- AI_PROJECT_SETUP.md         # archived, never re-read
|   |-- memory/                     # dual-written to ~/.claude/projects/ (cross-machine sync)
|   |-- sessions/                   # current.md, handoff-{date}.md, recovery.md, read-log.tsv
|   `-- .claude/
|       |-- settings.json           # statusLine + 5 hooks + outputStyle
|       |-- hooks/                  # PreToolUse / PostToolUse / SessionStart / PreCompact / Stop
|       |-- agents/                 # tech-lead, explorer, code-reviewer, log-analyzer
|       |-- commands/               # 10+ slash commands
|       |-- skills/ and rules/      # on-demand knowledge
|       |-- output-styles/terse.md
|       `-- statusline              # context percent / rate-limit ETA
|
|-- tmp-igbkp/             [gitignored] backup and verification toolkit (9 scripts)
|   |-- verify-setup.sh             # one-command health check (83+ assertions)
|   |-- smoke-test-hooks.sh         # mock-payload hook validation
|   |-- secret-guard.sh             # 14-pattern pre-commit scanner
|   |-- archive.sh / restore.sh     # AES-256-CBC + PBKDF2 600k iterations
|   |-- purge-history.sh            # git-filter-repo wrapper
|   |-- setup-worktree.sh           # bridges worktrees to main .priv-storage/
|   |-- codex-relay-{check,run}.sh  # Claude <-> Codex parallel lanes
|   `-- uninstall.sh                # safe rollback with backup
|
|-- .mcp.json              [gitignored] MCP server registry (env-var refs only)
|
|-- README.md, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md
|-- docs/{README,SECURITY,CONTRIBUTING,CODE_OF_CONDUCT,CHANGELOG}.ko.md
`-- .github/{ISSUE_TEMPLATE/,PULL_REQUEST_TEMPLATE.md}

[1. INITIAL SETUP]
  Prompt: "Read AI_PROJECT_SETUP.md and execute it."
  - Auto-detects Scenario A/B/C
  - Creates everything above, then runs STEP 6
  - Archives AI_PROJECT_SETUP.md into .priv-storage/
  - Prints "Setup Complete" only if automode-validate.sh passes

        |
        v

[2. NORMAL SESSIONS]
  - SessionStart hook injects last handoff + current.md tail
  - AI reads CLAUDE.md (~200 lines) + POST_SETUP_INDEX.md (~50)
  - Does not re-read the 7000-line setup file, saving ~25k tokens/session
  - PreToolUse blocks dangerous commands + oversized Reads
  - PostToolUse appends to current.md + dual-writes memory
  - Stop hook writes handoff-{date}.md
  - PreCompact hook writes recovery.md (best-effort)

        |
        v

[3. CRASH / RATE-LIMIT / /clear]
  - Next session: SessionStart auto-loads handoff + recovery
  - AI resumes without "where were we?" questions

        |
        v

[4. SELF-UPDATE]
  Trigger: "update setup" or Korean "AI_PROJECT_SETUP 업데이트해"
  - Fetches latest from GitHub raw URL
  - Replaces archived setup file
  - Force-overwrites all 30+ shipped scripts with .bak backup
  - Re-runs automode-validate gate
  - Reports: "Updated: vOLD -> vNEW. Recommend /clear."