Day 6

Module 1 Mini-Project

Build a small but complete project from scratch using only Claude CLI — no manual coding.

0 / 5 tasks

The challenge

Today you'll build a complete small project using Claude as your primary coding tool. The goal is to experience the full development loop: planning, scaffolding, implementing, testing, and documenting — all through Claude CLI.

Project idea: URL shortener

Build a local URL shortener CLI tool that: stores short→long URL mappings in a JSON file, has commands to `add`, `get`, `list`, and `delete` mappings, and shows click counts. This is small enough to complete in one session but touches all the key patterns.

Workflow to follow

bash

# 1. Plan it
claude
> Plan a URL shortener CLI tool using Click and a JSON storage file.
> Define the commands, data model, and file structure.

# 2. Scaffold
> Generate the project structure and boilerplate files.

# 3. Implement
> Implement the 'add' command first, then 'get', 'list', 'delete'.

# 4. Test
> Write unit tests. Run them. Fix failures.

# 5. Document
> Generate a README.md with usage examples.

Practice Tasks

0 / 5

Plan the project easy

Use Claude to plan the project: define scope, commands, data model, and file structure.

Scaffold the structure easy

Have Claude generate all boilerplate files: main.py, requirements.txt, and empty module files.

Implement core features medium

Build all four commands (add, get, list, delete) via Claude. Review each before moving on.

Write and run tests medium

Have Claude generate unit tests, run them, and fix any failures through the Claude REPL.

Write the README easy

Have Claude generate a complete README with installation steps, usage examples, and output screenshots.

← Day 5: Debugging & Problem Solving ↑ Module overview Module 2: CLAUDE.md →