Used PI to create a bigbang simulator from scratch with no user generated code (only generated by the LLM) and a local instance of Qwen3.5 9B. Testing the Pi agentic coding harness from @mariozechner (
npm install -g @mariozechner/pi-coding-agent)
- Makefile 49.3%
- C 43.9%
- CMake 5.4%
- Shell 1.3%
| build_default | ||
| docs | ||
| include | ||
| src | ||
| .gitignore | ||
| animation.o | ||
| bigbang_config.json | ||
| bugfixes.jsonl | ||
| bugfixes2.jsonl | ||
| build_config.sh | ||
| CMakeLists.txt | ||
| CMakePresets.json | ||
| codex-prompt.txt | ||
| constants.o | ||
| cosmology | ||
| event.o | ||
| logger.o | ||
| main.o | ||
| Makefile | ||
| particle.o | ||
| PHASED_TODO.md | ||
| physics.o | ||
| pi-conversation-2.txt | ||
| pi-conversation-3.jsonl | ||
| pi-convo-spec.jsonl | ||
| pi-convo.jsonl | ||
| simulation.o | ||
| TODO.md | ||
Big Bang Simulator Documentation
Overview
This documentation folder contains all technical documentation for the Big Bang Simulator project.
Documentation Files
Essential Documentation
- CODEBASE_ANALYSIS.md - Complete analysis of all issues and bugs
- FIXES_IMPLEMENTATION_PLAN.md - Detailed fix implementation plan
- PHASED_TODO.md - Phased development roadmap
Development Documentation
- OUTPUT_VISUALIZATION_PLAN.md - Original visualization planning
- QUICK_START_VIZ.md - Quick start guide for visualization
- REFERENCE.md - Technical reference documentation
- README.md - This file
Getting Started
For Developers
- Understand the Issues: Start with CODEBASE_ANALYSIS.md to understand all known problems
- Review the Plan: Read FIXES_IMPLEMENTATION_PLAN.md for specific implementation details
- Follow the Roadmap: Use PHASED_TODO.md to track development progress
For Users
- Quick Start: See QUICK_START_VIZ.md for basic usage
- Reference: Check REFERENCE.md for detailed documentation
Current Status
Critical Issues
- Terminal Display: Broken - requires immediate attention
- Menu Interaction: Broken - prevents user input
- I/O Conflicts: Broken - causes terminal corruption
Development Phases
- Phase 1 (Foundation): Not started
- Phase 2 (Visualization): Not started
- Phase 3 (Integration): Not started
- Phase 4 (Features): Not started
- Phase 5 (Simulation): Not started
Quick Reference
Building the Project
cd /path/to/bigbang-simulator
cmake --build build_default
Running the Simulator
./build_default/bigbang_sim [options]
# Help
./build_default/bigbang_sim --help
# Menu mode
./build_default/bigbang_sim -m -t 1000
# Full simulation
./build_default/bigbang_sim -t 5000
Known Issues
See CODEBASE_ANALYSIS.md for complete list of issues.
Contributing
When contributing fixes or features:
- Review CODEBASE_ANALYSIS.md to understand existing issues
- Follow the implementation plan in FIXES_IMPLEMENTATION_PLAN.md
- Adhere to the phased roadmap in PHASED_TODO.md
- Ensure all fixes are tested on multiple terminal emulators
- Document all changes in this folder
Contact
For questions or issues, refer to the detailed documentation in this folder.
Last Updated: 2026-04-10
Version: 1.0