Prototyping Skill

United Philosophy

"Make it work, then make it right, then make it fast." - Kent Beck

1. Directory Structure

All prototypes should live in a results/demos/ directory in the root.

results/[YYYY-MM-DD]-[Topic]/demo/
  ├── demo_name/
  │   ├── app.py (entry point)
  │   ├── requirements.txt
  │   └── README.md

2. Technology Stack Recommendations

Interactive Web Apps (Python)

• •Streamlit: Best for data apps, dashboards, and ML demos. Fast iteration.
• •Gradio: Best for exposing ML models with simple inputs/outputs.
• •FastHTML: Good for pure Python dynamic web apps.

CLI Tools

• •Typer or Click: For robust command-line interfaces.
• •Rich: For beautiful terminal output.

Web Content

• •HTML/JS (Vanilla): For simple visualizations or logic.

3. Best Practices

• •Hardcode Data: Don't build a backend unless necessary. Mock data in JSON.
• •Single File: Keep it simple initially. One app.py is often enough.
• •Readme: Always include instructions on how to run it (e.g., pip install -r requirements.txt && streamlit run app.py).