---
id: 10834
title: Trim sync_all tool description to comply with 1024-char limit
state: CLOSED
labels:
  - enhancement
  - ai
  - model-experience
assignees:
  - neo-gemini-pro
createdAt: '2026-05-06T16:39:49Z'
updatedAt: '2026-05-07T00:19:07Z'
githubUrl: 'https://github.com/neomjs/neo/issues/10834'
author: neo-gemini-pro
commentsCount: 1
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-07T00:19:07Z'
---
# Trim sync_all tool description to comply with 1024-char limit

### Context
The `sync_all` tool description in the `github-workflow` MCP server has grown significantly over the limit. During PR #10832, we added another constraint, pushing it to ~1627 characters, well beyond the 1024-character limit for LLM tools.

### The Problem
Excessively long tool descriptions waste context window tokens and risk being truncated by the MCP transport layer, meaning critical instructions may be ignored by agents.

### The Architectural Reality
The tool description lives in the `github-workflow` MCP server definition (`ai/mcp/server/github-workflow/openapi.yaml` or equivalent). It currently has multiple sections ("When to Use", "When NOT to Use", "Key Functions", plus the new branch-constraint at the top).

### The Fix
Condense the `sync_all` description. 
- Consolidate "When to Use", "When NOT to Use", and "Key Functions".
- Retain the critical branch-constraint at the top.
- Ensure the total character count is ≤ 1024.

### Acceptance Criteria
- [ ] `sync_all` description is under 1024 characters.
- [ ] The `dev` branch constraint remains prominently at the top of the description.
- [ ] The semantic meaning and safety warnings are preserved.

### Out of Scope
Modifying the actual `sync_all` functionality.

Origin Session ID: 88a6ed3a-b1b9-461a-aaf3-7c9984bd12e7

## Timeline

- 2026-05-06T16:39:51Z @neo-gemini-pro added the `enhancement` label
- 2026-05-06T16:39:51Z @neo-gemini-pro added the `ai` label
- 2026-05-06T16:39:51Z @neo-gemini-pro added the `model-experience` label
- 2026-05-06T22:39:25Z @neo-gemini-pro assigned to @neo-gemini-pro
- 2026-05-06T22:40:45Z @neo-gemini-pro cross-referenced by PR #10850
- 2026-05-06T22:49:37Z @neo-gemini-pro referenced in commit `374b479` - "fix(github-workflow): trim sync_all description below 1024 chars (#10834)"
### @neo-gemini-pro - 2026-05-06T23:41:48Z

**Input from Gemini 3.1 Pro (Antigravity):**

> ✦ Input from Antigravity (Gemini 3.1 Pro):
> 
> │ ✦ ### Contract Ledger (Backfilled)
> │
> │ Substrate Surface                 │ Contract Axis │ Change Authorized
> │ ──────────────────────────────────┼───────────────┼─────────────────────────────────
> │ ai/mcp/server/github-workflow/openapi.yaml │ Tool Metadata │ Condense `sync_all` description to under 1024 characters while preserving warnings.

- 2026-05-06T23:42:40Z @neo-gemini-pro referenced in commit `706c855` - "fix(github-workflow): trim sync_all description below 1024 chars (#10834)"
- 2026-05-07T00:19:07Z @tobiu referenced in commit `eeaf067` - "fix(github-workflow): trim sync_all description below 1024 chars (#10834) (#10850)

Co-authored-by: neo-gemini-pro <neo-gemini-pro@users.noreply.github.com>"
- 2026-05-07T00:19:07Z @tobiu closed this issue

