setup

Bootstraps the gener8v pipeline by creating .gener8v directories, conventions, state file, and CLAUDE.md directives.

3|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/gener8v/gener8v.claude-skills --skill setup-gener8v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/gener8v/gener8v.claude-skills/tree/main/skills/setup
Command: npx skills add https://github.com/gener8v/gener8v.claude-skills --skill setup-gener8v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Onboarding a project to the gener8v pipeline requires a specific directory structure, shared conventions, a generated pipeline-state.yaml, and CLAUDE.md directives; doing this by hand is error-prone and inconsistent. This Skill performs the entire bootstrap deterministically and idempotently, so re-running it after a plugin upgrade refreshes only what Setup owns without touching existing artifacts. ## Core Features & Use Cases - Directory scaffolding: Creates the nine .gener8v/ subdirectories (specifications, constraints, dependencies, technical-design, changes, reviews, audits, flows, sweeps) only where missing, leaving existing files untouched. - Conventions and state installation: Copies CONVENTIONS.md from references and generates pipeline-state.yaml via scripts/gener8v-state.py, with a handwritten fallback format when the script is unavailable under a copied install. - CLAUDE.md patching: Creates, appends, or replaces the ## gener8v Pipeline section in place without duplicating it or altering any other content. - Use Case: After upgrading the gener8v plugin, re-run setup on an already-onboarded project to refresh CONVENTIONS.md and the CLAUDE.md section while preserving every PRD, specification, and change artifact. ## Quick Start Ask the AI to set up the gener8v pipeline in this project so it creates the .gener8v structure and updates CLAUDE.md.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the gener8v pipeline in a project?▼

Run the setup skill from the project root. It creates the .gener8v directory structure, copies CONVENTIONS.md, generates pipeline-state.yaml, and adds a gener8v Pipeline section to CLAUDE.md, then recommends Planning for greenfield or Brownfield for existing code.

Is it safe to re-run gener8v setup on an existing project?▼

Yes, setup is idempotent and non-destructive. If .gener8v/prd.md already exists it refreshes only the conventions, the CLAUDE.md section, and missing directories, leaving all artifacts, standalone sweeps, flows, and legacy layouts untouched.

Why does the gener8v-state.py state command fail with No such file?▼

That failure means a copied install rather than the plugin, so ${CLAUDE_PLUGIN_ROOT} is not substituted and the script path collapses. Write the fallback pipeline-state.yaml by hand in the documented format; Orchestrate maintains it manually from then on.

What happens to my custom edits in the CLAUDE.md gener8v Pipeline section?▼

Setup replaces the entire gener8v Pipeline section wholesale on every run, so local edits inside it are lost by design. Recover them from git and keep customizations under a separate heading outside that section.

When should I use orchestrate instead of setup?▼

Use orchestrate when the project is already on the pipeline, meaning .gener8v/prd.md exists, and you want status, metrics, and next steps. Setup is only for initial bootstrap or refreshing conventions after a plugin upgrade.