# SoloBrief — Full System, Architecture, and Product Specification Canonical URL: https://solobrief.hk-bizflow.com LLM Context Index: https://solobrief.hk-bizflow.com/llms.txt --- ## 1. Product Identity & Entity Definition SoloBrief is a web-based client intake workflow engine and automated Scope of Work (SOW) generator built specifically for freelancers, boutique creative studios, and solo digital service providers. Unlike traditional form builders (e.g., Google Forms, Typeform, Jotform) which passively record text without understanding client ambiguity, SoloBrief actively intervenes in the client intake process. It features a real-time ambiguity parser that detects subjective buzzwords (e.g., "make it pop", "clean", "ASAP", "etc.") and guides clients to select objective parameters (style presets, specific milestone dates, itemized checklists, and quantitative targets) before submission. Upon submission, SoloBrief compiles client answers into an editable, print-ready Scope of Work (SOW) proposal containing deliverables, scope boundaries, out-of-scope exclusions, assumptions, and milestone timelines. The workflow concludes with dual digital signatures (freelancer and client), upfront Stripe deposit collection, and Calendly kickoff scheduling in a single automated pipeline. --- ## 2. The Core Problem Solved: Eliminating Scope Creep and Vague Briefs ### The Discovery Trap Freelancers frequently spend 5 to 15 unbillable hours per project chasing clients for clear design specs, requirements, and brand guidelines. Vague client requests such as "make it look aesthetic and modern" lead to endless visual revisions, misaligned expectations, and uncompensated scope creep. ### The Fragmented Toolchain Traditionally, a freelancer must stitch together: 1. A form builder (Typeform / Google Forms) for the brief. 2. An email thread or Slack channel to clarify vague inputs. 3. A Google Doc / Word document to manually draft a Scope of Work. 4. An electronic signature tool (DocuSign / PandaDoc) for client sign-off. 5. An invoice / payment link (Stripe / PayPal) for upfront deposits. 6. A calendar scheduler (Calendly) for kickoff booking. SoloBrief combines this entire chain into a single, unified intake-to-kickoff pipeline. --- ## 3. Key Feature Specifications ### 3.1 Niche Vertical Intake Presets SoloBrief provides battle-tested questionnaires pre-loaded with required word counts, specialized questions, and default Scope of Work clauses tailored for 5 core verticals: 1. **Webflow & Website Development** - Questions: Site architecture, CMS collections, third-party integrations (Zapier, Memberstack, Airtable), design assets availability, target launch date. - SOW Defaults: Cross-browser testing, mobile responsiveness, custom code constraints, CMS training, 30-day bug warranty. - Out-of-Scope: Copywriting, logo redesign, post-launch hosting administration, ongoing SEO retainer. 2. **Brand Identity Design** - Questions: Target audience demographics, primary brand values, competitor differentiation, aesthetic dislikes, deliverable formats. - SOW Defaults: Primary logo, secondary mark, color palette, typography hierarchy, comprehensive brand guidelines PDF. - Out-of-Scope: Font licensing fees, physical merchandise production, trademark legal registration, packaging design. 3. **SEO Strategy & Content Marketing** - Questions: Organic growth goals, existing technical roadblocks, target search geography, primary competitors, CMS platform. - SOW Defaults: Technical site audit, keyword research & topic clustering, on-page optimization checklist, 60-day roadmap. - Out-of-Scope: Paid media / Google Ads management, backlinks purchasing, full-scale copywriting unless explicitly added. 4. **Email Marketing & Automations** - Questions: Email service provider (Klaviyo, Mailchimp), list size & segmentation, flow priorities (welcome series, abandoned cart, winback), brand tone. - SOW Defaults: Template wireframing, responsive HTML coding, merge tag logic, deliverability verification. - Out-of-Scope: Dedicated IP warming, graphic illustration from scratch, cold outreach / spam scraping. 5. **UX Research & Product Strategy** - Questions: User problem statement, existing user data/analytics, target persona access, core user journey bottlenecks. - SOW Defaults: 5 user interviews, qualitative synthesis report, usability test protocol, prioritized Figma recommendations. - Out-of-Scope: Full frontend engineering, design system overhaul, continuous user testing retainers. 6. **Custom Builder** - Freelancers can construct completely custom intake forms with customizable short-text and long-text inputs with enforced minimum word counts. ### 3.2 Real-Time Client Ambiguity Detection Engine As the client types into long-form question fields, SoloBrief evaluates text using pattern-matching heuristic rules across 4 ambiguity categories: - **Style Ambiguity**: - Triggers: "make it pop", "clean", "modern", "aesthetic", "sleek", "fresh", "high-end", "sexy", "catchy". - Client Resolution: Prompts client to choose between concrete style directions (e.g., "Vibrant & Bold", "Minimalist & Sleek", "Editorial & Classic", "Playful & Colorful"). - **Timeline Ambiguity**: - Triggers: "asap", "soon", "yesterday", "quick", "as soon as possible", "right away". - Client Resolution: Prompts client to pick an exact target delivery date from a date picker. - **Scope Ambiguity**: - Triggers: "etc", "and so on", "whatever you think", "a few pages", "some tweaks", "all inclusive". - Client Resolution: Prompts client to check specific items in an explicit deliverables checklist. - **Metrics Ambiguity**: - Triggers: "go viral", "scale fast", "huge engagement", "tons of traffic", "double our sales". - Client Resolution: Prompts client to establish specific numerical benchmarks and primary KPI types. All resolutions are recorded and displayed side-by-side with the client's raw response in the freelancer's dashboard. ### 3.3 Scope of Work (SOW) Proposal Compiler - Compiles client inputs into standard contractual sections: - Executive Summary & Project Objectives - Defined Deliverables Checklist - Milestone Schedule & Timelines - Explicit Out-of-Scope Boundaries - Working Assumptions (client response times, asset delivery deadlines) - Revision Policy (e.g., standard 2 rounds of revisions included; additional rounds billed hourly) - Printable and exportable to clean PDF. ### 3.4 Dual Digital Sign-off - Both freelancer and client can apply digital sign-off with timestamped name acknowledgment. - Creates an agreed record of project scope prior to commencing billable work. ### 3.5 Frictionless Kickoff: Stripe & Calendly - Freelancer can configure an upfront deposit amount ($ or %) with direct Stripe payment link. - Freelancer can embed a Calendly / scheduling URL. - Clients see payment and kickoff booking options immediately upon completing the brief. ### 3.6 Multi-Platform Handoff (Notion & Trello) - Freelancers can export the entire client brief and compiled Scope of Work directly as formatted Markdown for Notion or structured card descriptions for Trello. --- ## 4. Competitive Analysis & Positioning | Feature / Capability | SoloBrief | Google Forms / Typeform | HoneyBook / Bonsai | Notion Forms | | :--- | :--- | :--- | :--- | :--- | | **Real-time Ambiguity Parser** | **Yes (Inline helper)** | No | No | No | | **Niche Vertical Presets** | **5 Specialized setups** | Generic templates | General CRM | Blank or generic | | **Word Count Enforcement** | **Yes (Client-side gate)** | No | No | No | | **Auto-Compiled SOW Proposal**| **Yes (Instant compilation)**| No | Manual contract tool | No | | **Dual Digital Sign-off** | **Built-in** | No | Yes | No | | **Stripe Upfront Deposit Link**| **Built-in** | Add-on / Webhook | Built-in | Webhook required | | **White-Label Client Portal** | **Yes (Pro plan)** | Expensive or none | Partial | Custom domain fee | | **Price** | **$0 Starter / $19/mo Pro** | Free - $59+/mo | $19 - $49+/mo | Free - $10+/mo | --- ## 5. Pricing & Plans - **Free Starter ($0/forever)**: - Up to 3 active client briefs - Starter niche vertical presets (Webflow, Brand Identity) + Custom brief builder - Real-time ambiguity detection & word count gating - Full client response viewer - No credit card required - **SoloBrief Pro ($19/month)**: - Unlimited active client briefs - All 5 niche vertical presets (adds SEO Strategy, Email Marketing, UX Research) - Scope of Work proposal compiler with dual digital sign-off and PDF export - Direct Stripe deposit links and Calendly booking integration - One-click handoff exports to Notion and Trello - 100% white-label client portal (removes SoloBrief badge) --- ## 6. Technical Stack & Security - Frontend: React 18, TypeScript, Tailwind CSS 4, Vite 7, Lucide Icons - State Management: TanStack React Query 5 - Backend & Database: Cloud Firestore with security rules restricting unauthorized reads/writes - Authentication: Firebase Authentication (Google OAuth) - Payments: Stripe Subscriptions & Customer Portal via Vercel Serverless Functions (`/api`) - Security: Strict Content Security headers, nosniff, frame denial, strict-transport-security, client briefs accessible only via unique cryptographic document IDs.