About this project
A shop run by three AI agents
homeawayfromhome is a demo online shop built by Niel de Kock with Claude, as a capstone project for the Claude Certified Architect – Foundations exam. Nothing is for sale. What's real is how it works: three AI agents, each with its own job, and every rule that matters enforced in code.
The principle
The model decides what is happening; code decides what happens next. The AI understands what a customer means and explains decisions kindly. Whether a refund is allowed, how much, who must approve it and when money moves is decided by code that the AI can't argue with.
What the code guarantees
- Refunds over $50 per case wait for a staff member; over $300, for a manager.
- A return is refunded only after the item arrives and passes a warehouse check.
- Who the customer is comes from their login, never from the AI, so it can't be talked into showing someone else's order.
- The shopping agent can fill a cart but can never place an order: you press the button.
- Two people can't both buy the last item in a size.
- Staff see recommendations from fixed rules, so the same case always gets the same advice.
The three agents
Shop assistant (bottom left): finds and compares products, recommends only from what the shop stocks, and fills your cart.
Help with an order (bottom right): tracks orders, starts returns and refunds within the shop's rules, and hands anything the rules don't cover to a person.
Staff desk: shows staff their work, most urgent first, with a brief per case: facts with their sources, the rule-based recommendation, and a draft reply. A person always makes the decision.
Open either chat and tick “Show what the agent did” to see every tool call and the shop's answer to it.
Delivery & returns
Furniture is delivered by courier and may arrive in more than one box on different days. Unused furniture can be returned within 30 days; a $49 pickup fee applies unless the item arrived damaged.
Most items can be returned within 30 days of delivery, unused and in their original packaging, for a full refund. Refunds over $50 in total are reviewed by our team before they are paid.
Unopened electronics can be returned within 30 days of delivery, opened electronics within 14 days. After that, every device has a 1-year warranty: we repair or replace it free of charge if it stops working, but we do not refund it.
Clothing and shoes can be returned within 30 days if unworn with the tags attached. Swapping for another size of the same item is free while that size is in stock.
Unopened coffee can be returned within 30 days, but not once the bag is opened. For safety, knife sets can only be returned in their sealed box, within 30 days.
Built with the Claude Agent SDK (Haiku 5.5), Python, SQLite and Next.js. Product photos from Unsplash (credits).