Kopiera denna mall och skeppa snabbare

Du har läst om TRD:er. Canvas-samordning. Backloghantering. ADR:er. Nu kommer den svåraste delen:

Faktiskt göra det.

De goda nyheterna: du behöver inte bygga detta från grunden. Mallen finns. Prompterna är skrivna. Strukturen är redo. Du behöver bara kopiera den, anpassa den och börja använda den.

Här är hur man går från noll till skeppning på 5 steg.

Snabbstart (5 steg, 60 minuter)

Steg 1: Kopiera mallen (5 minuter)

Klona eller kopiera .assistant/-katalogstrukturen till ditt projekt:

ditt-projekt/
├── .assistant/
│   ├── assistant.yaml       # Konfiguration
│   ├── status.md            # Nuvarande projekttillstånd
│   ├── plan.md              # Nu/Nästa/Senare-tidslinje
│   ├── backlog.md           # Granulära uppgifter
│   ├── task_log.md          # Sessionslogg
│   ├── history.md           # Projekttidslinje
│   ├── canvas/              # Strategisk kontext
│   │   ├── vision.md
│   │   ├── goals.md
│   │   ├── stakeholders.md
│   │   ├── questions.md
│   │   ├── ideas.md
│   │   └── notes.md
│   ├── adr/                 # Arkitekturbeslut
│   │   ├── README.md
│   │   └── ADR-TEMPLATE.md
│   └── prompts/             # AI-prompter för varje fas
│       ├── project_startup.md
│       ├── kickoff.md
│       └── end_session.md
└── Makefile                 # Hjälpkommandon

Vad varje fil gör:

assistant.yaml: Pekar på entrépunkter för LLM-regler
status.md: Enda sanningskällan för nuvarande fokus, risker, artefakter
plan.md: Nu (denna sprint), Nästa (kommande), Senare (backlog)
backlog.md: Granulära uppgifter med acceptanskriterier
task_log.md: Append-only-logg av varje arbetssession
canvas/: 6 filer för strategisk samordning (vision, mål, intressenter, frågor, idéer, anteckningar)
adr/: Architecture Decision Records
prompts/: ChatGPT/Claude-prompter för varje arbetsflödesfas

Steg 2: Generera din TRD med ChatGPT (20 minuter)

Använd TRD-prompten från Del 2:

Du är en specialist på tekniska krav. Generera ett Technical Requirements Document (TRD) baserat på följande projekt:

Problem: [Beskriv vad du löser]
Målanvändare: [Vem är detta för?]
Nyckelfunktioner: [Punktlista över kärnfunktionalitet]
Begränsningar: [Tekniska, regulatoriska eller affärsmässiga begränsningar]

TRD:n ska inkludera:
1. Executive summary (2-3 meningar)
2. Problembeskrivning
3. Målanvändare och personas
4. Kärnfunktionella krav (numrerad lista)
5. Icke-funktionella krav (prestanda, säkerhet, compliance)
6. Explicita icke-mål (vad vi INTE bygger)
7. Framgångskriterier (mätbara utfall)
8. Tekniska begränsningar och beroenden
9. Risker och antaganden

Formatera som markdown. Var specifik men koncis. Använd SMART-kriterier för framgångsmått.

Fyll i dina projektdetaljer och klistra in i ChatGPT. Förfina outputen. Spara den som .assistant/TRD.md.

Steg 3: Fyll i canvas (30 minuter)

Öppna canvas-filerna och besvara de strategiska frågorna. Gör detta med ditt team om möjligt.

vision.md (10 minuter)

# Vision

## Syfte
[Var är detta projekt på väg om 12 månader?]

## Framgångssignaler
[Vad kommer vara sant om detta lyckas? Var specifik.]

## Icke-mål
[Vad gör vi uttryckligen INTE?]

Exempel:

## Syfte
Bygg en integritetsfokuserad analysdashboard för indie SaaS-utvecklare som vill ha GDPR-kompatibel spårning utan vendor lock-in.

## Framgångssignaler
- 500 aktiva utvecklare som använder vår SDK
- 10k spårade händelser per dag
- Featured på Hacker News "Ask HN: Analytics-alternativ till GA4"
- NPS >50 från beta-användare

## Icke-mål
- Inga företagsfunktioner (SSO, compliance-certifieringar)
- Ingen visuell trattbyggare (kod-först-produkt)
- Konkurrerar inte med Google Analytics på funktioner

