🚀 Todo In-Memory Python Console App – Phase I (Hackathon II)

🎯 Project Overview

This repository contains Phase I of the "Evolution of Todo" project for Hackathon II by Panaversity.

Goal: Act as a Product Architect using Spec-Driven Development to build progressively complex software without writing boilerplate code manually.

Phase I focuses on creating a simple command-line todo application that stores tasks in memory, implementing the five basic features:

• ➕ Add Task (with title and description)
• 📋 View Task List (with status indicators)
• ✏️ Update Task details
• 🗑️ Delete Task by ID
• ✅ Mark as Complete / Incomplete (toggle)

All implementation is done exclusively via Claude Code guided by refined specifications using Spec-Kit Plus.
No manual coding allowed — every line of code is generated by AI based on the spec.

This phase lays the foundation for the full evolution:
CLI → Web App → AI Chatbot → Kubernetes → Cloud-Native Distributed System.

🛠️ Technology Stack

• Python 3.13+
• Standard library only
• Claude Code (AI code generation)
• Spec-Kit Plus (specification management)
• UV (dependency management – no external deps in Phase I)

📂 Repository Structure

hackathon-todo/
├── /src/                     # Python source code
├── /specs/                   # Current specification files
├── /specs-history/           # Archived spec versions
├── /sp.constitution          # Core principles & constraints
├── CLAUDE.md                 # Instructions for Claude Code
├── README.md                 # This file

⚙️ Setup Instructions

General Setup

git clone https://github.com/HasnainDevMaster/Todo-In-Memory-Python-Console-App.git
cd Todo-In-Memory-Python-Console-App
git checkout 1-todo-console-app

Create virtual environment:

uv venv
source .venv/bin/activate    # Linux/macOS
# or .venv\Scripts\activate  # Windows

▶️ Running the App

uv run python src/main.py
# or
python src/main.py

The app runs an interactive console session with in-memory task storage.

✨ Features Demonstrated

• ➕ Adding tasks with title and description
• 📋 Listing all tasks with clear status indicators ([ ] / [x])
• ✏️ Updating existing task details
• 🗑️ Deleting tasks by ID
• ✅ Toggling task completion

🧠 Development Process

Built using the Agentic Dev Stack:

1. Wrote /sp.constitution → core principles
2. Defined /sp.specify → requirements & success criteria
3. Clarified ambiguities → interaction model, IDs, indicators
4. Created /sp.plan & /sp.adr → architecture decisions
5. Broke into atomic /sp.tasks
6. Analyzed coverage & alignment
7. Generated all code via Claude Code prompts

Strict adherence: No manual code edits. All implementation traceable to tasks and specs.

🌟 Why This Matters

This phase masters:

• Spec-Driven Development
• AI as Implementer (Claude Code)
• Clean architecture from day one
• Foundation for future phases (web, AI chatbot, Kubernetes)

Ready for the next evolution! 🚀

Built for Panaversity Hackathon II – Mastering the Architecture of Intelligence.