Skip to content

CLAUDE.md

Latest commit

 

History

History
44 lines (30 loc) · 1.23 KB

CLAUDE.md

File metadata and controls

44 lines (30 loc) · 1.23 KB

CLAUDE.md

Project-specific instructions for Claude Code when working on mint-cli.

What this is

mint-cli is a personal CLI tool for scaffolding new projects. It suggests names via DigitalOcean's inference API, creates the directory, initializes git, and opens WHY.md.

What this is NOT

  • Not a project manager or organizer
  • Not for cloning, forking, or searching existing projects
  • Not a template system - every project gets docs/WHY.md and docs/DECISIONS.md
  • No user config files - edit config.py directly

Project structure

mint.py      - Main script (all logic here)
mint.sh      - Shell wrapper (enables cd into new project)
config.py    - Settings (BASE_PATH, EDITOR, NUM_SUGGESTIONS)

Key commands

# Run directly
python3 mint.py

# With shell wrapper (enables auto-cd)
source mint.sh

# Skip AI, create directly
python3 mint.py my-project

Design principles

  • One script, not a package - this is a personal tool
  • WHY.md forces articulating vision before coding, DECISIONS.md logs choices during build
  • Shell wrapper exists because Python can't change parent shell directory
  • 5 suggestions to avoid decision fatigue, with regenerate option
  • AI suggestions are optional - falls back to manual name entry