Templates

This page contains templates that you can use with your topics to set up good conversations. You can easily adapt them to your own purposes, or if you have ideas of good ones to add here please let us know.

For now, to use a template you should manually copy and paste it into your topic description.

There are documentation sections for Basics, Onboarding, Roadmap, Topics, Teams, User Settings, Integrations, Templates, and Markdown.

On this page you can find:

Basic Templates

Give an update

# Project

Add your project name/description here. You can link to the project home.

# Status

What's the overall status of the project?

- Risk (and how it is being mitigated)
- Risk (and how it is being mitigated)

# Achievements

You can list here important recent milestones that were reached.

# Next Steps

What are you working on next?

Make a decision

# Decision to be made

Describe clearly and simply as possible what the decision you need to make is,
and why it is important.

# Background information

Include here links to other resources that can be helpful context for making the
decision, that others might want to be aware of.

Ask for feedback

# Topic

What are you asking for feedback on? Include as much relevant detail as possible
on the topic that you're looking for feedback for, and why. If there are special
points of attention be sure to include them.

# Background information

Include here links to other resources that can be helpful context for making the
decision, that others might want to be aware of.

Make a proposal

# Idea

Summarize your idea as succintly as possible. You don't need to repeat the
content in the lower sections, but should try to make an attractive pitch for
the reader's attention.

# Objectives

What are the objectives of your proposal? How will you measure the results?

# Requirements

What resources do you need to make the proposal reality?

# Duration

How long will it take to deliver the results?

Ask a question/ask for help

# What you need

Describe clearly and simply as possible what you need help with or what question
you are asking, and why it is important.

# Background information

Include here links to other resources that can be helpful context for making the
decision, that others might want to be aware of.

Advanced Templates

Integrative Decision Making (Holacracy)

Adapted from this blog post, and originally from Holacracy. This template defines some clear phases that you can use in AsyncGo to help get to a good, well discussed and understood decision.

# Problem to Solve

To be added.

# Instructions/Phases

## Present Proposal

Proposer describes the problem that she saw in the provided space above, and
documents the solution she proposes in the outcome field.

## Clarifying Questions

Anyone can ask clarifying questions. Proposer can answer. No reactions or dialog
allowed. This should happen in the comments, but remember to limit yourself to
clarifying questions.

## Reaction Round

Each person can react to the proposal as they see fit. No discussion or
responses. It can be helpful to use emoji upvotes during this phase.

## Amend & Clarify

Proposer can optionally clarify the intent or amend the proposal based on
reactions. No discussion allowed. Updating the proposal at the top of this topic
makes sense, but it can also be helpful to indicate via bullets what changed
here.

## Objection Round

The Facilitator asks each person in turn: ”Do you see any reasons why adopting
this proposal would cause harm or move us backwards?” (an “Objection”).
Objections are stated, tested, and captured without discussion; the proposal is
adopted if none surface.

## Integration

The goal is to craft an amended proposal that would not cause the Objection, but
that would still address the proposer’s problem. Focus on each Objection, one at
a time. Once all are integrated, go through another Objection Round.

Structured Brainstorming Discussion

This template is for when you want to have a very open discussion around a topic. A good candidate for this kind of discussion is when you are trying to deeply understand a problem you want to solve.

# Context

Use this section to introduce the topic you'll be brainstorming about, including
any links to reference materials, scoping of the topic, and so on. Be sure to
specify what the main goal you're hoping to achieve is.

# Rules

Are there any special rules for discussion? For example, you could ask to not
jump to solutions too quickly if your focus for now is on the problem to solve.

# Phases

A brainstorm session is typically broken down into a few phases. You can add
bullet points from the discussion back to the description as decisions/progress
is made.

## Exploring the idea space

Start with an open book and gather as much context as you can.

- [ ] Is the context complete? What elements could we explore more and document
      to understand it more deeply?
- [ ] What are others doing in this space that works well, or doesn't?
- [ ] ...

## Brainstorming

Now that the context is well understood, everyone should bring their ideas. No
idea is a bad one at this point, and the focus should be more on finding
possibilities rather than deciding which are good.

## Voting

Now, you can vote on which ideas seem the most actionable. Be sure to document
why you feel that's the case. The goal isn't to select a single winner, but to
determine the best ideas and the threads that they have in common. Again, we
still are not likely aligning on a single solution, but determining which
elements of the ideas are most promising.

## Action Items

Now that you have a promising set of ideas and the reasons why, you can set up
actions to take the ideas towards the next step. Typically, this is now to
refine the idea into a single proposed solution that you can build alignment
around.