P0–P2 polish: reposition as fundraising / exit-prep document#1
Merged
Conversation
The previous showcase README (Feb 26) framed GHOST as "an active-development commercial product" without articulating the path to commercialisation. Author confirmed the project sits at a fork: owner-led growth (with investment / co-founder / partnership) OR strategic acquisition / republishing. This PR repositions the showcase to work as a fundraising / exit-prep document for both paths simultaneously, while keeping the License unchanged (Commercial — All rights reserved). P0 — credibility & accuracy - Hero rewritten with Project trajectory section spelling out Path A vs Path B honestly — "open to either" - Description / topics applied via gh api after merge - Hero badges: License, Stars, Validate CI, Status, Platform, Open to discussion P1 — structural strengthening (substantial) - NEW Why GHOST? section with concrete competitor analysis: Cluely ($75/mo), Screenpipe (16K stars), Natively, Interview Hunter, Interview Coder, Final Round AI — what was taken from each, what was avoided. Tone: respectful, not aggressive. - NEW Latency target section with the streaming pipeline rationale (Silero VAD onset → streaming partial transcripts → LLM begins on partials → token output → first reply within 1–2 s). Explicitly framed as TARGET, not a measured benchmark — Phase 1 is what makes this achievable. - NEW Project status with concrete Phase-1 checklist (8 items implemented, 5 in progress) replacing the previous abstract "In Progress / Planned" - NEW What's needed to ship — honest engineering / product / business gap analysis (macOS port, code signing, auto-update, payment integration, Trial / freemium, legal review, trademark, marketing strategy) - NEW Investment thesis (3-line summary): Market / Gap / Why now - NEW How it's built — multi-agent dev workflow (Orchestrator + Coders + Tester + Documentation Agent) with cross-link to claude-code-anti- regression-setup. Positions solo-founder execution as documented process, not "force of will" - NEW Limitations section — Windows-only, beta-stage, OS-level capture exclusion is not magic - NEW Open to discussion section with explicit dual CTA (investment / partnership / acquisition) and contact channels (email, Telegram, site) - NEW Related — Claude Code ecosystem section cross-linking to all 6 sister repos by the same author (anti-regression-setup, ai-context-hierarchy, claude-statusline, notebooklm-claude-workflows, lingua-companion, diabot) - docs/architecture.svg — hand-rendered system diagram showing the actual stack (Electron 33 + React 19 + Vite + koffi for Win32 / WebSocket JSON-RPC port 9876 / Python 3.11 asyncio sidecar with Silero VAD + pyaudiowpatch + deepgram-sdk + faster-whisper + litellm Router + ChromaDB) - Tech-stack table corrected to actual versions (Electron 33+ not 32+, React 19 not 18, asyncio + websockets not FastAPI) - The invisible-overlay code example now shows the real koffi-based approach (matches local C:/ghost code), not a generic "SetWindowDisplayAffinity" pseudo-code - Author signature expanded with full name and Habr / dev.to profile links P2 — content - README.ru.md — full Russian mirror with the same structure, badges, dual CTA. Habr-audience entry point. Bug fixes - Removed broken README references to docs/TECH_STACK.md and docs/USE_CASES.md (those files never existed in this showcase repo) — content surfaced inline - Patched docs/ARCHITECTURE.md and docs/FEATURES.md footers to drop the same broken cross-refs CI - .github/workflows/validate.yml — checks LICENSE / CHANGELOG presence, examples/*.json parses as JSON, docs/*.svg is well-formed XML, every docs/* and examples/* asset referenced from README exists, all internal Markdown links resolve Excluded - Pricing / equity / valuation specifics (those belong in private discussions, not the public showcase) - Specific revenue targets / financial projections - Anything that would leak Phase-1 internal IP (commit SHAs, internal module names beyond the architectural overview) - macOS / Linux porting work (out of scope for Phase 1) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Repositions the showcase from generic "active-development commercial product" framing into a fundraising / exit-prep document that works simultaneously for two paths confirmed by the author:
Both paths need the same artefacts: honest progress map, gap analysis, competitor positioning, technical credibility, contact channels. License unchanged (Commercial — All rights reserved).
What changed
P0 — credibility & accuracy
Project trajectorysection spelling out Path A vs Path B honestlygh apiafter mergeP1 — substantial structural additions
Why GHOST?— concrete competitor analysis (Cluely $75/mo · Screenpipe 16K stars · Natively · Interview Hunter · Interview Coder · Final Round AI). What was taken from each, what was avoided. Tone: respectful, not aggressive.Latency target— explicit streaming pipeline rationale (Silero VAD onset → streaming partial transcripts → LLM begins on partials → token-by-token overlay → first reply within 1–2 s of question end). Framed as target, not a measured benchmark.Project status— Phase-1 checklist: 8 items implemented (invisible overlay, dual-source audio capture, sidecar WebSocket, EventBus, etc.), 5 in progress (Silero VAD integration, streaming pipeline, multi-document RAG, hotkey UI, perf opt). Replaces the previous abstract "In Progress / Planned".What's needed to ship— honest gap analysis: engineering (macOS / Linux ports, code signing, auto-update, installer, crash reporting, telemetry), product (onboarding polish, pricing page, payment integration, trial/freemium, support docs), business (legal review, trademark, customer support ops, marketing strategy).Investment thesis— 3-line summary: Market / Gap / Why now.How it's built— multi-agent dev workflow (Orchestrator + Coders + Tester + Documentation Agent) with cross-link to the same author'sclaude-code-antiregression-setup. Positions solo-founder execution as documented process.Limitations— Windows 10 v2004+ only, Phase-1 pre-V1.0, OS-level capture exclusion is not magic.Open to discussion— explicit dual CTA with email / Telegram / site / GitHub.Related — Claude Code ecosystem— cross-links to all 6 sister repos by the same author.docs/architecture.svg— hand-rendered diagram of the actual stack (Electron 33 + React 19 + Vite +koffifor Win32 / WebSocket JSON-RPC port 9876 / Python 3.11 asyncio sidecar with Silero VAD +pyaudiowpatch+deepgram-sdk+faster-whisper+litellmRouter + ChromaDB). Replaces the obsolete ASCII diagram.koffi-based Win32 call, not a pseudo-code stub.P2 — content
README.ru.md— full Russian mirror with same structure, badges, dual CTA.Bug fixes
docs/TECH_STACK.mdanddocs/USE_CASES.md(never existed in this repo) — content surfaced inline.docs/ARCHITECTURE.mdanddocs/FEATURES.mdfooters to drop same broken cross-refs.CI
.github/workflows/validate.yml— LICENSE / CHANGELOG presence,examples/*.jsonparses,docs/*.svgwell-formed XML, everydocs/*andexamples/*asset referenced from README exists, internal Markdown links resolve.What is deliberately NOT in this PR
Test plan
LICENSEandCHANGELOG.mdexistexamples/config.example.jsonparses as JSONdocs/architecture.svgis well-formed XMLdocs/*andexamples/*assets referenced from README existexamples/actually executable (it's a config example) — JSON validity is sufficient🤖 Generated with Claude Code