Skip to content

docs(launch): Phase 5 release-gate essay + Show HN/X copy#41

Draft
omerakben wants to merge 1 commit into
mainfrom
docs/phase5-launch
Draft

docs(launch): Phase 5 release-gate essay + Show HN/X copy#41
omerakben wants to merge 1 commit into
mainfrom
docs/phase5-launch

Conversation

@omerakben
Copy link
Copy Markdown
Owner

Draft launch material for Phase 5 of the 1000-star plan. Two new files under a new docs/blog/ directory (246 insertions, zero edits to existing files):

  • docs/blog/2026-05-ai-release-gate.md (111 lines) — the W3a R2 release-gate essay. code-oz's own gate (Codex R2, fix-first) caught release.yml building binaries before bun install, which would have failed on a clean GitHub Actions runner. Every receipt verifies against main: fix commit 1d520fe is an ancestor of main, and release.yml now has bun install (line 45) before bun build (line 66).
  • docs/blog/2026-05-launch-copy.md (135 lines) — Show HN title + first comment, an 11-tweet X thread, and community-submission copy (lobste.rs / r/programming / dev.to / newsletters). Claims are calibrated to docs/comparisons/ai-coding-agents.md, including the "keyless for Claude and Codex, xAI needs a key" honesty note. A three-lens adversarial-review trail is recorded in-file (two findings: one applied, one rejected as an inaccuracy).

Opened as a draft so the remaining human-only work happens in the diff.

Outstanding (human-only):

  • Fill the two [OZZY] voice placeholders (personal hook + closer)
  • Add B6 demo GIF + screenshots
  • Add B9 friend reactions
  • Pick a launch day
  • Apply the flagged external gpt-5.5 clarity fix to docs/comparisons/ai-coding-agents.md

Provenance: surfaced and preserved by a 23-agent branch-cleanup audit (2026-05-29). These 246 lines existed only on a local-only branch with no PR tracking it — this PR is that tracking surface. Content is complete prose; the only gaps are the human-only items above.

W3a R2 self-hosted-review essay (docs/blog/2026-05-ai-release-gate.md) and
the Show HN / X-thread / community submission copy
(docs/blog/2026-05-launch-copy.md), per 1000_STAR_PLAN.md Phase 5.1-5.4.

Every factual claim traces to a verified receipt: commit 1d520fe, Codex
thread 019e1a2c (CODEX_RESPONSE_W3A_R2.md), the ci-workflows.test.ts
ordering test, and the 3361/0 pre-fix suite. Drafts only -- nothing
published; voice, the B6 demo asset, B9 friend reactions, and launch day
are flagged for Ozzy.

Ran a three-lens adversarial pass (fact/overclaim, hostile HN reader,
writing-rules) before commit; fixes applied and the review trail recorded
in the launch-copy file.
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 30, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7b001aee-1653-4be6-aa55-b389b1555e5d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/phase5-launch

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces draft documentation and launch copy for code-oz, including a blog post detailing how a cross-family AI review gate successfully blocked a release by identifying a missing dependency installation step in the CI workflow. The review feedback suggests minor but important improvements to the code snippets within these documents, such as adding null/undefined checks to a TypeScript test snippet to prevent potential runtime errors, and simplifying redundant Homebrew installation commands.

Comment on lines +69 to +72
const installIdx = steps.findIndex((step) => /\bbun install\b/.test(step.run))
expect(installIdx).toBeGreaterThan(-1)
const buildIdx = steps.findIndex((step) => /bun build/.test(step.run))
expect(buildIdx).toBeGreaterThan(installIdx)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

In TypeScript, if step.run is optional (string | undefined), passing it directly to RegExp.prototype.test() will cause a type error under strict null checks. Additionally, if step is null or undefined, accessing step.run will throw a runtime error. It is safer to guard the access by checking step.run first.

Suggested change
const installIdx = steps.findIndex((step) => /\bbun install\b/.test(step.run))
expect(installIdx).toBeGreaterThan(-1)
const buildIdx = steps.findIndex((step) => /bun build/.test(step.run))
expect(buildIdx).toBeGreaterThan(installIdx)
const installIdx = steps.findIndex((step) => step?.run && /\bbun install\b/.test(step.run))
expect(installIdx).toBeGreaterThan(-1)
const buildIdx = steps.findIndex((step) => step?.run && /bun build/.test(step.run))
expect(buildIdx).toBeGreaterThan(installIdx)

Comment on lines +100 to +101
brew tap omerakben/code-oz
brew install omerakben/code-oz/code-oz
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The brew tap command is redundant when installing using the fully qualified formula name omerakben/code-oz/code-oz. Homebrew automatically taps the repository when the fully qualified name is provided. Alternatively, if you do tap first, you can install using the short name code-oz.

Suggested change
brew tap omerakben/code-oz
brew install omerakben/code-oz/code-oz
brew install omerakben/code-oz/code-oz

**11/ (CTA)**
> MIT. Keyless for Claude and Codex via their CLI logins; xAI needs `XAI_API_KEY`. Cross-family review needs both Claude and Codex.
> npm: `npm i -g @tuel/code-oz`
> brew: `brew tap omerakben/code-oz && brew install omerakben/code-oz/code-oz`
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The brew tap command is redundant when using the fully qualified formula name. You can simplify this to a single brew install command.

Suggested change
> brew: `brew tap omerakben/code-oz && brew install omerakben/code-oz/code-oz`
brew: brew install omerakben/code-oz/code-oz

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant