DOCS Β· RELEASE
ALL DOCS FIG. 15 Β· DWG VC-015

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

  1. 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.sh

    make semgrep is the security gate; the local pre-commit and pre-push hooks under scripts/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.

  2. 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
    • doctor remains the first verification step after install
  3. Portal truth Treat vibecrafted-io/site/src as the portal source of truth and its repo root / generated docs/ 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. Because vibecrafted-io is 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" build

    Minimum drift checks before any public launch (run from your vibecrafted-io checkout):

    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/src

    If 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.

  4. 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
  5. Marketplace order Submit in this order:

    1. There’s An AI For That
    2. Future Tools
    3. Futurepedia
    4. Toolify
    5. TopAI.tools
    6. Uneed
    7. Product Hunt
  6. 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
  7. 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

//πšŸπš’πš‹πšŽπšŒπš›πšŠπšπšπšŽπš.