Skip to content

Conversation

@BekahHW
Copy link
Collaborator

@BekahHW BekahHW commented Oct 29, 2025

This PR adds comprehensive documentation for Agents in Continue Hub, perfectly aligned with the Mission Control UI and current capabilities.

closes CON-4359

New Documentation Structure

Getting Started (hub/agents/intro.mdx - Updated)

  • Quick start guide for Mission Control with step-by-step flow
  • Pre-configured agent showcase (Security Scanner, GitHub Manager)
  • Ways to run agents (Mission Control, TUI, Headless) with clear use cases
  • Best practices for Continuous AI adoption
  • Example workflow tasks organized by category

Overview (hub/agents/overview.mdx - New)

  • Complete agent concepts - what agents are and how they work
  • Component deep dive - prompts, rules, tools, models, visibility
  • Usage patterns with tabbed examples for all three execution modes
  • Pre-configured agent catalog with links to cookbook guides
  • Webhook integrations for CI/CD automation
  • Team collaboration roles and permissions

Create and Edit (hub/agents/create-and-edit.mdx - New)

  • Step-by-step agent creation process with Mission Control UI walkthrough
  • Component configuration guides (prompts, rules, tools, models)
  • Testing workflows for local validation before deployment
  • Example agent configurations with proven patterns
  • Best practices for prompt writing, rule selection, tool integration
  • Troubleshooting guide for common issues

Key Features

  • Mission Control UI alignment with actual form fields and behavior
  • Integration with pre-configured cookbook agents
  • Complete usage coverage (Mission Control, TUI, Headless modes)
  • Team-focused collaboration content
  • Cross-references to MCP integration cookbooks

Summary by cubic

Adds a complete Agents docs suite aligned with Mission Control to help teams understand, create, and run agents. Introduces Overview and Create/Edit guides, refreshes Getting Started, and updates navigation for clearer discovery.

  • New Features
    • New Overview: core concepts, components (prompt, rules, tools, model, visibility), run modes (web, TUI, headless), pre-configured agents, and team roles.
    • New Create & Edit: step-by-step UI walkthrough, config guides, testing workflows, example configs, best practices, and troubleshooting.
    • Updated Getting Started: quick start flow, prebuilt agent examples, ways to run, and practical tips.
    • Navigation: Agents section uses a robot icon and now includes intro, overview, and create-and-edit pages with cross-links to cookbook MCP guides.

Written for commit 42638b0. Summary will update automatically on new commits.

- Created hub/agents/overview.mdx with detailed agent concepts, usage patterns, and pre-configured agent listings
- Created hub/agents/create-and-edit.mdx with step-by-step guides for building custom agents
- Updated hub/agents/intro.mdx to be a focused getting-started guide with quick start flow
- Added agent pages to docs.json navigation structure
- Aligned documentation with Mission Control UI and actual agent capabilities
- Included references to cookbook agents and MCP integration examples

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
@BekahHW BekahHW requested a review from a team as a code owner October 29, 2025 16:35
@BekahHW BekahHW requested review from tingwai and removed request for a team October 29, 2025 16:35
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Oct 29, 2025
@github-actions
Copy link

⚠️ PR Title Format

Your PR title doesn't follow the conventional commit format, but this won't block your PR from being merged. We recommend using this format for better project organization.

Expected Format:

<type>[optional scope]: <description>

Examples:

  • feat: add changelog generation support
  • fix: resolve login redirect issue
  • docs: update README with new instructions
  • chore: update dependencies

Valid Types:

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

This helps with:

  • 📝 Automatic changelog generation
  • 🚀 Automated semantic versioning
  • 📊 Better project history tracking

This is a non-blocking warning - your PR can still be merged without fixing this.

@github-actions
Copy link

github-actions bot commented Oct 29, 2025

✅ Review Complete

Code Review Summary

⚠️ Continue API authentication failed. Please check your CONTINUE_API_KEY.


Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

2 issues found across 4 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="docs/hub/agents/overview.mdx">

<violation number="1" location="docs/hub/agents/overview.mdx:21">
Update the example model name to the correct Anthropic branding “Claude 3.5 Sonnet” to avoid confusing readers.</violation>
</file>

<file name="docs/hub/agents/intro.mdx">

<violation number="1" location="docs/hub/agents/intro.mdx:155">
The headless CLI example omits the required `-p` flag, so this command will open the TUI instead of running automatically. Please include `-p` before the prompt so readers get a working headless invocation.</violation>
</file>

React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.

@BekahHW BekahHW changed the title Add comprehensive agent documentation docs: Add comprehensive agent documentation Oct 29, 2025
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

Reviewed changes from recent commits (found 2 issues).

2 issues found across 11 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="docs/hub/agents/overview.mdx">

<violation number="1" location="docs/hub/agents/overview.mdx:140">
The Public visibility row overstates permissions—public viewers can discover and use an agent, but they cannot create or delete it. Please align this row with the actual visibility behavior shown elsewhere in the docs.</violation>
</file>

<file name="docs/hub/agents/intro.mdx">

<violation number="1" location="docs/hub/agents/intro.mdx:57">
This link targets localhost, so the published documentation will point users to their own machine instead of the live overview page. Please update it to a relative or production URL.</violation>
</file>

React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.

Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

Reviewed changes from recent commits (found 2 issues).

2 issues found across 2 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="docs/hub/introduction.mdx">

<violation number="1" location="docs/hub/introduction.mdx:28">
This sentence now implies only agents use these reusable components, but the rest of the page still describes configs being built from the same components. Please keep both configs and agents in scope to avoid misleading readers.</violation>

<violation number="2" location="docs/hub/introduction.mdx:62">
By stating components are only for agents, this tip now contradicts nearby guidance that shows configs also consume these components. Please keep configs in scope to maintain accurate messaging.</violation>
</file>

React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants