Skip to content

P1-T8: Update /config examples for broker setup first#132

Merged
SoundBlaster merged 8 commits into
mainfrom
codex/p1-t8-config-broker-setup-first
Mar 1, 2026
Merged

P1-T8: Update /config examples for broker setup first#132
SoundBlaster merged 8 commits into
mainfrom
codex/p1-t8-config-broker-setup-first

Conversation

@SoundBlaster
Copy link
Copy Markdown
Owner

Description

Implement P1-T8 end-to-end via FLOW and update config/ templates to present broker setup first.

Key changes:

  • Added and selected P1-T8 in SPECS/Workplan.md / SPECS/INPROGRESS/next.md.
  • Updated config examples to be broker-first:
    • config/cursor-mcp.json
    • config/zed-agent.json
    • config/claude-code.txt
    • config/codex-cli.txt
  • Created and archived task artifacts:
    • SPECS/ARCHIVE/P1-T8_Update_config_examples_for_borker_setup_first/
    • validation report + review report
  • Updated archive index/log and reset SPECS/INPROGRESS/next.md to idle.

Validation results:

  • pytest735 passed, 5 skipped
  • ruff check src/ → pass
  • mypy src/ → pass
  • pytest --cov91.26%

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactoring
  • CI/CD improvement

Quality Gates

Before submitting, ensure all quality gates pass:

make check

Or run individually:

  • make test - All tests pass with ≥90% coverage
  • make lint - No linting errors
  • make format - Code is properly formatted
  • make typecheck - Type checking passes
  • make doccheck - Documentation is synced with DocC (if docs changed)

Documentation Sync

If you modified files in docs/, ensure corresponding DocC files are also updated:

docs/ file DocC file
docs/installation.md mcpbridge-wrapper.docc/Installation.md
docs/cursor-setup.md mcpbridge-wrapper.docc/CursorSetup.md
docs/claude-setup.md mcpbridge-wrapper.docc/ClaudeCodeSetup.md
docs/codex-setup.md mcpbridge-wrapper.docc/CodexCLISetup.md
docs/troubleshooting.md mcpbridge-wrapper.docc/Troubleshooting.md
docs/architecture.md mcpbridge-wrapper.docc/Architecture.md
docs/environment-variables.md mcpbridge-wrapper.docc/EnvironmentVariables.md
README.md mcpbridge-wrapper.docc/mcpbridge-wrapper.md
  • Documentation changes are synced with DocC catalog (or N/A)

Testing

  • Added/updated tests for new functionality
  • All tests pass locally
  • Manually tested the changes

Checklist

  • Code follows the project's style guidelines
  • Self-review completed
  • Comments added for complex code
  • Documentation updated (if needed)
  • No new warnings generated
  • PR title is descriptive

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the repository’s MCP client configuration templates to present broker-mode setup first (P1-T8), and archives the task’s validation/review artifacts under SPECS/ARCHIVE/.

Changes:

  • Reordered/expanded config/ templates for Cursor and Zed to show broker-mode options before non-broker alternatives.
  • Updated Claude Code and Codex CLI setup snippets to make broker-mode the recommended “Option 1”.
  • Added P1-T8 planning/archive entries and archived validation + review reports.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
config/zed-agent.json Adds broker-first option blocks and renumbers other options accordingly.
config/cursor-mcp.json Adds broker-first option blocks and renumbers other options accordingly.
config/codex-cli.txt Reorders CLI setup instructions to put broker-mode first.
config/claude-code.txt Reorders CLI setup instructions to put broker-mode first.
SPECS/Workplan.md Marks P1-T8 as completed and records outputs/acceptance criteria.
SPECS/INPROGRESS/next.md Resets status to idle and records P1-T8 as recently archived.
SPECS/ARCHIVE/_Historical/REVIEW_p1_t8_config_broker_setup_first.md Adds the historical review report for P1-T8.
SPECS/ARCHIVE/P1-T8_Update_config_examples_for_borker_setup_first/P1-T8_Validation_Report.md Adds the validation report artifact for P1-T8.
SPECS/ARCHIVE/P1-T8_Update_config_examples_for_borker_setup_first/P1-T8_Update_config_examples_for_borker_setup_first.md Adds the archived PRD/spec artifact for P1-T8.
SPECS/ARCHIVE/INDEX.md Updates archive index/log to include P1-T8 and the review report reference.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread SPECS/ARCHIVE/INDEX.md Outdated
Comment thread SPECS/Workplan.md Outdated
Comment thread SPECS/INPROGRESS/next.md Outdated
Comment thread SPECS/INPROGRESS/next.md Outdated
@SoundBlaster SoundBlaster changed the title P1-T8: Update /config examples for borker setup first P1-T8: Update /config examples for broker setup first Mar 1, 2026
@SoundBlaster
Copy link
Copy Markdown
Owner Author

Addressed all Copilot review comments in commit f34502f:\n- corrected borker -> broker in task/report/index text\n- renamed archive folder and PRD filename to ..._broker_setup_first\n- fixed grammar in validation notes (due to)\n- restored missing P2-T3 item in SPECS/INPROGRESS/next.md\n- updated PR title to use broker spelling

@SoundBlaster SoundBlaster merged commit d1b1c3d into main Mar 1, 2026
10 checks passed
@SoundBlaster SoundBlaster deleted the codex/p1-t8-config-broker-setup-first branch March 1, 2026 15:32
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