A team decision log is a searchable record of what was decided, by whom and under which conditions. This guide helps you create one traceable decision record, distinguish it from a recommendation and show which decision is currently in force. You can finish the first worksheet without buying another work management tool.
Content last updated: 21 October 2026.
When does a team decision log earn its place?
Imagine a small service agency where one person remembers that all proposals require a director’s review. Another remembers that only unusual pricing needs review. Both may be acting in good faith, but a new colleague cannot reliably work from those memories. A decision log gives that colleague a place to check the actual choice and its boundaries.
Choose decisions that affect how other people work, are repeatedly questioned or need to survive a handover. Do not document every personal preference. If the record takes more effort to maintain than the confusion it resolves, narrow its scope. Start with one current operational decision rather than attempting to reconstruct several years of conversations.
Atlassian’s decision documentation template includes context, alternatives, participants and the outcome. Its separate Decisions Blueprint documentation describes an index of decision pages. Those are useful source concepts. The plain-text worksheet and replacement links below are an original practical design, not a claim about current Confluence controls or a required software configuration.
A broader digital transformation roadmap may contain many decisions. Your log should point to the relevant plan rather than copy it. The job here is preserving the reasoning and current applicability of a choice, not choosing your entire business strategy.
Separate a recommendation from a recorded decision
“We should review only unusual prices” is a recommendation. “Prepare a pricing review process” is an instruction to do work. Neither necessarily establishes the final operating rule. Before marking a record as active, locate the message, agreed note or approved document that demonstrates what the authorised person actually chose.
A record’s author and its decision owner are different roles. An assistant may write an excellent summary without having authority to approve its content. Record both names when that distinction matters. Use your existing task delegation rules to establish responsibilities; typing somebody’s name into a worksheet does not give them new authority.
| Statement | Meaning | Record treatment |
|---|---|---|
| Compare two review routes | Task | Link the action list |
| I recommend route B | Proposal | Keep pending |
| The owner selected route B | Reported decision | Verify the reference |
| I think we used route A | Uncertain recollection | Request clarification |
If no reliable reference exists, state that the decision needs confirmation. A tidy historical record is not worth inventing certainty. Also consider access: a private discussion may contain unrelated personal information. Preserve the relevant business conclusion and an appropriate reference without exposing the whole conversation to everybody.
Write enough context to prevent the same debate
Use a short problem statement followed by the chosen option, the main reason and an accepted limitation. A future reader should understand the trade-off without needing to reproduce the meeting. Listing every comment usually makes that harder, because the actual conclusion disappears inside the transcript.
Here is a hypothetical exercise, not a report of client work. A design agency chooses to let an account lead approve routine proposal wording, while the director still reviews unusual commercial terms. The reason is to make responsibility clear during ordinary delivery. The limitation is that the lead cannot authorise a new discount or change the contract terms.
Record the alternative briefly: director review of every proposal. Then record why the agency did not choose it in this constructed scenario: it does not match the intended division of responsibility. Do not turn that rationale into an invented performance result. “Intended to reduce waiting” and “reduced waiting by half” are different claims, and only the latter requires measured comparative evidence.
Link a relevant proposal document if it defines the boundary. Keep the document version identifiable. A link called latest proposal may lead to a different document later, leaving the old decision impossible to interpret. A short reference name and version can be more useful than another paragraph of explanation.
Copy a small decision record and index
On Windows, search Start for Notepad, open it and create a new document. On Mac, open TextEdit from Finder → Applications, choose File → New and, if needed, Format → Make Plain Text. Copy the fields below into that blank note. No new account or subscription is required for this local exercise.
Decision ID: D-01 Short title and scope: Actual decision date: Record prepared by: Authorised decision owner: Problem and relevant context: Chosen option: Reason and accepted limitation: Alternative not selected and why: Reference supporting the decision: Status: needs confirmation / active / replaced Replaces decision ID: none / ... Replaced by decision ID: none / ... Review trigger: Related plan or task:
Do not fill an unknown decision date with today’s date merely because you are writing the record today. Keep “record created today” separate from “decision date unverified.” Likewise, leave the actual decision pending if you only have a recommendation. Completeness means uncertainties are visible, not that every box contains an apparently confident answer.
After creating the card, add a compact index containing its ID, title, current status and location. This provides a place to scan several records without opening each one. Keep the ID stable when improving the title. Otherwise, existing messages and task references may point to a number you no longer use.
Show replacement without destroying the old reasoning
Suppose the hypothetical agency later changes its approval boundary. Ask first whether the new rule replaces the old rule everywhere or only applies to a particular client or project. A limited exception should not silently invalidate a general rule. Write its scope explicitly so that staff outside that exception continue to find the right instruction.
For a complete replacement, create D-02. In D-01, set the status to replaced and reference D-02. In D-02, record that it replaces D-01. Preserve the earlier rationale. A future reader can now see both today’s rule and why the earlier team made a different choice under different conditions.
| ID | Status | Relationship |
|---|---|---|
| D-01 | Replaced | See D-02 for the current rule |
| D-02 | Active | Replaces D-01 throughout the stated scope |
These are suggested worksheet states, not descriptions of a specific product interface. They preserve a practical distinction between a historical record and a current instruction. Avoid creating two active records with identical scope and incompatible directions. If you discover that conflict, flag it for the decision owner rather than choosing whichever record has the more convenient wording.
A client change request has another purpose: assessing a proposed change to agreed work. Once decided, that request may become a reference in this log. The log is not itself a fee estimate or permission to add work.
Complete and check one record in fifteen minutes
Use a decision whose supporting reference is already available. Fill in its ID, boundary, owner and chosen option. Add the reason, limitation and reference. Then state its current status and the event that would justify another review. Fifteen minutes is a planning target for this small task, not a measured completion guarantee.
In Windows Notepad choose File → Save As; in Mac TextEdit choose File → Save. Save team-decision-log-v1.txt in Documents, adding a date if that filename exists rather than overwriting it. Close the note, then reopen that exact file from Documents in File Explorer or Finder. Find D-01 and check its owner, status and supporting reference; keep unverified fields marked as such. This checks record persistence, not the authority or approval of its contents.
Read the card as though you had missed the meeting. Can you tell what to do, who decided it and where its authority stops? Replace vague phrases such as “same arrangement as before” with a concrete description. If the record requires a private explanation every time, it is not yet doing its job.
Use your small-business risk plan for wider hazards. Link only a specific risk or condition that could alter this decision. Keep the first log small enough that somebody will actually maintain it. One current, traceable record is a more useful outcome than an elaborate empty system.
Frequently asked questions
Should every task become a decision record?
No. Choose decisions that affect shared work, recur in questions or need to survive handover. Keep ordinary tasks in their action list.
What if the original decision date is unknown?
Mark it as unverified and record the creation date separately. Do not pretend that writing the record today dates the earlier decision.
Should a replacement erase the old record?
Preserve the earlier record when its history matters. Mark it replaced and link the new decision in both directions.
What is a useful first-session outcome?
One saved and reopened record showing the owner, scope, rationale, current status and supporting reference, with unknown information clearly marked.


