Brief
Install Brief

Brief your coding agent with a map and a mission.

Map the repo. Bound the task. Check the diff.

Install BriefWatch it build
brief · one real tasklocal repo
youFix APP-218. Reuse existing patterns and prove it.
youFix APP-218. Follow our repo rules and prove it.
youFix APP-218. Find the existing component first.
BriefWhat your agent knows before it edits
  1. Map
    Relevant code found

    Routes, owners, tests, rules, and an existing component

  2. Mission
    3 files in scope

    A small plan with allowed changes, tests, and stop conditions

  3. Diff check
    3 checks passed

    The actual change matches repo rules and focused tests pass

  4. Handoff
    Ready for human review

    Sources, test results, and remaining risk are named

ResultA smaller change with proof attached
Works where your team already works
CodexClaude CodeCursor

01 · Brief the task

Ask as usual. Brief finds what matters.

Brief finds the relevant code and rules, then bounds the task.

brief.context_for_task5 of 2,041 files matter here
Repo mapped

2,041 files indexed. The agent gets the five that matter, with their imports, owners, and tests.

01
Code Mapsource-cited

Imports, owners, tests, and reusable patterns.

02
Reference architectureproven pattern

Internal shipped code and external references, compared.

03
Team rulespath-scoped

Mandatory rules for the files in scope.

04
Missionsbounded contract

Scope, tests, proof, and stop conditions.

Task scopedMake and check the change

02 · Mission, then check

Set the scope. Check the diff.

Brief defines scope, rules, tests, approvals, and stop conditions. A read-only check reviews the diff.

Browse mission starters Read the context engineering field guideSee the six-stage coding agent workflow
brief.automation_planYour coding agent
Your coding agentTurn approved work into a PR

Brief defines files, rules, tests, approvals, and stop conditions. Your coding agent runs the model with your credential.

  1. TriggerLinear issue labeled Brief Ready
  2. ExecuteCodex in Actions
  3. ProofReviewed pull request
Your controls
Starts in your tracker

Brief never receives your model credential.

Safe to retry

Approval pauses the run before writes.

Change checkedKeep what the reviewer teaches

03 · Learn from review

Keep the corrections your team repeats.

Reviewer corrections become source-cited lessons, approved before team reuse.

Browse shared guidance
Agent proposes

“Auth routes use requireUser().”

Brief saves the correction as a source-cited proposal.

Maintainer decides

Approve wording and scope

Personal preference cannot weaken mandatory team policy.

Next relevant task

Brief includes the approved lesson

The correction returns only when its paths and task match.

GitHub

PR checks, sources, and review proof

Linear

Clear tickets, mission status, and next steps

Slack

Focused decisions and replies tied to the coding task

Lesson approvedUse it on the next matching task

04 · Route the work

Spend more only when the task needs it.

Brief recommends a model, reasoning level, and fan-out. You set the ceiling.

brief.model_routeRecommendation only
Recommended routeGPT-5.6 LunaEconomy · LowCurrent Codex model family

Keep a familiar, easy-to-test change fast.

Fan-out
One builder
Proof
Focused tests
Quality bar
Routine
Cost posture
Minimize spend
Your controls
Routing mode
Maximum model
Recommendation only

Brief recalculates as evidence changes.

Quality raisedSource still stays local

05 · Review the artifact

Review HTML and Markdown without making it public.

Publish from Claude or Codex as Restricted. Teammates can comment on the page, selected text, or an element; the agent reads the thread and uploads the next version.

Open the artifact review guide
Access
Restricted by default
Comments
Stay attached to what was selected
Versions
Use the same link
checkout.htmlv3
Restricted

Artifact reviewedKeep source local

06 · Keep source local

Your repo stays yours.

Files and diffs stay local. Team sync sends derived summaries and receipts; raw source requires opt-in.

Developer machineRepository sourcescan · context · diff reviewstays local by default
Optional team syncDerived proof onlyreceipts · summaries · approved guidanceraw source needs explicit opt-in

Connect Brief

Install locally. Connect your workspace when you need it.

Run one short command. Brief detects your agents, installs its default instructions, and opens secure browser sign-in with a short-lived browser approval when you connect a workspace.

Runs locally. Your source stays in your repo.

Pricing

Start with one repo. Add the team when it helps.

Local context and diff review are free. Team memory is optional.

Local$0

Repo mapping, task context, and local diff review.

Install Brief
Founding Team Access Private betaIncluded

Owner-approved guidance and review memory across the team.

Create a team workspace