Skip to content

docs: align copilot-instructions.md prompt/agent descriptions with actual agi.prompt.md behavior#164

Merged
Bryan-Roe merged 12 commits into
mainfrom
copilot/align-guide-with-prompt-behavior
May 9, 2026
Merged

docs: align copilot-instructions.md prompt/agent descriptions with actual agi.prompt.md behavior#164
Bryan-Roe merged 12 commits into
mainfrom
copilot/align-guide-with-prompt-behavior

Conversation

Copilot AI commented Apr 30, 2026

Copy link
Copy Markdown
Contributor
  • Fixed copilot-instructions.md agent table and prompt list (previous session)
  • Fixed agi-reasoning.agent.md description — replaced "Specializes in chain-of-thought reasoning" with "Uses internal chain-of-thought reasoning (not exposed in output)"; added redirect "For visible step-by-step reasoning, use reason.prompt instead"; removed "chain of thought" trigger phrase that would incorrectly route users wanting visible CoT
  • Fixed agi.prompt.md front-matter description — added "Chain-of-thought reasoning runs internally — only the final answer is delivered to the user. For visible step-by-step reasoning, use reason.prompt instead."
  • Parallel validation passed (no code review comments, no CodeQL findings)

@sourcery-ai sourcery-ai Bot 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.

Hi @Copilot! 👋

Your private repo does not have access to Sourcery.

Please upgrade to continue using Sourcery ✨

…tual agi.prompt.md behavior

Agent-Logs-Url: https://github.com/Bryan-Roe/Aria/sessions/b53ab83e-20cf-49d6-b2c8-71ada149d720

Co-authored-by: Bryan-Roe <74067792+Bryan-Roe@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix guide to align with agi.prompt.md content docs: align copilot-instructions.md prompt/agent descriptions with actual agi.prompt.md behavior Apr 30, 2026
Copilot AI requested a review from Bryan-Roe April 30, 2026 14:33
…en CoT behavior

Agent-Logs-Url: https://github.com/Bryan-Roe/Aria/sessions/02d5805e-beca-4937-913b-dac349a80fd7

Co-authored-by: Bryan-Roe <74067792+Bryan-Roe@users.noreply.github.com>
@Bryan-Roe Bryan-Roe marked this pull request as ready for review April 30, 2026 14:57
Copilot AI review requested due to automatic review settings April 30, 2026 14:57

@sourcery-ai sourcery-ai Bot 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.

Hi @Bryan-Roe! 👋

Your private repo does not have access to Sourcery.

Please upgrade to continue using Sourcery ✨

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Apr 30, 2026
@github-actions

github-actions Bot commented Apr 30, 2026

Copy link
Copy Markdown
Contributor

🔴 Coverage — 0399fad

Metric Value
Total coverage 59.7%
→ vs main 0.0%
Minimum threshold 60%

Updated on every push · 2026-05-09

Copilot AI 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.

Pull request overview

Updates GitHub Copilot documentation/metadata to align the AGI prompt and agent descriptions with the intended behavior that chain-of-thought is performed internally (final answer only), and clarifies how reason.prompt.md is meant to be used.

Changes:

  • Updated .github/prompts/agi.prompt.md front-matter description to explicitly state chain-of-thought is internal and point users to reason.prompt.
  • Updated .github/agents/agi-reasoning.agent.md description to remove “chain of thought” trigger phrasing and clarify internal-only chain-of-thought.
  • Updated .github/copilot-instructions.md agent table entry and prompt list entry to reflect the above.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
.github/prompts/agi.prompt.md Clarifies AGI prompt front-matter to state hidden/internal chain-of-thought and redirect to reason.prompt.
.github/copilot-instructions.md Updates agent/prompt summaries to reflect hidden/internal chain-of-thought expectations.
.github/agents/agi-reasoning.agent.md Updates agent description and trigger phrases to avoid implying visible chain-of-thought output.

Comment thread .github/copilot-instructions.md Outdated
Comment thread .github/agents/agi-reasoning.agent.md
@Bryan-Roe Bryan-Roe requested review from Copilot and removed request for Bryan-Roe April 30, 2026 16:28

Copilot AI 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.

Pull request overview

Aligns documentation metadata for the AGI reasoning prompt/agent so that descriptions in .github/copilot-instructions.md and prompt/agent front-matter match the intended “internal (hidden) chain-of-thought” behavior, while directing users to reason.prompt for visible step-by-step reasoning.

