Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk4 min

Why Our Hackathon Made Teams Write a Spec Before They Could Code

At this student hackathon, a mentor-approved specification came before any coding. The organizer’s account explains the workflow, judging rubric, deadline controls and practical snags.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Teams at this student hackathon had to get a mentor-approved specification before opening an IDE. In organizer Maurizio Argoneto’s retrospective, the rule shifted the event’s emphasis: teams still built with coding agents, but they first had to define the problem, intended users and requirements they would use to judge the result.

What the “no coding before approval” rule required

Argoneto says GDG Basilicata, the IEEE Student Branch at the University of Basilicata and the university’s Department of Sciences organized the event for a room sized for 50–80 people. Teams of three or four had an eight-hour build window and used Google’s Gemini models.

As an Amazon Associate I earn from qualifying purchases.

Before coding, every team spent 90 minutes writing a specification and getting a mentor’s approval. The supplied SPEC.md template prompted teams to define:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • The problem and the people the project was for
  • Functional requirements and non-functional constraints
  • The proposed architecture
  • The expected output

According to Argoneto, the template gave less-experienced teams a starting point, while mentor sign-off kept the specification as a required gate rather than an optional planning exercise.

How the build and pitch workflow worked

Cloud-based development

Teams redeemed Google AI Studio API keys and worked in a browser rather than installing GPU drivers or downloading local model weights. After approval, they could use Google Antigravity, Cursor, or VS Code with Gemini Code Assist. The account describes coding agents reading SPEC.md, scaffolding an application and helping connect Gemini API calls. Teams then checked whether the generated work matched their written requirements.

Project choices and final presentation

Teams could choose among four tracks: university study tools, local government and territory services, autonomous agents, and multimodal applications involving text, image, audio or code. Deliverables were limited to a web app, dashboard or AI agent.

For pitch preparation, teams could upload their specification, code and documentation into NotebookLM to produce a three-minute pitch script, a Q&A FAQ and, optionally, an audio overview. These were preparation aids; the live pitch remained part of the judged event.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What the rubric rewarded

Argoneto reports that judges assessed the specification, working demo and pitch. His account assigns 35 of 100 points to SPEC.md and 30 of 100 to the pitch. Those are figures for this event’s rubric, not general hackathon standards; the account does not state the demo’s point allocation.

That weighting made the written plan consequential. Teams were not judged solely on whether they could produce a functioning prototype: they also had to make their intended outcome legible and present it clearly.

How the event enforced its deadline

The schedule moved from room, projector and Wi-Fi checks to check-in and matchmaking, a keynote, specification and mentor sign-off, the coding sprint, integration and polish, and pitch preparation. Submission locked at 17:00. Organizers gave reminders 60, 30 and 10 minutes before the lock, then automatically closed write access to the submission folder. Live pitches followed, each with three minutes to present and two minutes for Q&A.

Argoneto’s summary of the rule was: “The deadline is not a suggestion.” In practical terms, the fixed cutoff and automatic permissions change made the deadline enforceable rather than dependent on teams noticing a reminder.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

What organizers learned from the friction points

Venue connectivity

The author says university Wi-Fi struggled under dozens of simultaneous connections. Organizers requested a dedicated SSID from IT ahead of time and kept a couple of 4G hotspots as backup. This is a contingency described for that event, not a guarantee that mobile service will handle a crowded venue; organizers should confirm coverage where the event is held.

Best Value
Teacher Record Book
  • Keep track of everything from attendance to test scores
  • Spiral bound
  • Measures 8-1/2" x 11"

API-key access

Some students had trouble redeeming Google AI Studio keys, so mentors carried spare keys. The episode illustrates why access checks and a clear fallback matter when a build depends on cloud services.

Writing and interpreting specifications

Teams unfamiliar with specifications stalled early, prompting organizers to use a pre-filled template. In retrospect, Argoneto also identifies earlier mentor briefings, a longer matchmaking window and clearer wording about what counted as “multimodal” as improvements for a future event.

What this format can—and cannot—show

The account is one organizer’s retrospective, not an independently verified event report or a controlled comparison with a hackathon that lets teams code immediately. It supports a practical conclusion about the design: when a specification is required, approved and scored, teams must spend time agreeing on the problem and success criteria before building. It does not establish that this format produces better projects or outcomes than other formats.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For organizers considering a similar rule, the experience points to connected decisions rather than a single policy: reserve time for specification and approval, provide a template, make the rubric reflect the work you value, brief mentors, test account access, and plan for network failure. The source account names five ownership roles: an Event Lead for coordination and university relations; a Logistics & Venue Lead for the room, Wi-Fi, power strips and catering; a Tech & Mentor Lead for API keys and guidance; a Marketing & Community Lead for graphics, social channels and media; and a Platform & Judging Lead for submissions and scoring materials.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.