goals.md (10 minuter)

# Mål

## Kortsiktigt (4 veckor)
[Vad skeppas denna månad? Var mätbar.]

## Medellångsiktigt (12 veckor)
[Vad skeppas detta kvartal?]

## Långsiktigt (6 månader)
[Vad är 6-månaders milstolpen?]

Exempel:

## Kortsiktigt (4 veckor)
- Skeppa JavaScript SDK (npm-paket) med händelsespårning + sidvisningar
- Deploya backend-API till produktion (99,9% upptid)
- Publicera API-dokument + 2 snabbstartshandledningar

## Medellångsiktigt (12 veckor)
- Nå 50 aktiva utvecklare
- Lägg till React/Vue-ramverksintegrationer
- Lansera integritetsfokuserad marknadsföringssajt

## Långsiktigt (6 månader)
- Nå 500 aktiva utvecklare
- Generera 2k SEK MRR från premiumtier (anpassade domäner + utökad retention)
- Öppna källkoden för kärn-SDK

stakeholders.md (5 minuter)

# Intressenter

[Vem använder detta? Vem betalar? Vem bygger? Vad förväntar de sig?]

Exempel:

## Primära användare
- Indie SaaS-utvecklare (solo eller 2-3 personsteam)
- Tekniska grundare utan analysexpertis
- Utvecklare som migrerar från Google Analytics eller Plausible

Förväntningar: Snabb installation (<10 min), GDPR-kompatibel som standard, transparent prissättning

## Beslutsfattare
- Tekniska grundare (utvärderar på enkelhet i integration, kostnad, kontroll)

## Internt team
- 1 backend-ingenjör (Node.js/Postgres)
- 1 frontend-ingenjör (React/dokument)
- Grundare hanterar produkt + marknadsföring (deltid)

questions.md (5 minuter)

# Frågor

[Vad vet du inte ännu? Vad behöver forskning eller testning?]

Exempel:

## Användarforskning
- F1: Föredrar utvecklare själv-hostad eller SaaS-deployment?
  - Forskning: Undersök 30 beta-användare, analysera prissidklick
- F2: Vilken retention-period förväntar användare (30 dagar? 90 dagar? 1 år?)
  - Forskning: Konkurrensanalys + användarintervjuer

## Tekniskt
- F3: Kan vi hantera 100k händelser/dag på en enda $50/månad-server?
  - Forskning: Lasttestning med realistiska händelsepayloads
- F4: Ska händelser processas synkront (realtid) eller asynkront (kö)?
  - Beslut: Benchmarka båda, skriv ADR

## Affärsmässigt
- F5: Prissättning—$9/månad platt eller $0.10 per 1k händelser?
  - Forskning: Testa landningssida med båda modellerna, spåra konverteringsfrekvenser

Lämna ideas.md och notes.md tomma tills vidare—de fyller på när du jobbar.

Steg 4: Skapa din plan (5 minuter)

Extrahera funktioner från TRD:n och organisera dem i Nu/Nästa/Senare:

# Plan

## Nu (skeppas denna sprint)
- [ ] Skeppa JavaScript SDK med händelsespårning
- [ ] Deploya backend-API till produktion
- [ ] Publicera snabbstartsdokument

## Nästa (kommer efter Nu)
- [ ] React/Vue-integrationspaket
- [ ] Dashboard-UI för att visa analys
- [ ] Faktureringintegration (Stripe)

## Senare (idéer, inte förbundna)
- [ ] Mobil-SDK (iOS/Android)
- [ ] Dataexport-API
- [ ] Anpassade händelsescheman

Regel: Lägg bara 3-5 objekt i “Nu.” Om allt är brådskande är ingenting det.

Steg 5: Starta din första session (kommandoreferens)

Använd Makefile-kommandona för att börja jobba:

# Starta ett nytt projekt (initial installation)
make project-start

# Starta en arbetssession (dagligt arbetsflöde)
make session-start

# Avsluta en arbetssession (dagligt arbetsflöde)
make session-end

Vad `make session-start` gör

Skriver ut sessionskickoff-prompten:

# Sessionskickoff

1. Läs `.assistant/status.md` — Vad är det nuvarande fokuset?
2. Läs `.assistant/plan.md` — Vad finns i "Nu"?
3. Välj EN uppgift från backlog att jobba på idag
4. Uppdatera status.md med dagens fokus
5. Börja bygga

Vad `make session-end` gör

