Briefs

A brief is a detailed specification for a piece of content. It captures what you're writing, who it's for, and what it should cover.

What is a brief?

A brief is your contract with yourself about what you'll write:

• The topic and angle
• Target audience
• Key points to cover
• Sources and research
• Word count and format

Briefs become articles.

Creating a brief

1. Go to Create → Briefs in the sidebar
2. Click Create brief
3. Enter:
   • Title: Working title for the content
   • Plan: Which plan this belongs to (optional)
   • Description: What this content will cover
4. Click Create

The brief editor opens for detailed work.

Brief fields

Research in briefs

Use Boki to research directly in a brief:

1. Open the brief
2. Click the orange sparkle
3. Ask Boki to research the topic
4. Add findings to your brief

See Research with Boki for details.

Brief views

Briefs support multiple views:

Table: List view with sortable columns. Good for seeing all briefs at once.

Board: Kanban-style view. Columns by status (Draft, In Progress, Complete). Drag briefs between columns.

Calendar: Date-based view. Briefs appear on their due dates. Good for editorial calendars.

Access views from the view selector at the top of the Briefs page.

Creating an article from a brief

When your brief is complete:

1. Open the brief
2. Click Create article
3. The article editor opens with brief context loaded

Boki can reference your brief while you write.

Managing briefs

Edit a brief

1. Find the brief in the list
2. Click to open
3. Make changes
4. Changes save automatically

Delete a brief

1. Open the brief
2. Click the menu (three dots)
3. Select Delete

Move to a different plan

1. Open the brief
2. Change the Plan field
3. The brief moves to the new plan

Best practices

Be specific: "How to implement rate limiting in Node.js" beats "API article."

Include research: Briefs with sources produce better articles.

Set word counts: Gives you a target to write toward.

Use the board view: Great for tracking brief status across a team.

Related

• Plans — Organize briefs in plans
• Articles — Write from briefs
• Create your first article — Tutorial