Refactor documentation for spec-driven development; update project br…#4
Merged
Refactor documentation for spec-driven development; update project br…#4
Conversation
…ief references and remove obsolete files
spelling fix Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
spelling fix Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull Request Overview
This pull request updates the documentation and onboarding instructions across the project to shift terminology and configuration from "ConPort MCP" to "Memory MCP," streamline the setup process, and modernize the workflow for spec-driven development. The changes remove outdated references, simplify Docker and local setup instructions, and update project briefs to better align with current tools and practices.
- Replaces "ConPort MCP" references with "Memory MCP" and updates MCP tool configuration
- Introduces automated
/analyze-productworkflow to replace manualprojectBrief.mdcopying - Updates command workflows from file-based (
Plan #feature-[name].md) to slash commands (/create-spec,/execute-tasks)
Reviewed Changes
Copilot reviewed 16 out of 17 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| requirements-template.md | Adds new comprehensive requirements template with structured sections for business value, technical design, and implementation planning |
| goals/*/projectBrief.md | Removes obsolete project brief files that are now auto-generated |
| goals/*/1-setup.md | Updates setup instructions to use Memory MCP, removes ConPort references, and introduces /analyze-product workflow |
| goals/*/2-requirements.md | Replaces manual requirements template with /create-spec command and updates workflow commands |
| goals/3-tips.md | Updates workflow tips to reference new slash commands instead of old file-based commands |
| conportal-python.md | Removes obsolete ConPort Python setup documentation |
| README.md | Updates project title to "Spec Driven Development Programming Challenge" and refreshes repository references |
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
ChrisMcKee1
approved these changes
Aug 28, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request updates the documentation and onboarding instructions across the project to shift terminology and configuration from "ConPort MCP" to "Memory MCP," streamline the setup process, and modernize the workflow for spec-driven development. It removes outdated references, simplifies Docker and local setup instructions, and updates project briefs to better align with current tools and practices.
Key changes include:
MCP Server Naming and Configuration Updates:
Onboarding and Workflow Improvements:
projectBrief.mdwith an automated/analyze-productworkflow that generates the necessary documentation and.docsfolder, making the onboarding process more automated and less error-prone. [1] [2]copilot-instructions.mdand other documentation are now generated by the framework, not manually managed. [1] [2]Documentation Cleanup:
conportal-python.mdfile and references to running ConPort locally, as the new workflow standardizes on Docker and the Memory MCP.goals/dotnet/projectBrief.md) and Java (goals/java/projectBrief.md), as these are now auto-generated. [1] [2]General Terminology and Branding:
README.mdto refer to "Spec Driven Development Programming Challenge" and reflects the repository's new name and focus.These changes collectively modernize the onboarding and documentation to match the current architecture and best practices for spec-driven development with AI-assisted tools.…ief references and remove obsolete files