vibe-repo-init

name	vibe-repo-init
description	>-

Vibe repo init (Cursor)

Role: Turn a blank (or near-blank) folder into a Cursor vibe-coding basement — runnable skeleton + Cursor project files (AGENTS.md, .cursor/rules/, .cursor/skills/) — for MCU, Linux PC, online server, HTML UI, PC UI, or hybrid mixes.

IDE assumption: Cursor (Agent, project rules, project skills, user-pack skills). Do not scaffold VS Code–only or JetBrains layouts unless the user asks.

Not this skill: full product features, SysML modeling (use SysML hubs), or deep requirements interviews (use project-planner after basement exists).

Execution contract

1. Follow pipeline_steps in order; do not write files before step 4 OK (unless user waived).
2. Confirm scope before scaffold (workflow §1): do not assume or copy unless user said mirror X.
3. Always apply references/cursor-basement.md on scaffold — .cursor/skills/ is mandatory.
4. Seed .cursor/skills/repo-context/ from assets/repo-context-skill-stub.md unless the user names a different first project skill.
5. One primary type playbook; hybrid adds secondary slices without duplicating shared root.
6. After scaffold: one clear "next vibe step" in Cursor (build/flash/run/open UI).

Type codes

Code	Meaning
mcu	Bare-metal / RTOS firmware (Pico, STM32, …)
linux-pc	Native Linux/desktop CLI or daemon
online-server	Hosted API/worker (VPS, PaaS, container)
html-ui	Browser UI (static or light web app)
pc-ui	Desktop GUI (native toolkit / Tauri / Electron-class)
hybrid	Two or more of the above (ordered)

Full taxonomy: references/repo-types.md.

Delegated skills

Skill	When
project-planner	Step 6 — requirements still fuzzy
polarfire-soc-setup	MCU/SoC path needs PolarFire kit setup
api-client-pattern	Server/client HTTP basement conventions
mcp-memnet	Persist @USR scope / @TSK init when serve up

Resources

• references/cursor-basement.md — Cursor files (rules + skills required)
• references/repo-types.md — taxonomy + hybrid rules
• references/basement-layout.md — shared tree
• references/types/ — per-type playbooks
• references/init-checklist.md
• assets/init-plan-template.md
• assets/init-report-template.md
• assets/repo-context-skill-stub.md — default project skill seed

Pairing

User-pack skills: ~/.cursor/skills/. Project skills: .cursor/skills/ (required in every scaffold). Route via SKILL-GRAPH.md / repo AGENTS.md. Memory: memnet-goldfish-loop.mdc.