15:00
4 LEVELS · 15 MIN
HACKMERIDIAN · 25 OCT · ONE16 LISBON
Hackathon
Speedrun
How to ship in two days, with AI.
SET UP · HARNESS · ITERATE · PROMOTE
S
H
I
P
YOUR GUIDE FOR THIS RUN
Wlad Mendes
Developer Advocate, Stellar
I help builders ship on Stellar. Find me all weekend.
DISCORD.GG/STELLARDEV
THE ROUTE
14:30
15-MINUTE RUN
Four levels.
One run.
S
Set up
00:00
H
Harness
03:30
I
Iterate
07:00
P
Promote
10:30
S
H
I
P
S
LEVEL 1 OF 4 · SET UP
Plan first. Then build.
HOME ALONE (1990)
S
H
I
P
AI can't make your idea.
It can make it bigger.
YOU
Seed
Your original idea. A problem you have felt yourself.
→
YOU + AI
Thesis
Who it is for, the problem, and why Stellar. Tested with AI and Raven.
↗
↘
PRODUCT
Spec
What to build, and how to check it works.
LOOK
Design
Colors, type and logo, for every screen.
S
H
I
P
One thesis. Two sources. Four deliverables.
SINGLE SOURCE OF TRUTH
THESIS.md
The root. Change it here first, then SPEC.md and DESIGN.md.
→
Landing page
THESIS
DESIGN
Your one-liner, the user and the problem.
→
MVP
SPEC
DESIGN
The demo path from the spec. Nothing more.
→
Video demo
SPEC
DESIGN
The same story, step by step.
→
Submission data
THESIS
SPEC
Name, one-liner, track, repo and links.
THE RULE
Can't say it in one line? Rethink it.
Short
Under 10 words.
Clear
A stranger gets it in 3 seconds.
Concrete
Say what it does. No buzzwords.
S
H
I
P
Say it in one line.
S
H
I
P
Great projects. One line.
Soroswap
“The First DEX Aggregator on Stellar.”
Reflector
“Decentralized price oracle for Stellar Network.”
Trustless Work
“Escrows for Stablecoins Made Easy.”
DeFindex
“Yield Infrastructure for Wallets, Neobanks & Fintech Apps.”
Freighter
“Your Everyday Stellar Wallet.”
S
H
I
P
Yes,
use AI.
Stellar gives your agent the docs, the data and the skills.
set up your agent
Raven MCP · docs + live ecosystem data
$ claude mcp add --transport http stellar-raven \
https://raven.stellar.org/mcp
Stellar Skills · 8 official + community
$ npx skills add https://github.com/stellar/stellar-dev-skill
llms.txt · all the docs in one file
→ developers.stellar.org/llms.txt
stellar-build · 46 skills, 6 personas, Raven
$ curl -fsSL https://raw.githubusercontent.com/\
kaankacar/stellar-build/main/install.sh | bash
S
H
I
P
H
LEVEL 2 OF 4 · HARNESS YOUR AI
“I know kung fu.”
THE MATRIX (1999)
S
H
I
P
Harness your AI.
THESIS, SPEC, DESIGN: what. AGENTS.md: how.
AGENTS.md
tipline/
## Mission
Tipline: tips for street musicians in USDC.
Demo on testnet before Sunday 14:00.
## Ground rules
Read freely. Ask before you push.
Never commit secret keys.
Every Stellar fact needs a source.
## Scope
SPEC.md is the scope. Log the rest.
## Tools
Raven MCP + Stellar Skills, always.
## Working style
Blocked? 1 question + your best guess.
Failed twice? Stop and report.
## Done when
✓ Spec demo path works on testnet
✓ README says how to run it
✓ Tests pass, no keys in git
S
H
I
P
Open from
commit 1.
Work like an open source project. Anyone can read it, run it and help.
tipline
PUBLIC
.claude/skills/
AGENTS.md
THESIS.md
SPEC.md
DESIGN.md
README.md
✓
Public repo on day 1.
✓
AGENTS.md and your 3 docs in the repo.
✓
Spec tasks become GitHub issues.
✓
README: how to run it.
✓
Share your prompts and skills too.
S
H
I
P
I
LEVEL 3 OF 4 · ITERATE
Make 1 thing work.
IRON MAN (2008)
S
H
I
P
Work like an open source team.
Small steps, on GitHub. Every hour.
1
2
3
4
feature/tip-flow
main
Issue
Split the spec into tasks. Give each one an owner.
Branch
One feature branch per issue.
Pull request
Test it, review it, merge it.
Deploy
Run it on Stellar testnet.
Repeat every hour. Stop adding features a few hours before the end.
S
H
I
P
Correct the course on day 1.
Book mentor hours today. Then fix the right file, not just the code.
THE MENTOR SAYS
YOU FIX
THEN UPDATE
“Nobody I know has this problem.”
THESIS.md
→ Spec, design, landing page
“Cut the swap. Keep the payment.”
SPEC.md
→ Issues, MVP and video script
“I can’t tell what the app does.”
DESIGN.md
→ Screens and landing page
S
H
I
P
P
LEVEL 4 OF 4 · PROMOTE
Sell the story, not code.
THE WOLF OF WALL STREET (2013)
S
H
I
P
One story, 3 places.
Same name, same words, same look. Everywhere.
tipline / README.md
# Tipline
Tips for street musicians in USDC.
$ npm run demo
CODE
The README says it in line 1.
tipline.app
Tipline
Tips for street musicians, in USDC.
Send a tip
VISUAL IDENTITY
The landing page says it in the hero.
TIPLINE
Street musicians lose tips.
Tips in USDC, in one tap.
PITCH
The pitch opens with it.
MARKETING IS PART OF THE BUILD
S
H
I
P
Design with AI too.
Write DESIGN.md from your thesis. Then every screen, page and video reuses it.
Aa
DESIGN.MD
Look first
Ask your AI for colors, type and a logo. Save them in DESIGN.md.
UI
Screens
Claude Design, Figma Make, Stitch or v0: a prompt becomes a UI.
▶
VIDEO
Demo video
Remotion or HyperFrames: your demo video, made with code.
One look in the app, the landing page and the video.
S
H
I
P
Show it. Don't tell it.
A 3-minute demo, in four parts.
0:00 – 0:30
Problem
0:30 – 2:00
Live demo
2:00 – 2:30
How
2:30 – 3:00
Next
One user. One pain.
The one flow, live on testnet. Keep the video ready as a backup.
Why Stellar. What you integrated.
The path to mainnet.
Judges score demos, not ideas.
PRACTISE WITH A TIMER
S
H
I
P
Two days to ship.
YOU ARE HERE
Now
FIRST HOUR
Set up Raven and Skills.
Thesis, spec, design.
Open repo with issues.
25 Oct
BUILD
Build the demo path.
Book mentor hours.
Deploy to testnet early.
26 Oct
SHIP
Stop new features.
Record the video.
Submit 1 hour early.
After
MERIDIAN · SCF
Meridian, 28–29 Oct.
SCF #46 closes 8 Nov.
Ship in public.
HackMeridian ends. Meridian begins.
23 / 23
SET UP · HARNESS · ITERATE · PROMOTE
What are you
going to SHIP?
Up to $30K in XLM. Top projects move on to Meridian, 28–29 October.
START THE RUN →
SCAN FOR THE SLIDES