Release Kickoff
This is the pre-release operator sheet for π ππππππππππ.
Synced β 2026-05-12
source: docs/RELEASE_KICKOFF.md
Release Kickoff
This is the pre-release operator sheet for π ππππππππππ.
Rule zero: do not let the repo, installer, portal, and marketplace copy disagree about what the product is.
One-line truth
- Product: π ππππππππππ.
- Promise: Release engine for AI-built software.
- Primary CTA:
curl -fsSL https://vibecrafted.io/install.sh | bash -s -- --gui - Secondary CTA:
curl -fsSL https://vibecrafted.io/install.sh | bash - Human front door: browser-guided installer, chosen for TwinSweep-style effortlessness.
- Automation path: compact CLI installer, still available for scripts and CI.
- Adjacent pattern kept for inspiration, not as the public front door:
rmcp-memex-style wizard/TUI.
Positioning guardrails
- Do not pitch Vibecrafted as another code generator.
- Do not pitch it as an IDE replacement or pair-programmer shell alone.
- Do pitch it as the post-generation layer: the thing you run after agents have already produced the repo and before a stranger touches it.
- Adjacent tools such as Cursor, Windsurf, Cline, Devin, Lovable, and Bolt help write or generate software. Vibecrafted hardens, packages, verifies, and prepares that software to ship.
Kickoff checklist
-
Repo truth Run the pre-release gates from this repo:
make bundle-check make check make test make semgrep env -u ZELLIJ -u ZELLIJ_PANE_ID -u ZELLIJ_SESSION_NAME -u VIBECRAFTED_OPERATOR_SESSION bash scripts/check-portable.shmake semgrepis the security gate; the local pre-commit and pre-push hooks underscripts/hooks/run the same invocation, so a green hook on the release commit gives the same answer as the gate. Any blocking finding must be fixed, accepted in writing inside the release report, or deferred with a tracked follow-up β no silent skips. -
Installer truth Confirm every public install surface keeps the same contract:
- guided GUI path is the first CTA for humans
- compact path stays available for automation
doctorremains the first verification step after install
-
Portal truth Treat
vibecrafted-io/site/srcas the portal source of truth and its repo root / generateddocs/files as the deploy mirror. Rebuild and redeploy that mirror before launch if any derived file still advertises the old direct-only install path or the older self-referential promise. The homepage, quickstart, FAQ,install.sh, and README must all match the release-engine narrative and the guided installer CTA. Becausevibecrafted-iois a separate git root, treat its build/deploy pass as a separate lane from this repo commit. Minimum rebuild command:pnpm --dir "<vibecrafted-io-checkout>/site" buildMinimum drift checks before any public launch (run from your
vibecrafted-iocheckout):rg -n "Interactive terminals always enter the installer TUI|curl -fsSL https://vibecrafted.io/install.sh \\| bash$" \ README.md \ docs/install.sh \ docs/QUICK_START.md \ site/srcIf that grep still finds old TUI-only or direct-only wording in the portal repo root / built
docs/, the deploy mirror is stale and launch should pause until that separate lane is rebuilt and redeployed. -
Asset truth Capture and store these before submission day:
- guided installer screenshot
- command deck screenshot
- quickstart screenshot
- marbles / convergence screenshot
- landing-page hero screenshot
- one short walkthrough video
-
Marketplace order Submit in this order:
- Thereβs An AI For That
- Future Tools
- Futurepedia
- Toolify
- TopAI.tools
- Uneed
- Product Hunt
-
Uneed dry run Treat Uneed as the softer rehearsal launch once AI-directory listings are already live:
- use the guided installer screenshot as the hero asset
- keep the explanation founder-readable, not taxonomy-heavy
- watch which screenshot / blurb combination gets the cleanest conversion
-
Product Hunt day Do not schedule Product Hunt until:
- the maker posting account has Product Hunt post access
- the founder comment is prewritten
- the portal and installer are both ready for real strangers
- someone is available to answer comments for the full launch window
Release report contract
Every release run produces a report under
$VIBECRAFTED_ROOT/.vibecrafted/artifacts/<org>/<repo>/<YYYY_MMDD>/reports/
that follows the canonical template at
skills/vc-release/references/release-report-template.md.
The four mandatory sections β security gate, exposed surface inventory,
deployment mode decision, and post-release install smoke from the
published artefact β are non-negotiable. A release without all four
sections populated is blocked, not βalmost done.β
Supporting docs
- Quick Start
- Marketplace Listing
- Submission Forms
- Installer Reference
- Release Report Template
- Deployment Reality Matrix
//πππππππππππ.