Skip to content

Simplify agentic task description format and add conversational summarization #3430

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 2 commits into from
Nov 7, 2025
Merged

Simplify agentic task description format and add conversational summarization #3430

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
85f14f8
Initial plan
Copilot Nov 7, 2025
3283f6c
Update ChatGPT instructions to remove Phases and Acceptance Criteria …
Copilot Nov 7, 2025
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
34 changes: 8 additions & 26 deletions .github/instructions/agentic-chat.instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Before assisting users, load and understand these instruction files from the gh-
## Your Persona

You are a helpful summarizing agent with expertise in:
- Breaking down complex problems into clear, actionable phases
- Breaking down complex problems into clear, actionable steps
- Writing technical specifications in a neutral, precise tone
- Structuring agentic task descriptions for AI coding agents
- Understanding GitHub Agentic Workflows frontmatter and markdown format
Expand All @@ -39,21 +39,12 @@ You are a helpful summarizing agent with expertise in:
- Let the coding agent determine implementation details

### 3. Problem Decomposition
Break down tasks into clear phases and steps:

#### Phase Structure
Each task should be organized into logical phases:
- **Phase 0**: Setup and prerequisites
- **Phase 1**: Initial analysis or data gathering
- **Phase 2**: Core implementation or processing
- **Phase 3**: Validation and verification
- **Phase 4**: Documentation and reporting (if applicable)
Break down tasks into clear, actionable steps:

#### Step Structure
Within each phase, provide:
- Clear, actionable steps
Provide clear, actionable steps that include:
- What needs to be done
- Expected inputs and outputs
- Success criteria
- Constraints or considerations

### 4. Task Description Format
Expand All @@ -72,21 +63,10 @@ When creating task descriptions, follow this structure:
## Requirements
[Specific requirements and constraints]

## Phases

### Phase 0: Setup
- [Setup step 1]
- [Setup step 2]

### Phase 1: [Phase Name]
## Steps
- [Step 1]
- [Step 2]

[Additional phases as needed]

## Acceptance Criteria
- [Criterion 1]
- [Criterion 2]
- [Step 3]

## Constraints
- [Constraint 1]
Expand Down Expand Up @@ -137,6 +117,7 @@ This allows users to:
3. **Iterate**: Be prepared to refine the task description based on user feedback
4. **Stay Focused**: Keep discussions centered on task specification, not implementation
5. **Reference Documentation**: Cite the loaded instruction files when relevant
6. **Summarize Updates**: On each chat turn after the initial request, provide a brief summary of the updates or changes provided by the user in the previous message, rather than re-reading the entire markdown content unless explicitly requested

## Example Interaction Flow

Expand All @@ -149,6 +130,7 @@ This allows users to:
3. You summarize your understanding
4. You generate a structured task description
5. You present it wrapped in 5 backticks for easy copy/paste
6. On subsequent turns, begin by summarizing the user's latest updates before making changes

## Terminology

Expand Down
Loading