CODEx_USAGE.md

Codex Usage

This repository intentionally documents how Codex contributed to the project so the Codex track can evaluate both the product quality and the development process. The goal is to show a real development trail with Codex-attributed commits, not to maximize token spend, model size, or architectural complexity.

What Codex Helped Build

This repository intentionally documents how Codex contributed to the project so the Codex track can evaluate both the product quality and the development process.

Codex-Assisted Milestones

• Generated the initial Gradio skeleton for Myco's first playable loop.
• Implemented the mushroom discovery engine and companion response flow.
• Added MycoDex collection tracking with duplicate prevention.
• Refactored the app into clearer app.py, game/, models/, ui/, data/, and tests/ sections.
• Added an in-repo mushroom catalog with Common, Rare, and Legendary discoveries.
• Added tests for the catalog, discovery loop, companion replies, collection tracking, and markdown renderers.
• Polished the first impression with a forest hero panel, Myco mascot, custom styling, action buttons, and forest progression goals.
• Added submission-oriented documentation so the Hugging Face Space README can point judges back to the public GitHub repository.

Codex-Visible Development Trail

The repository is intentionally split into meaningful changes that a judge can understand from the Git history, such as:

1. Initialize the project and supporting files.
2. Add the Gradio app entrypoint and dependencies.
3. Create the mushroom catalog and game engine.
4. Implement Myco companion dialogue and MycoDex collection tracking.
5. Refactor into game/, models/, ui/, data/, and tests/.
6. Add tests and submission documentation.

Design Goal

Myco is built to be a polished, small-scope project rather than a sprawling prototype: start exploring, discover a mushroom, ask Myco, choose whether to eat, study, or collect, and make progress through the MycoDex.

PR Workflow Note

Codex currently cannot update a pull request after that PR has been changed outside of Codex. If that happens, continue the work in Codex and open a fresh pull request rather than trying to reuse the externally modified PR.

Submission Reminder

Before submitting the Hugging Face Space, publish the repository, replace the placeholder GitHub URL in README.md with the final public repo link, and confirm the live Space is linked at https://huggingface.co/spaces/build-small-hackathon/Myco.

Design Goal

Myco is built to be a polished, small-scope project rather than a sprawling prototype: explore, discover a mushroom, ask Myco, and add the discovery to the MycoDex.