Skip to content

Commit 78f1519

Browse files
EMaherCopilot
andcommitted
docs: add agent behavior rules to prompt files
Instructs the Copilot agent to complete one step at a time, confirm user input before proceeding, ask permission to move to the next step, and never combine steps automatically. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 14cb38f commit 78f1519

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

src/templates/copilot/identity-setup-prompt-azure-devops.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,14 @@
66
77
> **Important identity distinction:** The Azure app registration/service principal created in this flow is only for Azure and APIM access. Repository contributions and pull request creation come from the Azure DevOps Build Service identity, which must be granted repo permissions separately.
88
9+
## Agent Behavior
10+
11+
- **One step at a time.** Complete each step fully before moving to the next.
12+
- **Confirm information.** After gathering user input, summarize what was provided and ask the user to confirm it is correct before proceeding.
13+
- **Ask before proceeding.** At the end of each step, ask: "Step N is complete. Ready to proceed to Step N+1?"
14+
- **Never combine steps.** Do not run commands from multiple steps together, even if they could be batched.
15+
- **Stop on errors.** If any command fails, show the full error output and wait for the user to decide how to proceed.
16+
917
## Goal
1018

1119
Configure workload identity federation (OIDC), Azure DevOps federated service connections,
@@ -42,6 +50,8 @@ For each environment in the configured list, gather these values (where `<ENV_UP
4250
- `APIM_NAME_<ENV_UPPER>`
4351
- `APIM_RESOURCE_ID_<ENV_UPPER>` *(optional Option B shorthand)*
4452

53+
**Copilot:** After collecting all values, present a summary table and ask: "Please confirm these values are correct before I proceed."
54+
4555
---
4656

4757
## Step 2: Set Variables

src/templates/copilot/identity-setup-prompt-github-actions.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,14 @@
66
77
> **Important identity distinction:** `GITHUB_TOKEN` handles pull request creation automatically. The Azure app registration/service principal in this flow is only for Azure and APIM access.
88
9+
## Agent Behavior
10+
11+
- **One step at a time.** Complete each step fully before moving to the next.
12+
- **Confirm information.** After gathering user input, summarize what was provided and ask the user to confirm it is correct before proceeding.
13+
- **Ask before proceeding.** At the end of each step, ask: "Step N is complete. Ready to proceed to Step N+1?"
14+
- **Never combine steps.** Do not run commands from multiple steps together, even if they could be batched.
15+
- **Stop on errors.** If any command fails, show the full error output and wait for the user to decide how to proceed.
16+
917
## Goal
1018

1119
Configure Azure AD federated credentials and GitHub repository secrets so the
@@ -86,6 +94,8 @@ each answer for use in later steps.
8694
| `APP_NAME` | Display name for the Azure AD application | `apiops-github-sp` |
8795
{{ENV_APIM_TABLE_ROWS}}
8896

97+
**Copilot:** After collecting all values, present a summary table and ask: "Please confirm these values are correct before I proceed."
98+
8999
---
90100

91101
## Step 2 — Create Azure AD Application & Service Principal

0 commit comments

Comments
 (0)