Brainforge Knowledge

01-AI-writing-guide

5 min read

Writing With AI at Brainforge (Explain Like I’m 5)

This guide teaches you how to write using AI at Brainforge in a clear, simple, and repeatable way.
You don’t need to be technical.
You don’t need to know how AI works.

You only need to follow the steps and patterns below.

Think of AI (Cursor, Claude, GPT) as your co-writer:

  • It helps you start faster
  • It helps you write clearer
  • It helps you avoid sloppy mistakes
  • It helps you follow Brainforge’s style
  • It uses our templates and examples automatically

You stay in control. The AI just helps.

Why We Use AI for Writing

Brainforge writes a lot:

  • SOWs
  • PRDs
  • SOPs
  • Meeting notes
  • Client messages
  • Deck outlines
  • Internal docs

AI makes all of these:

  • Faster to create
  • More consistent
  • Higher quality
  • Easier to revise
  • Aligned with our standards

You still review and edit.
AI simply accelerates the entire process.

The Most Important Rule

Never accept the AI’s first draft without reviewing it.

AI gives you a fast starting point.
You make it good.

The Basic Writing Workflow (Super Simple)

Every Brainforge document follows the same basic pattern.

Step 1 — Open the right repo

Open the client repo or the playbook repo in Cursor.

Cursor now understands the context.

Step 2 — Create a new .md file

Examples:

  • sow-insurance-draft.md
  • prd-intake-agent-v1.md
  • 2025-02-01-meeting-summary.md

Markdown is simple, clean, and AI-friendly.

Step 3 — Use the correct template

Say to Cursor:

  • “Fill this file using the SOW template in the playbook.”
  • “Use the PRD template and structure it based on the examples.”
  • “Create a SOP using the sop-template.md from the playbook.”

Cursor will insert a complete draft.

Step 4 — Add relevant context

Examples:

  • “Use the last 3 meeting notes in this repo.”
  • “Include discussion points from the 2025-01-14 transcript.”
  • “Align with the style of the insurance SOW example.”
  • “Use the PRD examples in the playbook as reference.”

Cursor will automatically read the files.

Step 5 — Clean it up with review prompts

Always run at least one of these:

Clarity Review

“Rewrite this section so it’s clearer and more concise.”

Client-Facing Tone

“Rewrite this in a polished, professional tone suitable for a client.”

Structure Check

“Check this document structure against our template and suggest improvements.”

Error Sweep

“Fix typos and formatting issues. Match Brainforge writing standards.”

Humanize (remove AI patterns)

“Use /humanizer to make this sound natural and remove AI-generated writing patterns.”

Or simply ask:

“Humanize this draft so it doesn’t sound AI-generated.”

The humanizer skill removes 24 common AI writing patterns (significance inflation, promotional language, em dash overuse, sycophantic tone, etc.). See .cursor/skills/humanizer/ in the playbook for the full reference.

This turns a decent draft into a strong document.

Step 6 — You review the draft yourself

Check for:

  • correctness
  • missing details
  • things AI misunderstood
  • sensitive information
  • tone alignment

AI can write well, but you know the truth.

Step 7 — Commit and push your final draft

Save your work to GitHub so others can see it and collaborate.

The Five Golden Rules of Brainforge Writing

1. Structure comes first

AI performs best when you tell it which template to use.

2. Use examples

The playbook includes great SOWs, PRDs, SOPs.
Tell Cursor to follow them.

3. Be specific with instructions

Instead of:

  • “write a SOW”

Try:

  • “write a SOW using the standard template + example SOWs + last 2 meetings.”

4. Take at least one editing pass

AI gets you 80% of the way.
You finish the remaining 20%.

5. Use AI to think, not just write

AI can:

  • reorganize sections
  • compare documents
  • find inconsistencies
  • extract requirements
  • highlight risks
  • rewrite messy notes into clean prose

Use it for the thinking, not just the typing.

The Brainforge Quality Checklist

Before finalizing any document, ask AI:

  1. “Does this follow the correct template?”
  2. “Is this clear to someone who has never seen the project before?”
  3. “What sections are weak or vague?”
  4. “Does anything sound too AI-generated or fluffy?”
  5. “Highlight any missing assumptions or risks.”
  6. “Rewrite this as a senior consultant.”

These checks dramatically improve quality.

Choosing the Right Model

A simple rule of thumb:

  • Claude Sonnet: best for clean writing, structure, and accuracy
  • GPT-5.1: great for creativity and reorganization
  • Claude Opus: strongest for long, deep reasoning documents

If your draft quality is not good, switch the model and try again.

The Most Useful Prompts (Copy/Paste)

Start a Document

“Use the SOW/PRD/SOP template from the playbook and fill this file based on the last 3 meeting notes.”

Improve Tone

“Rewrite this in a professional, client-facing voice with clear structure.”

Fix Messy Notes

“Turn this rough text into a polished, well-structured section.”

Sanity Check

“List any inconsistencies, contradictions, or missing details.”

Make Writing Stronger

“Rewrite this as a senior consultant who is excellent at crisp communication.”

When NOT to Use AI

Use caution when:

  • Writing sensitive pricing without verifying
  • Making factual claims without checking source materials
  • Writing anything requiring legal accuracy
  • Handling confidential client details that the AI misinterprets

AI drafts → human confirms truth.

Summary

Good writing at Brainforge follows a simple flow:

  1. Open repo
  2. Start a markdown file
  3. Use the correct template
  4. Add real project context
  5. Improve draft with AI review prompts
  6. Review yourself
  7. Commit + push

Graph View