Skriver ut avslutningsprompten:

# Avsluta session

1. Vad slutförde du idag? Uppdatera backlog-checkboxar
2. Vilka beslut fattade du? Skriv ADR:er vid behov
3. Uppdatera `status.md`-ändringslogg med framsteg
4. Logga session i `.assistant/task_log.md` (verktyg använt, argument, resultat)
5. Committa ändringar med uppgifts-ID i meddelande

Kommandofuskark

# Projektlivscykel
make project-start       # Initial TRD → Canvas → Plan → Backlog-installation
make session-start       # Påbörja dagligt arbete
make session-end         # Avsluta och logga framsteg

# Kolla nuvarande tillstånd
cat .assistant/status.md        # Vad händer nu?
cat .assistant/plan.md          # Vad är tidslinjen?
cat .assistant/backlog.md       # Vilka uppgifter finns?

# Referera ADR:er
ls .assistant/adr/              # Lista alla beslut
cat .assistant/adr/ADR-003.md   # Läs specifikt beslut

Vanliga installationsmisstag (och hur man fixar dem)

Misstag 1: Hoppa över canvas

Problem: Du fyller i TRD:n men hoppar över canvas, så ingen samordnar om vision/mål/intressenter.

Lösning: Boka 30 minuter. Fyll i vision, mål, intressenter innan du skriver kod.

Misstag 2: Göra “Nu” för stor

Problem: Du lägger 20 objekt i “Nu.” Ingenting skeppas eftersom du jonglerar för mycket.

Lösning: Begränsa “Nu” till 3-5 objekt. Allt annat går i “Nästa” eller “Senare.”

Misstag 3: Vaga backlog-objekt

Problem: Uppgifter som “Bygg dashboard” utan acceptanskriterier.

Lösning: Bryt ner det: “DASH-001: Visa totalt händelseantal från API” med specifika checkboxar.

Misstag 4: Glömma uppdatera status

Problem: status.md är gammal, så ingen vet vad som händer.

Lösning: Kör make session-end varje gång du slutar jobba. Tvinga vanan.

Misstag 5: Skriva ADR:er för allt

Problem: Du dokumenterar triviala val (“Använd Prettier för formatering”) och ADR-trötthet sätter in.

Lösning: Skriv bara ADR:er för arkitektoniska beslut (databas, auth-strategi, hostingplattform). Inte kodstil eller implementeringsdetaljer.

FAQ

F: Behöver jag alla dessa filer? Verkar överdrivet för ett solo-projekt.

S: Börja med det väsentliga:

TRD
vision.md + goals.md
plan.md
backlog.md
status.md

Hoppa över resten tills du behöver dem. Men du blir förvånad hur snabbt “Jag kommer ihåg detta” blir “Vad höll jag på med igen?”

F: Vad om jag redan är mitt i projektet? Kan jag anta detta retroaktivt?

S: Ja. Börja med att:

Skriva en TRD som fångar vad du byggt hittills + vad som återstår
Fylla i status.md med nuvarande fokus, risker, artefakter
Migrera din att-göra-lista till backlog.md med acceptanskriterier
Skriva ADR:er för stora beslut redan fattade (även retroaktivt)

Du förlorar lite kontext, men framtida sessioner blir tydligare.

F: Hur passar detta med Agile/Scrum?

S: Detta är Agile—bara dokumentations-först. Tänk på det som:

TRD = Produktkrav
Canvas = Sprint Planning-kontext
Plan = Sprint Backlog (Nu = nuvarande sprint)
Backlog = User Stories med acceptanskriterier
Status = Sprint Board / Daily Standup-dokument

Det är kompatibelt med Scrum, Kanban eller “vi skeppar bara saker.”

F: Vad om mitt team inte antar detta?

S: Börja solo. Använd det för ditt eget arbete. När teammedlemmar frågar “Vad är statusen?” eller “Varför valde vi X?”, peka dem på status.md eller en ADR.

När de ser värdet kommer de anta det. Om de inte gör det… kanske bryr de sig inte om dokumentation, och det säger något.

F: Behöver jag speciella verktyg?

S: Nej. Du behöver:

Markdown-filer (vilken textredigerare som helst)
Git (versionskontroll)
ChatGPT (för att generera TRD, valfritt)
Make (för hjälpkommandon, valfritt)

Det är allt. Ingen JIRA, ingen Notion, ingen Airtable. Bara filer i din repo.