Changes:

  • Updates .github/prompts/agi.prompt.md front-matter description to explicitly state chain-of-thought is internal and redirect to reason.prompt for visible steps.
  • Updates .github/copilot-instructions.md agent table and prompt list descriptions to reflect hidden vs visible reasoning behavior.
  • Updates .github/agents/agi-reasoning.agent.md description and trigger phrases to remove “chain of thought” as a trigger and clarify hidden-CoT behavior.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
.github/prompts/agi.prompt.md Clarifies AGI prompt uses internal/hidden chain-of-thought; redirects to reason.prompt for visible reasoning.
.github/copilot-instructions.md Updates agent/prompt descriptions to match the intended hidden vs visible reasoning split.
.github/agents/agi-reasoning.agent.md Adjusts agent description and trigger phrases to better match hidden-CoT positioning.

---
name: agi-reasoning
description: "AGI reasoning and autonomous decision-making agent. Specializes in chain-of-thought reasoning, task decomposition, self-reflection, and multi-step planning using the AGI provider system.\n\nTrigger phrases include:\n- 'reason through this problem'\n- 'break this down step by step'\n- 'think through this autonomously'\n- 'use AGI reasoning'\n- 'chain of thought'\n- 'self-reflection'\n- 'autonomous planning'\n\nExamples:\n- User says 'reason through this architecture decision' → invoke for structured multi-step analysis\n- User asks 'break down this complex feature into tasks' → invoke for task decomposition\n- User says 'autonomously plan and implement this feature' → invoke for planning + execution with self-correction\n\nThis agent leverages the AGI provider's reasoning chains, task decomposition, and self-reflection capabilities."
description: "AGI reasoning and autonomous decision-making agent. Uses internal chain-of-thought reasoning (not exposed in output) for task decomposition, self-reflection, and multi-step planning — only the final answer is delivered to the user. For visible step-by-step reasoning, use reason.prompt instead.\n\nTrigger phrases include:\n- 'reason through this problem'\n- 'break this down step by step'\n- 'think through this autonomously'\n- 'use AGI reasoning'\n- 'autonomous planning'\n- 'self-reflection'\n\nExamples:\n- User says 'reason through this architecture decision' → invoke for structured multi-step analysis\n- User asks 'break down this complex feature into tasks' → invoke for task decomposition\n- User says 'autonomously plan and implement this feature' → invoke for planning + execution with self-correction\n\nThis agent leverages the AGI provider's reasoning chains, task decomposition, and self-reflection capabilities. Chain-of-thought steps are completed internally; only the final answer is delivered."
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>
@Bryan-Roe Bryan-Roe self-requested a review as a code owner May 6, 2026 02:28
Copilot AI review requested due to automatic review settings May 6, 2026 02:28
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment thread .github/copilot-instructions.md Outdated
Comment thread .github/agents/agi-reasoning.agent.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 6, 2026 02:31
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment thread .github/copilot-instructions.md Outdated
Comment thread .github/prompts/agi.prompt.md
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 6, 2026 03:22
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

Comment on lines 1 to 3
---
description: "Engage autonomous AGI reasoning with multi-step analysis, task decomposition, self-correction, and iterative improvement. For complex problems requiring structured autonomous thinking."
description: "Engage autonomous AGI reasoning with multi-step analysis, task decomposition, self-correction, and iterative improvement. Chain-of-thought reasoning runs internally — only the final answer is delivered to the user. For visible step-by-step reasoning, use `reason.prompt.md` instead."
name: "AGI Reasoning"

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

@copilot apply changes based on this feedback

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Already applied in commit 296b162 — both .github/prompts/agi.prompt.md and .github/agents/agi-reasoning.agent.md now reference `reason.prompt.md` with the .md extension and in backticks.

Comment thread .github/agents/agi-reasoning.agent.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 6, 2026 03:36

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Signed-off-by: Bryan <74067792+Bryan-Roe@users.noreply.github.com>
@Bryan-Roe Bryan-Roe merged commit a1fa2ca into main May 9, 2026
29 of 36 checks passed
@Bryan-Roe Bryan-Roe deleted the copilot/align-guide-with-prompt-behavior branch May 9, 2026 06:00
@github-actions

github-actions Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Snapshot Warnings

⚠️: No snapshots were found for the head SHA b79dcb2.
Ensure that dependencies are being submitted on PR branches and consider enabling retry-on-snapshot-warnings. See the documentation for more information and troubleshooting advice.

Scanned Files

None

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

3 participants