fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(52): replace stale MCP issue refs and refresh Wave 2 execution - #494

Merged
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough
May 28, 2026
Merged

fix(52): replace stale MCP issue refs and refresh Wave 2 execution#494
ashleyshaw merged 1 commit into
developfrom
codex/52-wave2-followthrough

Conversation

@ashleyshaw

@ashleyshawashleyshaw commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Closes#52 by replacing stale MCP issue tool references and completing the requested live backlog refresh + formal Wave 2 reprioritisation updates.

Changes

#52 MCP tool reference alignment

  • Updated stale issue creation/read references in active agent and prompt specs:
    • create_issue -> issue_write
    • get_issue -> issue_read
  • Files updated:
    • agents/mode-prd.agent.md
    • .github/prompts/create-github-issue-feature-from-specification.prompt.md
    • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
    • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
    • .github/prompts/my-issues.prompt.md

Changelog + next actions plan (requested first)

  • Updated CHANGELOG.md (Unreleased) with:
    • merged #64 + PR #461 status
    • merged policy hardening PR #463
    • this #52 MCP reference alignment
    • Wave 2 reprioritisation completion note
  • Updated .github/projects/active/next-issues-execution-plan-2026-05-27.md with:
    • current merged baseline (#61, #64)
    • Wave 1 now focused on #52
    • formal Wave 2A/2B/2C batch structure for #464-#490

Wave 2 reprioritisation pass (live issue updates)

  • Posted scheduling/progress comments on #464-#490.
  • Set Wave 2A core runtime batch (#464, #465, #466, #467, #468, #469, #476, #480, #482) to status:ready.

Validation

  • npm run lint:md -- CHANGELOG.md .github/projects/active/next-issues-execution-plan-2026-05-27.md .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md .github/prompts/create-github-issue-feature-from-specification.prompt.md .github/prompts/my-issues.prompt.md agents/mode-prd.agent.md
  • npm run test:js (pre-commit hook)

Summary by CodeRabbit

  • Documentation

    • Updated project execution plan to v1.1.0 with refreshed roadmap content, explicit Wave 2 batch organization (core runtime, planning agents, scaffolds) for upcoming development cycles, and revised execution sequencing.
  • Chores

    • Updated internal GitHub issue management tool references across agent configurations and prompt specifications to align with current platform APIs.

Review Change Stack

@coderabbitai

coderabbitaiBot commented May 28, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR updates the project execution plan to version 1.1.0 with revised Wave 2 batching structure, and systematically migrates deprecated MCP tool references (create_issue → issue_write, get_issue → issue_read) across prompt and agent configuration files. Changes are documented in CHANGELOG.md.

Changes

Issue #52 Maintenance & Execution Plan Update

Layer / File(s)Summary
Execution Plan Update (2026-05-28)
.github/projects/active/next-issues-execution-plan-2026-05-27.md
Document version bumped from v1.0.3 to v1.1.0. Wave 1 ordering adjusted to prioritize #52 execution. Wave 2 expanded into three sub-batches (2A: core runtime burn-down, 2B: mode/planning agent, 2C: scaffolds/completion) with specific issue lists and execution dependencies. Proposed next action updated to continue #52 merge and open Wave 2A branch.
MCP Tool Reference Migration
.github/prompts/create-github-issue-feature-from-specification.prompt.md, .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md, .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md, .github/prompts/my-issues.prompt.md, agents/mode-prd.agent.md
Replaced deprecated MCP tool references: create_issueissue_write in spec-from-feature, implementation-plan, and unmet-requirements prompts and mode-prd agent; replaced get_issueissue_read in my-issues prompt. Tool declarations and process instructions updated consistently across all files.
Changelog Documentation
CHANGELOG.md
Unreleased section expanded with entries documenting execution plan Wave 2 reprioritization with explicit burn-down batches for spec-only agent tasks (#464#490), and a Changed subsection documenting the MCP tool reference migration (create_issue → issue_write, get_issue → issue_read) for issue #52 alignment.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested labels

status:needs-review, type:bug, documentation, lang:md, priority:normal, meta:needs-changelog

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: replacing deprecated MCP tool references and refreshing Wave 2 execution planning, directly related to issue #52.
Description check✅ PassedThe description covers the main changes, includes a summary section, lists all modified files, provides changelog updates, and mentions validation steps performed.
Linked Issues check✅ PassedThe PR addresses all acceptance criteria from issue #52: replaced create_issue with issue_write, scanned for and replaced get_issue with issue_read, updated relevant files and documentation, and prepared changelog entries.
Out of Scope Changes check✅ PassedAll changes are scoped to issue #52 requirements and the Wave 2 execution plan refresh mentioned in the PR objectives. No unrelated modifications detected.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/52-wave2-followthrough

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@github-actionsgithub-actionsBot added area:documentation Docs & guides lang:md Markdown content/docs status:needs-review Awaiting code review priority:normal Default priority type:chore Chore / small hygiene change type:bug Bug or defect meta:needs-changelog Requires a changelog entry before merge and removed type:chore Chore / small hygiene change labels May 28, 2026

@chatgpt-codex-connectorchatgpt-codex-connectorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c71ea31836

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +9 to 11
"issue_write",
"search_issues",
"update_issue",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the remaining issue update tool

This prompt still allow-lists update_issue even though the change migrates issue creation to the consolidated MCP tool. I checked the current GitHub MCP issue tool list, where updates are handled by issue_write with method: 'update', and update_issue is no longer listed; in hosts that validate prompt frontmatter tool names exactly, the update-existing path can fail to load or become unavailable. The same stale allow-list entry appears in the other two issue-creation prompts.

Useful? React with 👍 / 👎.

Comment on lines +7 to 8
"issue_read",
"get_issue_comments",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Replace the stale issue comments tool

This swaps get_issue to issue_read but leaves get_issue_comments in the prompt allow-list. The current GitHub MCP issue tools consolidate comment reads into issue_read with the get_comments method, so environments that exact-check prompt tool names can reject this prompt or leave the comment-count workflow without the declared read tool.

Useful? React with 👍 / 👎.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md:
- Line 15: Add a single top-level H1 above the existing "## Next Issues
Execution Plan (2026-05-28)" heading so the file contains one H1 and subsequent
headings are sequential; specifically insert a "# Next Issues Execution Plan
(2026-05-28)" (or a brief equivalent H1 title) immediately before the current
"## Next Issues Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one
H1 per file and keep heading levels sequential" guideline.
In `@agents/mode-prd.agent.md`:
- Around line 14-16: Add the new tool names "issue_write" and "issue_read" to
the validator allowlist by updating the validTools array in
scripts/validation/validate-agents.js so the agent config entries
("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: 12809a52-d541-48f6-b25c-21136adbb058

📥 Commits

Reviewing files that changed from the base of the PR and between 2cca963 and c71ea31.

📒 Files selected for processing (7)
  • .github/projects/active/next-issues-execution-plan-2026-05-27.md
  • .github/prompts/create-github-issue-feature-from-specification.prompt.md
  • .github/prompts/create-github-issues-feature-from-implementation-plan.prompt.md
  • .github/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md
  • .github/prompts/my-issues.prompt.md
  • CHANGELOG.md
  • agents/mode-prd.agent.md

---

## Next Issues Execution Plan (2026-05-27)
## Next Issues Execution Plan (2026-05-28)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add a single H1 before this section to keep heading levels sequential.

This starts at ## without a preceding #, which breaks the required heading structure for Markdown docs.

As per coding guidelines, "**/*.md: Use one H1 per file and keep heading levels sequential".

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.github/projects/active/next-issues-execution-plan-2026-05-27.md at line 15,
Add a single top-level H1 above the existing "## Next Issues Execution Plan
(2026-05-28)" heading so the file contains one H1 and subsequent headings are
sequential; specifically insert a "# Next Issues Execution Plan (2026-05-28)"
(or a brief equivalent H1 title) immediately before the current "## Next Issues
Execution Plan (2026-05-28)" line to satisfy the "*.md: Use one H1 per file and
keep heading levels sequential" guideline.

Comment on lines +14 to +16
"issue_write",
"update_issue",
"get_issue",
"issue_read",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Update the agent-tools validator allowlist for issue_write/issue_read.

These new tool names are not in scripts/validation/validate-agents.js (validTools), so this config can be flagged as Unknown tool during validation.

Suggested fix
--- a/scripts/validation/validate-agents.js+++ b/scripts/validation/validate-agents.js
@@
const validTools = [
@@
"todo",
"todowrite",
+ "issue_write",+ "issue_read",
];
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@agents/mode-prd.agent.md` around lines 14 - 16, Add the new tool names
"issue_write" and "issue_read" to the validator allowlist by updating the
validTools array in scripts/validation/validate-agents.js so the agent config
entries ("issue_write", "update_issue", "issue_read") are recognized; locate the
validTools symbol in that file and append these two strings to the list
(preserving formatting and any existing sorting conventions) so validation no
longer flags them as Unknown tool.

@github-actions

Copy link
Copy Markdown
Contributor

🔍 Reviewer Summary for PR #494

CI Status:success
Files changed: 7

Recommendations

  • Ready to proceed pending human review

@ashleyshaw
ashleyshaw merged commit 5f11844 into developMay 28, 2026
18 checks passed
@ashleyshaw
ashleyshaw deleted the codex/52-wave2-followthrough branch May 28, 2026 06:43
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:documentationDocs & guideslang:mdMarkdown content/docsmeta:needs-changelogRequires a changelog entry before mergepriority:normalDefault prioritystatus:needs-reviewAwaiting code reviewtype:bugBug or defect

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update references from 'create_issue' to 'issue_write' and scan for outdated MCP tools

1 participant

@ashleyshaw