F: Hur ofta ska jag uppdatera dessa filer?

status.md: Varje session (dagligen om du jobbar dagligen)
backlog.md: När uppgifter slutförs eller läggs till
plan.md: Veckovis (flytta objekt från Nästa → Nu när du slutför)
TRD: När krav ändras betydligt
Canvas: Månadsvis eller när strategisk riktning skiftar
ADR:er: När du fattar ett stort tekniskt beslut

Verktyg du behöver

Nödvändigt

Textredigerare (VS Code, Vim, Sublime, vad som helst)
Git
Grundläggande shell (bash/zsh)

Valfritt men rekommenderat

ChatGPT Plus (för att generera TRD:er, utkasta backlog-objekt)
Make (för hjälpkommandon—kan också bara kopiera/klistra in prompter manuellt)
VS Code Copilot (AI-assistans vid kodning)

Inte nödvändigt

JIRA, Asana, Monday.com (spårning sker i markdown)
Notion, Confluence (dokument finns i din repo)
Miro, FigJam (canvas är bara 6 markdown-filer)

Nästa steg

Kopiera mallen till ditt projekt
Spendera 20 minuter på att generera en TRD (använd ChatGPT-prompten)
Boka 30 minuter för att fylla i canvas med ditt team
Extrahera 3 objekt för “Nu” i plan.md
Börja bygga (make session-start)

Det är allt. Du har nu:

Tydliga krav (TRD)
Strategisk samordning (Canvas)
Exekverbar plan (Plan → Backlog)
Framstegsspårning (Status + Task Log)
Beslutshistorik (ADR:er)

Allt i markdown-filer. Versionskontrollerade. Bredvid din kod.

Dela din upplevelse

Denna mall finns eftersom planering i Slack inte fungerar. Om du provar detta tillvägagångssätt vill jag gärna höra:

Vad fungerade?
Vad kändes överdrivet?
Vad anpassade du?
Vad hoppade du över?

Släpp mig en rad: [email protected]

Och om detta hjälper dig skeppa snabbare, dela det med ditt team. Ju fler som planerar som de skeppar kod, desto mindre tid slösar vi alla med att omförhandla beslut eller återbygga funktioner vi trodde var klara.

Seriesammanfattning:

Del 1: Sluta planera i Slack — Problemet med spridd planering
Del 2: Från ChatGPT till kod: TRD-first arbetsflödet — Generera krav på 20 minuter
Del 3: Canvas-tänkande: Samordna innan du bygger — Strategisk kontext förhindrar felaktig samordning
Del 4: Från backlog till klart: Spåra verklig framsteg — Förvandla planer till skeppat arbete
Del 5: Varför vi dokumenterar beslut (och hur ADR:er sparar tid) — Fånga “varför” innan det försvinner
Del 6: Kopiera denna mall och skeppa snabbare — Du är här

Nyckelord: projektmall, komma-igång-guide, projektinstallation, agilt arbetsflöde, utvecklarproduktivitet, projektledningshandledning

Snabbstart (5 steg, 60 minuter)

Steg 1: Kopiera mallen (5 minuter)

Steg 2: Generera din TRD med ChatGPT (20 minuter)

Steg 3: Fyll i canvas (30 minuter)

vision.md (10 minuter)

goals.md (10 minuter)

stakeholders.md (5 minuter)

questions.md (5 minuter)

Steg 4: Skapa din plan (5 minuter)

Steg 5: Starta din första session (kommandoreferens)

Vad make session-start gör

Vad make session-end gör

Kommandofuskark

Vanliga installationsmisstag (och hur man fixar dem)

Misstag 1: Hoppa över canvas

Misstag 2: Göra “Nu” för stor

Misstag 3: Vaga backlog-objekt

Misstag 4: Glömma uppdatera status

Misstag 5: Skriva ADR:er för allt

FAQ

F: Behöver jag alla dessa filer? Verkar överdrivet för ett solo-projekt.

F: Vad om jag redan är mitt i projektet? Kan jag anta detta retroaktivt?

F: Hur passar detta med Agile/Scrum?

F: Vad om mitt team inte antar detta?

F: Behöver jag speciella verktyg?

F: Hur ofta ska jag uppdatera dessa filer?

Verktyg du behöver

Nödvändigt

Valfritt men rekommenderat

Inte nödvändigt

Nästa steg

Dela din upplevelse

Vad `make session-start` gör

Vad `make session-end` gör