01. repo template
A working repo template.
The structure your agent reads from on every session. /spec, CLAUDE.md, AGENTS.md, the four files in /spec. Forkable.
01
TRAINING
Or learn to do it yourselves.
Two programmes, two audiences — both taught by the Principal AI and Product Management Consultant who built the methodology, with the team that runs every engagement. No account managers, no junior consultants.
// 01 — the specshop method
Spec-first software development
AI-native engineering, taught by the team that built the methodology. Nine years and 120+ products of spec-first delivery, compressed into a cohort. Two tracks — senior engineers, and graduates.
cohort-based · per seat
$500 – $2,000
// 02 — AI for business
Run your business on autopilot
For owners and operators, not engineers. Map the work that wears your team down, learn which parts hand over safely, and leave with one workflow specified and ready to staff. No code, no jargon.
one day, Dubai · per seat
register interest
02
THE SPECSHOP METHOD
// 01 — the problem
You’ve already lived this.
You’ve shipped with Claude Code. You’ve also seen a confident hallucination get to staging. A refactor that wasn’t. A six-hour loop on a typo. Three weeks of subtle naming drift, found at merge.
The tools are real. The output, sometimes, is not. The next phase isn’t more AI. It’s method for AI.
- // confident hallucination The agent invents an API that looks plausible. The PR looks fine. CI passes. It ships. It breaks in production a week later, on a code path nobody read.
- // refactor-that-wasn’t You asked for a refactor. You got a rewrite that changed the semantics in three places you didn’t notice until QA found them.
- // six-hour loop The agent gets stuck. You don’t notice for an hour because it’s chatting confidently. By the time you intervene, you’ve burned half a day and a hundred dollars in tokens on a typo.
- // naming drift The agent picks names that are reasonable in isolation but wrong in context. Three sprints later your codebase has four words for the same thing and nobody knows which one is canonical.
- // scope creep "While I was in there, I noticed…" The agent helpfully fixes things you didn’t ask it to. The PR is now 600 lines and impossible to review.
- // review collapse Reviewers stop reading carefully because the code looks too clean. Nobody’s reading the spec because there is no spec. Bugs slip through that a junior would have caught.
// 02 — the thesis
The spec is the unit of work.
Not the prompt. Not the chat. Not the PR. The spec.
Every failure above is a spec failure dressed up as something else. Hallucination is a spec that didn’t constrain the API surface. Refactor-that-wasn’t is a spec that didn’t define non-goals. Naming drift is a spec that didn’t include a glossary. Once you write the spec the agent should be reading, the failure modes become legible — and most of them stop happening.
01.
Spec, not prompt.
The spec is a decision-grade document the agent reads before it reads your message. Problem, constraints, non-goals, success criteria. The prompt becomes a thin layer on top.
02.
Plan, analyse, design, re-plan.
A four-step loop the agent runs against the spec, not against your last instruction. The loop is what makes the work survive a long session without drift.
03.
Scaffolding that doesn’t rot.
Variables, decisions, manuals — versioned alongside the code. The artifacts that let the next session pick up where this one stopped without re-explaining the whole project.
// 03 — what you’ll build
Engineers buy outcomes, not curricula.
By the end of weekend two, you walk away with four things. Not slides. Not a workbook. Four things you can take into Monday.
02. shipped feature
A shipped feature against your own spec.
Real code, against a real codebase you bring with you, demoed live in front of the cohort on day four.
03. the method, documented
A documented methodology.
The four-step loop, the failure forensics, the spec format — written down in your words so you can take it back to your team without re-deriving it.
04. the cohort
Twenty-nine peers across the Gulf and SL.
A Slack that stays open after the cohort ends. Engineers who’ve lived the same failure modes and committed to the same method.
// 04 — the shape
Two weekends. Four sessions.
Eighteen hours total. Ten hours live across four sessions. Eight hours async between weekends, paced by structured touchpoints. No prerecorded content; this is a workshop, not a course.
// weekend 1 — saturday
Failure forensics + the stack you actually need.
Diagnose. We catalogue the failure modes you’ve already lived through and name them precisely. No code yet. The diagnosis is the foundation.
// weekend 1 — sunday
The spec, part one.
Live spec writing against a real codebase you bring. Repo setup. The four files in /spec. By end of session you have a spec the agent can read from.
// weekend 2 — saturday
Driving the agents + maintenance.
The four-step loop, run live in front of the room. How to intervene. How to scope. How to maintain the spec as the code grows. When each tool wins, when each fails.
// weekend 2 — sunday
Build sprint, demo day.
Ship a feature against your spec. Demo it to the cohort. Take questions. The artifact you leave with is the demo.
// 05 — what makes this different
Method, not vibes.
There are three legitimate methodologies for working with AI coding agents — spec-first, eval-first, and vibe-then-verify. Each has a place. This programme teaches one of them, and is honest about it.
| If you’re considering | Our distinction |
|---|---|
| YouTube tutorials, Twitter threads | Live, structured, accountable. You demo in front of the room. |
| Generic prompt engineering courses | We don’t teach prompts. We teach specs. The prompt is downstream. |
| Internal experimentation at your company | Twenty-nine peers across the Gulf and SL, structured failure forensics, named methodology. |
| Vibe-coding bootcamps | This is spec-first by design. If you want to feel it out, this isn’t the cohort. |
| Hiring a consultant | This trains you to do the work. Cheaper, more durable, transferable to your team. |
// 06 — who this is for
An honest filter.
The hard floor is two years of professional engineering and at least one feature shipped with an AI coding agent. Below that and the cohort doesn’t work for you. Above that and the failure modes will be familiar.
// this is for you if
- You have two-plus years of professional engineering experience.
- You’ve shipped at least one feature using Claude Code, Cursor, Devin or Aider.
- You build B2B software, internal tools, or regulated work where "looks about right" doesn’t ship.
- You can attend live SGT-time sessions across two weekends.
- You read documentation. You write ADRs sometimes. You have opinions about naming.
// this is not for you if
- You’re new to engineering or to AI coding tools.
- You build consumer-facing experimental products where vibes are fine.
- You want async-only learning. This is live.
- You’re looking for a tools tutorial or a prompt collection.
- You can’t make three of four live sessions.
// questions
What people usually ask.
What’s the time commitment?
Two Saturdays and two Sundays, three and a half to four hours each, plus about three hours async between weekends. Eighteen hours total across two consecutive weekends.
What time zone?
SGT, 10:00 start. Confirmed at signup. Recordings are released within six hours, but live attendance is the default. If you can’t make three of four sessions live, this isn’t the right cohort.
What does it cost?
$500 – $2,000 per seat, depending on the track — senior engineers or graduates. Invoiced to you or to your company.
Do I need to know Claude Code specifically?
No. We cover Claude Code, Cursor, Devin and Aider. You should have used at least one of them to ship a feature. Tool-specific tutorials live on YouTube; we teach when each tool wins and when each fails.
What’s spec-first vs eval-first vs vibe-then-verify?
Three legitimate methodologies for working with AI coding agents. Spec-first front-loads the contract: the agent reads a decision-grade spec before the prompt. Eval-first front-loads the test: you write the eval, then let the agent satisfy it. Vibe-then-verify lets the agent run loose, then formalises post-hoc. We teach spec-first because it’s the methodology that holds up best for B2B software, internal tools, and regulated work, and we say so on the page.
What language is the programme in?
English.
Is there a certificate?
Yes, available on request. It’s not the point. The repo and the method are the point.
Can my company pay?
Yes. We provide invoices. We also run private cohorts for teams of ten and above; ask us when you apply.
Who’s running this?
Janaka Ediriweera, Principal AI and Product Management Consultant at specshop.dev, with a team of seven. Nine years of spec-first delivery across more than a hundred and twenty products in five countries.
What happens after the cohort?
The cohort Slack stays open. One-to-one advisory and a contractor pipeline are available for top performers.
03
AI FOR BUSINESS
Run your business on autopilot.
For owners and operators, not engineers. Map the work that wears your team down, learn which parts hand over safely, and leave with one workflow specified and ready to staff. No code, no jargon. If you would rather map and build the first workflow yourself, start with AI for small business in Sri Lanka and then come to the one-day workshop.
One day, in Dubai. Dates and price are announced to the interest list first.
04
FROM THE JOURNAL
Read before you apply.
- The first thing this programme teaches is the artefact, so read how to write a spec for AI agents before you apply and you will arrive with something to work on.
- If you want the plain explainer before you read the syllabus, start with spec-first development, explained, which walks through the loop this programme teaches.
- If you are still comparing options, AI courses in Sri Lanka sets out the four types of course, the published fees in rupees, and where each one stops.
05
NEXT STEP
Thirty minutes. We’ll tell you whether this is worth your time.
Tell us who on your team needs this and what they already ship. We’ll tell you which track fits — and if neither does, we’ll say so.
Colombo · Muscat · Dubai — a team of seven, every engagement, end to end.