AI Coding Agent Sessions & Issue Integration

[jjsilva4]

Task Overview

Audit and update all documentation relating to Agent Sessions, Launchpad, Left Panel, and Preferences (Agents & External Tools) across versions 12.0.0 through 12.4.0.

Background & Updates to Incorporate

• Start Agent Sessions from Issues (v12.4.0):

  • Launchpad: Select "Start an Agent Session" in the ACTION column on any issue without an associated branch.
  • Left Panel: Right-click an issue without an associated branch and select "Start an Agent Session".
  • Setup Modal: Both entry points trigger a setup modal allowing users to confirm the new branch name, coding agent, and environment settings.
  • Behavior: Automatically creates a new branch, opens it in a worktree, and launches the selected coding agent primed with the issue's context.

• Inline Permission Controls & Command Preview for Claude Code (v12.4.0):

  • Agent permission prompts appear inline inside the Agent panel with Allow and Deny actions.
  • Users can click an expandable carat inline with the allow/deny actions to reveal the exact command Claude Code is requesting permission to run.

• Agent Status & External Session Focus (v12.2.0, v12.3.1):

  • Left Panel Toggle: Displays highest-priority session status (Running, Thinking, Waiting for Input) with a count tooltip.
  • External Window Focus: Eye icon on external sessions focuses the external agent window or prompts terminal relaunch.

• Panel State Persistence (v12.4.0):

  • The agent workflow panel preserves its scroll position when switching workspaces instead of resetting to the top.

Google Technical Writing & Help Center Standards

When modifying or writing content, enforce the following:

• Voice & Vocabulary: Maintain active voice and eliminate wordy phrases (e.g., replace "is able to" with "can", "determine the location of" with "find"). Avoid idioms or culturally specific metaphors.
• Task Orientation: Structure explanations around user tasks and goals. Introduce each list and table with an introductory sentence ending in a colon.
• Image Alt Text: Provide descriptive alt text that explains the image's function or takeaway in context.
• Help Center Image Wrapping:

  <figure>
    <img src="..." class="help-center-img img-bordered" alt="Descriptive alt text" />
    <figcaption style="text-align: center; color: #888">Centered caption text</figcaption>
  </figure>
  
    Timestamp Tag: Include <kbd>Last updated: [Month Year]</kbd> directly after the metadata block.

Acceptance Criteria for Claude Code

[ ] Audit all files under /agents, /launchpad, /left-panel, and /preferences.

[ ] Document launching agent sessions from Launchpad ACTION column and Left Panel issue context menu.

[ ] Detail setup modal options (branch name, agent selection, custom settings).

[ ] Document inline Allow / Deny controls and expandable command preview carats for Claude Code.

[ ] Update agent status indicators and external session focus steps.

[ ] Ensure compliance with Google Technical Writing and Accessibility standards.