English | 中文

A one-command engineering baseline generator for vibecoding projects. Stop losing context between AI sessions — this skill sets up governance files, test scaffolds, git discipline, and a session handoff protocol so every new conversation picks up right where you left off.

Vibecoding beginners hit the same walls:

• Have ideas and architecture docs, but don't know how to set up a proper project structure
• Don't know git — break something, can't roll back
• Switch conversations, AI forgets all prior progress
• Rules and decisions only live in chat history, never written down

1. Generates an engineering skeleton — directories, baseline docs, test entry points
2. Built-in session entry protocol — every new AI session reads progress / memory / index before touching code
3. Beginner-friendly git rhythm — commit after every session, tag milestones, rollback guide
4. Self-check mode (--mode check) — see what's set up and what's missing

After running, your repo gets:

AGENTS.md                              # Long-term repo rules + session entry protocol
README.md                              # Project entry point with new-session guide
CHANGELOG.md                           # Version history
.gitignore                             # Stack-specific ignores
docs/
├── progress.md                        # Cross-session progress sync
├── project_memory.md                  # Long-term memory (pitfalls, constraints)
├── PROJECT_INDEX.md                   # Directory responsibilities & dependency map
├── TEST_MATRIX.md                     # Human-readable test descriptions
├── engineering/engineering-playbook.md # Engineering workflow norms
├── runbooks/git-remote-setup.md       # Git guide for beginners
└── adr/ADR-0001-engineering-baseline.md

Python projects also get pyproject.toml, Makefile, and test stubs based on your chosen test profile.

# Clone or copy the skill into your project
cp -r vibecoding-bootstrap/.  your-project/.agents/skills/bootstrap-project/

# Run
python3 .agents/skills/bootstrap-project/scripts/bootstrap_project.py \
  --root "$PWD" \
  --project-name "My Project" \
  --arch-doc "docs/architecture.md"

# Self-check (no writes)
python3 .agents/skills/bootstrap-project/scripts/bootstrap_project.py \
  --root "$PWD" --mode check

This skill works with Claude Code, Codex CLI, and Gemini CLI. See Installation below.

mkdir -p .claude/skills
cp -r claude-code/ .claude/skills/bootstrap-project/
cp -r scripts/ .claude/skills/bootstrap-project/scripts/
cp -r references/ .claude/skills/bootstrap-project/references/

Or symlink for shared use:

mkdir -p .claude/skills
ln -s "$(pwd)" .claude/skills/bootstrap-project

mkdir -p .agents/skills
cp -r codex/ .agents/skills/bootstrap-project/
cp -r scripts/ .agents/skills/bootstrap-project/scripts/
cp -r references/ .agents/skills/bootstrap-project/references/

Call the script directly and pass the SKILL.md content as context:

python3 scripts/bootstrap_project.py --root "$PWD" --project-name "My Project"

• Python >= 3.8 (no third-party dependencies)
• git (only needed for --mode check)

MIT

一条命令生成 vibecoding 项目的工程基线。不再因为换会话丢上下文 —— 这个 skill 帮你建好治理文件、测试脚手架、git 纪律和会话交接协议，让每次新对话都能无缝接续。

vibecoding 新手的典型卡点：

• 有想法、有架构文档，但不知道怎么起步建工程目录
• 不懂 git，改崩了不知道怎么回滚
• 换了一次对话，AI 就忘了之前的进度
• 规范只存在于聊天里，下次又要重新讲一遍

1. 一次命令生成工程骨架 — 目录 + 基线文档 + 测试入口
2. 内置会话开场协议 — 任何新会话的 AI 都先读 progress / memory / index
3. 新手友好的 git 节奏 — 每次对话结束三件事、回滚指南、打 tag
4. 自检模式 (--mode check) — 随时看"我哪里还没搞好"

运行后你的仓库会多出：

AGENTS.md                              # 仓库长期规则 + 会话开场协议
README.md                              # 项目入口 + 新会话引导
CHANGELOG.md                           # 版本变化
.gitignore                             # 按技术栈生成
docs/
├── progress.md                        # 跨会话进度同步
├── project_memory.md                  # 长期记忆（踩过的坑、关键约束）
├── PROJECT_INDEX.md                   # 目录职责与依赖方向
├── TEST_MATRIX.md                     # 人可读测试说明
├── engineering/engineering-playbook.md # 工程工作规范
├── runbooks/git-remote-setup.md       # 新手 git 完整指南
└── adr/ADR-0001-engineering-baseline.md

Python 项目还会生成 pyproject.toml、Makefile 和对应档位的测试桩。

# 把 skill 复制到你的项目
cp -r vibecoding-bootstrap/. your-project/.agents/skills/bootstrap-project/

# 运行
python3 .agents/skills/bootstrap-project/scripts/bootstrap_project.py \
  --root "$PWD" \
  --project-name "我的项目" \
  --arch-doc "docs/架构蓝图.md"

# 自检（不写文件）
python3 .agents/skills/bootstrap-project/scripts/bootstrap_project.py \
  --root "$PWD" --mode check

本 skill 兼容 Claude Code、Codex CLI、Gemini CLI。安装方式见上方英文部分的 Installation。

• Python >= 3.8（无第三方依赖）
• git（仅 --mode check 需要）

MIT