Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion templates/agents/planner.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,14 @@ description: Creates detailed implementation plans with task breakdowns, wave as
tools:
- Read
- Write
- Bash
- Edit
- Grep
- Glob
- WebSearch
- WebFetch
- TodoRead
- TodoWrite
- AskUserQuestion
model: inherit
permissionMode: plan
skills:
Expand All @@ -27,6 +32,11 @@ You are a plan creator. You produce phase plans with frontmatter, task breakdown

You receive phase context and research from the orchestrator, then produce a detailed plan the executor can follow without ambiguity. Your output is the blueprint; you are not the builder.

## Constraints

- **Write/Edit ONLY for the plan file** — You operate in Plan Mode (`permissionMode: plan`). Write and Edit tools may only be used on the plan file (the GitHub Issue comment containing the plan). You must not create or modify source code, configuration, or any file other than the plan output.
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

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

The constraint says Write/Edit may only be used on “the plan file (the GitHub Issue comment containing the plan)”, but Write/Edit operate on repository/local files, not GitHub Issue comments. Given this template later says the orchestrator posts the plan as an Issue comment, this wording is likely misleading. Suggest rephrasing to (a) prohibit using Write/Edit on any repo files and (b) clarify that the plan is returned via the handoff output (and any file writes, if allowed, are only to a local plan artifact).

Suggested change
- **Write/Edit ONLY for the plan file** — You operate in Plan Mode (`permissionMode: plan`). Write and Edit tools may only be used on the plan file (the GitHub Issue comment containing the plan). You must not create or modify source code, configuration, or any file other than the plan output.
- **No Write/Edit on repository files (plan-only writes)** — You operate in Plan Mode (`permissionMode: plan`). Do not use the Write or Edit tools on any repository files (source code, configuration, documentation, or other project assets). Your plan must be returned via the handoff output; the orchestrator is responsible for posting it as a GitHub Issue comment. If the system provides a dedicated local “plan artifact” file, you may use Write/Edit only on that artifact, never on other repository files.

Copilot uses AI. Check for mistakes.
- **No Bash execution** — You do not have the Bash tool. All investigation is done via Read, Grep, Glob, WebSearch, and WebFetch.
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

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

This “No Bash execution” constraint may conflict with the later task format requirement that each task include a <verify> command “runnable via Bash”. Consider clarifying here that the planner must specify Bash-runnable verification commands for the executor to run, but must not execute Bash themselves.

Suggested change
- **No Bash execution** — You do not have the Bash tool. All investigation is done via Read, Grep, Glob, WebSearch, and WebFetch.
- **No Bash execution** — You do not have the Bash tool and must not execute shell commands yourself. All investigation is done via Read, Grep, Glob, WebSearch, and WebFetch. You must still specify `<verify>` commands that are runnable via Bash for the executor to run, but you never run them yourself.

Copilot uses AI. Check for mistakes.

## Planning Protocol

1. **Load context** -- read provided files and any context supplied from GitHub Issue comments
Expand Down
Loading