Skip to content

Update software-engineer-agent-v1.chatmode and spec-driven-workflow-v1.instructions #112

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.

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

Open
wants to merge 24 commits into
base: main
Choose a base branch
from

Conversation

mubaidr
Copy link
Contributor

@mubaidr mubaidr commented Jul 18, 2025

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, or chat mode with GitHub Copilot.
  • I have run node update-readme.js and verified that README.md is up to date.

Description

This pull request is continuation of #107 by me.

This adds an update for:

  • software-engineer-agent.chatmode:
    • Manage name in chat mode file
    • other minor formatting adjustments
  • spec-driven-workflow-v1.instructions:
    • Manage name in chat mode file
    • added dir for maintaining artifacts
    • added Edge Case Matrix to requirements artifact
    • added Concrete "Few-Shot" Examples for artifacts

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New chat mode file.
  • Other (please specify): Update existing mode and specification

Additional Notes


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

@Copilot Copilot AI review requested due to automatic review settings July 18, 2025 19:12
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This pull request updates the "Software Engineer Agent" chat mode and creates a new version of the "Spec Driven Workflow" instruction set. The changes improve file naming consistency, add enhanced edge case handling capabilities, and introduce a more structured artifact management approach.

  • Adds title field and minor formatting improvements to the software engineer agent chat mode
  • Replaces v1 spec-driven workflow with v2 that includes comprehensive edge case handling protocols
  • Updates README.md to reflect the new file names and descriptions

Reviewed Changes

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

File Description
instructions/spec-driven-workflow.instructions.md New v2 workflow with enhanced edge case handling, structured artifacts directory, and concrete examples
instructions/spec-driven-workflow-v1.instructions.md Complete removal of v1 workflow file
chatmodes/software-engineer-agent.chatmode.md Addition of title field and minor formatting adjustments
README.md Updated entries to reflect new file names and descriptions

mubaidr and others added 13 commits July 19, 2025 00:18
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
- reduced verbosity while preserving all core concepts
- reorganized content for quicker scanning and clearer structure
- simplified artifact descriptions and adopted consistent naming
- refined peril/responsibility phrasing to eliminate redundancy
- added maintenance rules for artifact updates throughout the workflow
- reduced example boilerplate and aligned with current conventions
- upgrades spec-driven-workflow.instructions.md description from v2 → v3
- synchronizes README.md entries to reference v3 for both workflows
- advances Software Engineer Agent from v1 → v3 with autonomous, zero-hand-holding behavior
- streamlines agent prompt: shorter intro, solid design & security standards, one-line escalation triggers
- revise software engineer agent description and principles for clarity
- remove interruption/resume and technical debt sections from spec-driven workflow instructions
- update README to reflect new agent description
@@ -0,0 +1,270 @@
---
description: 'You must follow a robust, interactive approach to software development. Clarify all requirements before implementation to eliminate ambiguity. Prioritize safety and transparency by producing and maintaining structured artifacts and clear protocols. Proactively identify and handle edge cases rather than waiting for them to emerge.'
Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks for updating this @mubaidr - I appreciate it. Would you update the description here to be more what the instruction does? To me this reads more like the instruction itself. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy