Spaces:
Sleeping
Sleeping
| # 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. | |