Align Copilot prompt commands and clean up Sprint 0 onboarding docs#3
Merged
Merged
Conversation
Agent-Logs-Url: https://github.com/diwad-code/SpaceshipGame/sessions/d88be50c-0d56-4687-b85a-7f43fb95291e Co-authored-by: diwad-code <250159374+diwad-code@users.noreply.github.com>
Copilot created this pull request from a session on behalf of
diwad-code
May 23, 2026 12:35
View session
Contributor
There was a problem hiding this comment.
Pull request overview
This PR fixes broken Sprint 0 onboarding by aligning all documentation and prompt assets with how GitHub Copilot actually exposes custom slash commands (via each prompt file’s YAML name:), removing stale /prompt-* references that would fail at runtime.
Changes:
- Replaced outdated
/prompt-*command references across README/docs with the real commands (/game-dev,/skills-adoption, etc.). - Updated prompt file headings and architecture docs to reflect the actual prompt inventory and command naming source (
name:field). - Improved newcomer onboarding by adding brief English summaries to Polish-first docs referenced during Sprint 0.
Reviewed changes
Copilot reviewed 15 out of 15 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| SKILLS_RECOMMENDATIONS.txt | Updates the documented adoption mechanism to use the correct /skills-adoption command. |
| README.md | Repairs the Sprint 0 “Next step” onboarding path and adds troubleshooting guidance for missing slash commands. |
| mechanika/README.md | Adds an English summary to reduce the language cliff for mechanics-spec onboarding. |
| docs/COPILOT_WORKFLOW.md | Aligns the workflow guide with actual slash commands and adds a concise English summary. |
| docs/ARCHITECTURE.md | Documents the correct source of slash command names and updates the prompt inventory/tree. |
| .github/prompts/skills-adoption.prompt.md | Updates the prompt’s visible heading to match the actual /skills-adoption command. |
| .github/prompts/pwa-check.prompt.md | Updates the prompt’s visible heading to match /pwa-check. |
| .github/prompts/new-system.prompt.md | Updates the prompt’s visible heading to match /new-system. |
| .github/prompts/new-scene.prompt.md | Updates the prompt’s visible heading to match /new-scene. |
| .github/prompts/new-event.prompt.md | Updates the prompt’s visible heading to match /new-event. |
| .github/prompts/mobile-ux.prompt.md | Updates the prompt’s visible heading to match /mobile-ux. |
| .github/prompts/game-dev.prompt.md | Updates the prompt’s visible heading to match /game-dev. |
| .github/prompts/data-schema.prompt.md | Updates the prompt’s visible heading to match /data-schema. |
| .github/prompts/code-review.prompt.md | Updates the prompt’s visible heading to match /code-review. |
| .github/copilot-instructions.md | Aligns workflow command references and documents that commands come from prompt name: frontmatter. |
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.
The README “Next step” section pointed users to slash commands that do not exist at runtime, which made the documented onboarding path fail immediately. This change audits the repo’s setup docs and aligns all prompt references with how Copilot actually resolves custom prompt commands.
Fix broken prompt invocation docs
'/prompt-*'references with the actual command names exposed by prompt frontmatter, e.g.'/game-dev','/skills-adoption','/new-scene'.Repair README onboarding path
README.md“Next step” into a usable Sprint 0 entry point.package.json, nosrc/, no runnable app commands yet.Sync cross-repo documentation
docs/COPILOT_WORKFLOW.md,.github/copilot-instructions.md, andSKILLS_RECOMMENDATIONS.txtto use the same command vocabulary.docs/ARCHITECTURE.mdto reflect the actual prompt inventory and removed the stalesrc/statestructure reference.Improve newcomer readability
Example of the corrected command mapping: