Use case · Teams

How to build in public without the weekly update chore

Building in public is valuable until writing the update becomes another recurring job. The hard part is reconstructing what changed and why from scattered commits, chats, and notes. A working record helps separate what remains useful from what is no longer true. Hark is not a substitute for customer research, financial judgment, or a detailed delivery tracker. It gives a founder one place to preserve the current state, accepted decisions, evidence, work, and ownership so the next action has context. Each record can distinguish accepted decisions from proposals and system-observed evidence; accepted does not mean independently verified.

The setup

A simple way to run it in Hark

  1. 01Document while you build

    Add ship, decision, and milestone entries to the project journal as the work happens.

  2. 02Track meaningful movement

    Keep traction metrics and Current state current so updates include evidence and direction, not only a changelog.

  3. 03Generate a progress update

    Select recent entries and create deterministic plain, Markdown, or X-thread copy that remains fully editable.

  4. 04Link the public project page

    Publish selected sections and include the live project page so readers can follow the project beyond one post.

Write as you go

The easiest update to publish is one supported by notes already made during the work. Log a release, decision, or milestone when it happens; keep a brief source link and the reason it matters. Add metrics with dates and definitions, including periods with no growth. Avoid turning a proposed idea into a commitment in public copy. Hark can generate editable plain text, Markdown, or an X-thread style draft from selected entries. Generated text is a starting point, not a fact-check.

Keep the public boundary deliberate

Without Hark, collect dated notes in a document, write a weekly summary, verify every claim, and manually remove private details before posting. With Hark, keep the working record in the project, select the entries that belong in an update, edit the generated draft, and choose whether to link a public project page. Projects are private by default; publishing selected sections is a deliberate choice. Review the visible page as a reader, especially links, metrics, customer references, and unfinished work. A public page should not be treated as a substitute for consent or legal review.

Make the update useful

A compact format works: what changed, why it matters, what you learned, what remains uncertain, and what comes next. Specificity beats promotional language. If the audience includes prospective investors, the same dated record can support a process view; see show investors your process.

Do this today: turn one release into a useful post

Take a single change you can demonstrate. For example, an invitation flow might now show a clear expired-link message. Capture what the reader can actually see and distinguish the released behavior from work still on a branch. Write one sentence about the original problem, one about the change, and one about the remaining limitation. If there is no outcome measurement yet, say so. A small verified improvement is more useful than an inflated account of a busy week.

Without Hark, keep a dated release note next to the commit or test evidence. Review customer names, screenshots, and private links before publishing. Use a repeatable outline: changed behavior, reason, check performed, open question, next action. Store the published URL with that note so future updates can refer to it without recreating the history.

With Hark, record the ship and supporting evidence during the session. Ask the agent to leave a closing handoff through the working-with-agents connect guide. Select the appropriate journal entries for an editable progress update, then read every sentence as a claim you own. Remove anything not supported by the selected evidence. Review any public project sections before linking them. Generating an update does not itself post it to a social account. Publish through your normal channel only after the final review, and keep the announcement separate from the next task. That boundary makes a repeatable habit without turning every proposed feature into a public commitment.

Starter build

Hark’s public project page

Starter builds are coming. Until then, use Hark’s own documented build as the example structure for this setup.

View the public project page placeholder →
Use this setup

Common questions

Does Hark post the update automatically?

Creating a progress update gives you editable copy. Review it and publish through your chosen channel; generation should not be mistaken for a completed social post.

What if nothing shipped this week?

Describe a genuine learning or open question if it is useful, or skip the update. Do not turn investigation, proposals or unfinished changes into released features.

Should every decision be public?

No. Keep private working material private. Select only suitable decisions and evidence, and review customer details and linked content before sharing.

Can I use the same record for investor updates?

Yes, selected dated evidence can support both audiences. Change the framing and disclosure boundary for each recipient rather than sending identical copy everywhere.