Documents and knowledge
The brief outlives the meeting. So does every decision.
Write the brief, the decisions and the process beside the project, with versions you can go back to.

One brief, through every change of scope.
Scope grows after discovery, then the launch order changes. Each version keeps the decision context, so the team works from one brief.
Open each version to see what changed.
The workspace
Context the next teammate can find.
Documents sit beside the project they support. The one you need is pinned, and you choose which ones the client can see.
Beside its project
The brief, the decisions and the process live with the work they support.
Pinned where it matters
Keep the document a teammate needs most at the top.
Internal or client-visible
Set per document, and read it as the client would first.
Rich text that stays readable
Headings, lists, task lists and tables.
Every version kept
Take a snapshot, inspect earlier versions and restore one after an accidental edit.
Templates to start from
A consistent structure for the documents you write every week.
Give every document a job. The reader knows what it answers.
A brief explains the work. A decision log explains what changed. A working process explains how a repeated task gets done. Start each from a template and replace the example details.
Project brief
Outcome, audience, scope and constraints, in one current version.
“Outcome: bookings for the new Riverside clinic by the end of October.”
Start fromProject BriefMeeting NotesDecision LogRetro
Decision log
What changed, when and why.
“16 Sep: two landing pages added after discovery.”
Meeting notes
Decisions and actions while they are fresh.
“Action: Dana sends the photo library by Friday.”
Retro
What to repeat and what to change next time.
“Keep: one consolidated feedback round.”
Working process
How a repeatable task gets done here.
“Before launch, test every form on a phone.”
Examples written for illustration.
Clear about what a document decides.
What documents do
- Keep the brief, decisions and processes with the project.
- Stay internal or become client-visible, one document at a time.
- Keep versions you can inspect and restore.
- Give repeated documents a template to start from.
What they do not do
- Spot a sensitive figure pasted into a shareable page. Read it as the client would.
- Approve a scope change. Confirm fee and dates through a proposal.
- Replace a task. Put the action in a task and link the document.
- Run a public help center or a large knowledge database.
Record the change in the brief, and the approval in the proposal. See proposals ↗
The details.
Everything above, in depth. Open what you need.
Give the document a job beyond storing text
A brief explains the outcome, audience, scope, and constraints. A decision record explains what changed and why. A working process explains how a repeatable task should be handled. Naming the document's job helps the writer decide what belongs in it and helps the reader know whether the material answers their question.
Flowboard provides a rich-text document workflow with project association, templates, and pinning. Use a clear title and a small number of purposeful documents rather than a large collection of nearly identical notes. A project can have many conversations, but it should have an identifiable place for the current brief and the decisions that change delivery.
Make visibility part of the writing process
Documents can be internal or client-visible. That choice should reflect the content, not merely the folder or project it belongs to. An internal production note may include uncertainty or staffing detail that is useful for the team. A client-facing brief should explain the shared agreement in language the client can act on.
Before changing visibility, read the whole document from the intended audience's perspective. Remove irrelevant internal commentary and check that linked or attached material is appropriate. A visibility setting cannot detect whether the author pasted a sensitive cost estimate into an otherwise shareable page. Preview the client experience when the document will be part of the portal workflow.
An illustrative brief through three versions
Imagine a web project whose initial brief covers five pages and a contact form. After discovery, the agency adds a documented requirement for two audience-specific landing pages. Later, the client changes the launch priority. Each revision should explain the current scope and preserve the important decision context rather than leaving competing briefs in circulation.
Inspect earlier document versions and restore one after an accidental edit. Keep the current brief clear as the scope changes, and record any fee or schedule approval through the proposal or change process. The team can follow both the evolving work and the agreement behind it.
| Document state | What changed | Operational follow-up |
|---|---|---|
| Initial brief | Baseline scope recorded | Confirm the shared understanding |
| Discovery update | New requirement identified | Review fee and delivery impact |
| Launch revision | Priority changes | Update the task plan and client expectation |
Turn repeated documents into useful templates
A template should save decisions that are stable and leave room for the details that make the engagement different. Avoid turning it into a long checklist that nobody can explain.
Choose a repeated document
Start with a brief, kickoff note, review agenda, or delivery checklist that the team already writes frequently.
Keep the structural prompts
Include the questions that consistently improve the work, such as outcome, scope, owner, approval path, and open decisions.
Replace example assumptions
When using the template, remove stale sample facts and write the engagement-specific context. Check that every named person and date is correct.
Review and maintain the source
Update the template when the team learns something useful. A template should carry good practice forward, not preserve an outdated process forever.
Decide when a document should become a task
A document explains context, but it does not replace ownership and status for work that someone must complete. When a brief creates an action, put that action in a task and reference the relevant document. When a chat conversation changes the agreement, update the document rather than expecting every future reader to reconstruct the thread.
Keep the brief, decisions, and working process beside the project they support. Flowboard documents connect that context to delivery and client collaboration. Use specialist tools for public publishing, help centers, or complex knowledge databases.
Connect context to delivery
Turn the agreed next action into work with an owner and a visible state.
Explore this workflow ↗Share the appropriate version
Review the client-facing experience before using a document in the portal.
Explore this workflow ↗Questions
Before you share a document.
Can a document be shared with a client?
Documents have internal and client-visible modes. Choose deliberately and review the content before exposing it through the client experience. Check the whole document for internal notes, sensitive values, and links that may not be appropriate for the external audience.
Can we recover an earlier version?
The document workflow includes version history and restoration of a prior version. Inspect the relevant history before restoring so you understand what later edits may be replaced. Important commercial decisions should still be recorded through the appropriate approval process.
Can we reuse a brief or onboarding document?
Templates provide a reusable starting point. Keep the stable structure and replace the engagement-specific assumptions, dates, names, and scope. A template helps consistency, but it should not encourage the team to send a generic brief without thinking through the actual work.
How many documents should a project have?
Use enough to make distinct information easy to find, but avoid splitting one coherent brief into many tiny pages. Give the current brief, major decisions, and reusable procedures clear homes. Pin or organize the material that a teammate is most likely to need during delivery.
Is a document edit the same as approving a scope change?
No. Record the updated scope in the document, then confirm any change to the fee, date, or responsibilities through your proposal or change-approval process. That keeps the working brief and commercial agreement aligned.