Skip to content

Adding prompt field and clarifying it from the description field - #27

Open
durkinza wants to merge 2 commits into
mainfrom
feature/challenge-prompt
Open

Adding prompt field and clarifying it from the description field#27
durkinza wants to merge 2 commits into
mainfrom
feature/challenge-prompt

Conversation

@durkinza

Copy link
Copy Markdown
Owner

No description provided.

@durkinza
durkinza requested a review from Copilot December 31, 2025 17:57
@durkinza

Copy link
Copy Markdown
Owner Author

Addresses #18

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces a new prompt field to separate player-facing challenge introductions from coordinator-facing descriptions. The description field is now optional and serves as internal documentation for event coordinators, while the prompt field contains the text shown to players.

Key Changes

  • Added a new prompt field to the challenge schema for player-facing text
  • Made the description field optional and repurposed it for coordinator documentation
  • Updated two example challenges to demonstrate the separation of concerns

Reviewed changes

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

File Description
src/challenge-schema/index.ts Added new prompt field definition and updated description field to be optional with clarified purpose for coordinators
tests/examples/cookie-monster/challenge.json Split original description into a brief prompt and detailed coordinator description
tests/examples/caesar-cipher/challenge.json Split original description into a player prompt and technical explanation for coordinators

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread tests/examples/cookie-monster/challenge.json Outdated
Comment thread tests/examples/caesar-cipher/challenge.json Outdated
Comment thread src/challenge-schema/index.ts Outdated
@durkinza

durkinza commented Jan 2, 2026

Copy link
Copy Markdown
Owner Author

The /docs still need updated to reflect the changes from this PR.

@durkinza

durkinza commented Jan 5, 2026

Copy link
Copy Markdown
Owner Author

I believe this PR may need to be closed or repurposed.

The description field of the challenge.json was originally mean to be the prompt for the player and not a description for the event coordinator. However, this is likely confusing and perhaps the description field should be renamed to clarify.

The description field is not part of a challenge and adds bulk to the challenge.json. Likewise it wouldn't be much help for event coordinators that have a bundled challenge since the challenge schema contain the solutions steps already and that would likely be the only part of the challenge.json important to event coordinators.

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