Twg Agentic Search Agent Skill

twg-agentic-search

Use together with the root twg skill. Exact command grammar comes from live

twg help, especially twg help describe "rovo search" when filter or output

options matter.

CLI launcher fallback

Run twg <command>. On shell command not found, use $HOME/.local/bin/twg

(macOS/Linux) / $env:LOCALAPPDATA\Programs\twg\bin\twg.exe (PowerShell), then

tell user to add that directory to PATH. Do not treat auth or command errors as

PATH failures.

Workflow

• Classify the request as fuzzy or cross-product internal research. Prefer this

skill when the source is unclear, current company knowledge is needed, or the

answer may span Confluence, Jira, Drive, Slack, Bitbucket, GitHub, or other

Rovo-connected apps.

• Confirm or infer the Atlassian site. Ask only when no configured or explicit

site is available and the ambiguity would change the search.

• If app/source availability changes the plan, run

twg rovo list-apps -o json or twg search list-apps -o json. Use the

returned built-ins, connectors, readiness, and auth/setup actions to decide

scope; do not start setup or login unless the user asked for it.

• Start with one query that combines the concrete topic with the requested

artifact or decision type. Use at most one canonical/authoritative or

recent/update-oriented refinement when the first result set mixes scopes,

lacks primary sources, or misses the requested time signal. Do not fan out

exact-title searches for every candidate already returned by the primary

query.

• Choose filters deliberately. Default to Confluence and Jira built-ins for

official/internal knowledge. Broaden to Slack, Google Drive, Bitbucket,

GitHub, or other connectors only when useful and available. Use app, type,

recency, owner/contributor/assignee/reporter/status, title-only, label/space,

and site filters when they narrow evidence without hiding likely answers.

• Search with bounded output:

twg rovo search "<query>" --output json --output-summary auto --agent-fields @compact
twg rovo search "<query>" --output json --output-summary auto --agent-fields @evidence

Use @compact to shortlist candidates and @evidence when snippets, URLs, and

provenance need more detail.

Evidence Rules

• Treat search snippets as candidates, not facts.
• Hydrate a small, diverse primary-source set before final claims. For document

discovery, cover distinct roles such as requirements, architecture/design,

and current delivery rather than redundant pages. Use product-native

commands such as twg confluence content get, twg jira workitem get,

twg jira workitem query, twg bb prs, twg bb repo, or the relevant

product command for the result URL/type.

• For document or PRD discovery, select at most five sources across those roles.

Hydrate one source per role unless a material conflict requires a second.

Stop once the roles, current delivery, and important conflicts are supported,

even when search returns more candidates.

• Prefer official spaces, owned project pages, current Jira issues, and recent

decision records over personal drafts or stale chat mentions, unless the user

explicitly asked for informal signal.

• Compare hydrated evidence for conflicts, recency, ownership, and authority.
• Do not rerun an @evidence search for a candidate that can be hydrated through

its product-native URL or ID, and do not refetch one source under another

projection.

Call out ACL gaps, unavailable connectors, low recall, and unresolved

contradictions instead of flattening them into a single claim.

Output

Lead with the answer or best-supported conclusion. Cite hydrated titles/URLs and

include the source app, date or status when available, and why each source was

trusted. Separate confirmed facts, likely interpretations, conflicts, and gaps.