Skip to content

Add custom instructions for thread titles - #4800

Closed
brsbl wants to merge 26 commits into
mainfrom
bb/add-customizable-thread-naming-prompt-settings-thr_qy2yfwjgn2
Closed

brsbl wants to merge 26 commits into
mainfrom
bb/add-customizable-thread-naming-prompt-settings-thr_qy2yfwjgn2

Conversation

@brsbl

@brsbl brsbl commented Oct 3, 2026 •

Copy link
Copy Markdown
Collaborator

Human comments

What was wrong

Thread titles used a fixed prompt, so users could not set the language, length, tone, or naming conventions bb uses for them.

What changed

  • Settings → AI services adds + Add instructions under Thread titles.
  • Instructions are added to bb's built-in title rules, not swapped in for them.
  • The field autosaves on blur; clearing it restores bb's rules.
  • Title generation and the Test action use saved instructions.
  • New setting threadTitleInstructions (1–2,000 characters, or null) works through bb settings general and the SDK; older clients that omit it keep the saved value.
  • Plugin SDK is bumped to 0.6.17 for the changed settings types.
  • Docs, the bb guide, the bb-cli skill, and bb cloud's data disclosures cover title instructions.
  • Generated titles are now capped at 100 display columns instead of 48. Prefixes and longer languages made titles exceed 48, and the cut chopped them mid-phrase. The prompt still asks for about 40 characters, and the sidebar already shortens long titles with an ellipsis, so the cap only guards against runaway replies.
  • Commit message instructions were removed from this PR; they can follow when someone asks for them.

How you verified

  • Remote CI on 3fd9f27800.
  • Server tests: instructions reach the title and Test prompts with bb's rules intact; older clients keep the saved value.
  • Branch dev app (Codex title service), 7 prompts per instruction set, including a long prompt, a greeting-first prompt, Chinese, a 17,500-character log, and a thread mention:
Prompt "Use at most 5 words. Casual tone, lowercase, no jargon." "Start every title with the kind of work and a colon: Fix:, Feature:, Investigate:, or Chore:" "Write titles in Spanish."
Burndown chart (Cole's report) add a burndown chart to the plan graph Feature: Add a burndown chart to the plan graph background Añadir gráfico de burndown al plan graph
Greeting, then dark mode icons update sidebar icons in dark mode Fix: Update sidebar icons on theme change Actualizar los iconos de la barra lateral al cambiar el tema
Context, then Safari 17 bug fix safari 17 verification page Fix: Blank verification page in Safari 17 Corregir la página de verificación en Safari 17
Retry button one-liner add retry for failed uploads Feature: Add retry for failed uploads Añadir botón para reintentar cargas fallidas
Chinese language-switch bug 修复语言切换后文字未更新 Fix: 修复语言切换后文字未更新 修复切换语言后按钮文字未即时更新
Question + 17,500-char log diagnose startup migration crash Investigate: Server crash during migration startup Diagnosticar el fallo al iniciar tras una migración truncada
Thread mention + dashboard ask add a hideable burndown chart Feature: Add a hideable burndown chart to the project dashboard Añadir gráfico de burndown ocultable al panel del proyecto

The prefix and Spanish columns were rerun after raising the cap; with the 48-column cut, 3 of those 13 titles had been chopped mid-phrase ("…chart to the", "…visualizador del"). The model follows instructions most of the time but not always: with the 5-word set, the burndown prompt came back in sentence case 2 of 4 times, and the Chinese prompt stays in Chinese under "Write titles in Spanish."

Not tested: bb cloud. Every run above used the Codex title service. Dev builds route bb cloud to the local cloud stack, which needs an OPENROUTER_API_KEY to reach bb cloud's title model (inception/mercury-2.5, falling back to google/gemini-2.5-flash-lite), and none was available. It should be rerun with bb cloud before merging, because bb cloud is the first choice under Automatic for signed-in users.

Screenshots

Before: merge base 76a1ebcaf5 (unchanged on the current base). After: f3bd55fe45. Same isolated data, route, light theme, and 2× density.

AI services Before After
Desktop, 1440 × 1100 Before desktop After desktop
Mobile, 390 × 844 Before mobile After mobile

Title instructions saved, after a hard reload (after only):

After with title instructions

P2 follow-ups

  • Text typed while a save is in flight can be replaced when the save returns.
  • A failed save leaves its error visible after the field is cleared.

BB-Thread-ID: thr_qy2yfwjgn2

AGENT GENERATED

🤖 Generated with Claude Code

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 3, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-03T05:10:29.454244Z 9ea0688 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9ea0688cc9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread packages/domain/src/app-settings.ts Outdated
Comment thread apps/app/src/components/settings/AiTaskPromptSetting.tsx Outdated
brsbl and others added 12 commits October 2, 2026 22:28
Replace the nested Prompt · Default disclosure with a compact edit button
beside Test, show Custom prompt in the row description only when
customized, and auto-size the inline editor.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace full-prompt overrides (threadNamingPrompt, commitMessagePrompt)
with threadTitleInstructions and commitMessageInstructions that are
appended to bb's built-in rules, matching Zed, VS Code Copilot, and
JetBrains. A short instruction like "Write titles in French." no longer
drops length, casing, and format rules. The editor starts empty with an
example placeholder; clearing and saving restores the built-in rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Render loading and loaded rows through the same instructions wrapper so
the service dropdown is not remounted when the view arrives.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Show an always-visible instructions field under Thread titles and Commit
messages that autosaves on blur, matching the Custom instructions plugin
settings page, instead of a pencil-toggled editor with Save and Cancel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Show + Add instructions until instructions exist; it expands and focuses
the field, which collapses again when left empty.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keep main's loading and loaded row branches, each wrapped in a row div so
the dropdown keeps its identity, and revert formatting-only hunks in the
migrate test.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@brsbl brsbl changed the title Customize thread title and commit message prompts Add AI task instructions for thread titles and commit messages Oct 3, 2026
brsbl and others added 5 commits October 3, 2026 13:49
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…losures

Move the instructions docs under the existing AI services sections with a
per-task settings table, and state in bb cloud's data disclosures that any
instructions added for a task are sent with that task.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Each instructions field now omits the other field from its general
settings update, relying on the server's existing preservation of omitted
fields, so saving both fields before the config refetch cannot undo the
first save.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Commit message instructions are removed until someone asks for them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@brsbl brsbl changed the title Add AI task instructions for thread titles and commit messages Add custom instructions for thread titles Oct 4, 2026
brsbl and others added 3 commits October 3, 2026 19:49
Custom instructions such as type prefixes or other languages make titles
longer, and the 48-column cut chopped them mid-phrase. The sidebar already
truncates long titles with an ellipsis, so the cap is only a runaway guard.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Titles in other languages or with a type prefix produced branch names like
a-adir-gr-fico or feature-...-the-pro. Strip accents to base letters and
cut long slugs at a word boundary.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@SawyerHood

Copy link
Copy Markdown
Collaborator

This is an automated message. We have closed this pull request because it has been open for more than two weeks.

@SawyerHood SawyerHood closed this Oct 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants