User Hackathon: Module 5 Mastery Challenge (The Question Paper)

[!CAUTION] This is a Hands-Off challenge. Do not manually write code. Your role is as a Commander. You will demonstrate 10x Velocity using Spec-Driven Development (SDD).

---

1. Challenge Overview

Objective: Use the Spec-First method. Draft a professional Markdown specification for a small, functional system. The goal is to get a completely working, test-covered implementation from the AI in under 3-5 prompts.

Time Limit: 4-8 hours Tooling: Any agentic AI coding assistant (Cursor, VS Code + Agents, Aider, or equivalent).

---

2. Choose Your Mission

Choose ONE of the following scenarios to execute using SDD.

Option A: Real-Time Data Dashboard

Command the agent using a spec that:

• Requirement 1: Consumes a mock API of "Sensor Data" (Temp, Humidity).
• Requirement 2: Displays a live, auto-updating dashboard using Mermaid Pie or Line Charts.
• Requirement 3: Includes an "Emergency Alert" function that triggers when Temp exceeds 50.
• Goal: Show its Logic Mapping and Velocity of Scaffolding.

Option B: AI-Powered Customer Portal

Develop a system using a spec that:

• Requirement 1: Allows a user to submit a support ticket via a simple UI.
• Requirement 2: Automatically classifies the ticket priority (High, Med, Low) using a local LLM call.
• Requirement 3: Responds with a "Next Steps" email template based on the priority.
• Goal: Show its Complexity Handling and High-Fidelity Context Window Integration.

---

3. Strict Rules & Constraints (SDD Rules)

1. Spec-First Only: You must write the entire Markdown spec before you ask the agent to write a single line of code.
2. Unambiguous Data: Your spec must include either a JSON or TypeScript interface for every key data movement.
3. One-Shot Target: Aim to get the core logic right in the first generation. Every follow-up fix counts against your score.
4. Proof of Test: Every generated service must come with an automated unit test that verifies its success against your spec.

---

4. Evaluation Rubric

---

5. Submission Requirements

To pass this hackathon, you must provide:

1. The Master Spec: Your .md file that you gave to the AI.
2. The Generation Log: Proof that you achieve the build in <5 prompts.
3. The Result: The final, functional project codebase.
4. Speed Reflection: How did SDD change the time you spent "thinking" vs. "fixing bugs"?

[!IMPORTANT] Good luck, Commander. Speed is the byproduct of precision.