⚠️ Training repository. Code in main contains deliberate defects used as workshop exercises. Do not copy patterns from this repo into production.

Toko Nusa — Agentic AI in the SDLC workshop

Toko Nusa is a simulated client: an Indonesian home & kitchenware retailer moving its order management online. This repo holds their API, web storefront, and mobile app, plus the docs an agent needs to work on them (business context, PRD, ADRs). It is the hands-on material for a one-day workshop on using AI agents across the software delivery lifecycle.

Stack

App	Stack	Path
API	Python 3.12 · FastAPI · SQLModel · SQLite · pytest	backend/
Web	React 19 · Vite · TypeScript · Vitest + React Testing Library	web/
Mobile	Flutter, web target only · flutter_test	mobile/

Setup

Install git, uv, node ≥ 20, pnpm, task (go-task), claude CLI, python3 ≥ 3.12. Optional: flutter.

git clone git@github.com:zero-one-group/agentic-sdlc-workshop.git
cd agentic-sdlc-workshop
task setup

task setup ends by running task doctor. Paste the task doctor output in #workshop-bali.

Where things are

• Taskfile.yml — every command you need (task --list-all) · CLAUDE.md — the agent's rules
• docs/business-context.md — the client · docs/prd.md — the spec · docs/adr/ — decisions
• workshop/ — worksheets, tickets, and lab instructions per session

Checkpoints

Each session has a tag. If you are lost, jump to the session you are in:

git checkout checkpoint/session-4