Bruksanvisning

En komplett användarguide. För koncept, se Introduktion.

Konto

Registrera och logga in

Registrera dig på eastagiletracker.com/register med e-post och ett lösenord, eller continue with GitHub om du föredrar OAuth. Verifiera din e-post via länken vi skickar; fram till dess kan du logga in men vissa funktioner är begränsade.

Om du har blivit inbjuden till ett projekt eller en organisation, följ länken i inbjudningsmejlet — ditt konto skapas (eller du loggar in) och du landar direkt på den matchande boarden.

Glömt lösenordet? Använd Forgot Password på inloggningssidan; vi mejlar en återställningslänk.

Kontoinställningar

Från avataren längst upp till höger → Account Settings:

• Profile — Visningsnamn, initialer (används i ägaravatarer), e-post.
• Bio — En kort självbeskrivning (upp till 4 KiB). Visas på /me och i organisationens medlemslistor så att en agent (eller en lagkamrat) kan välja rätt person att fråga. Lämna den tom för att avstå.
• Password — Byt när du vill.
• Avatar — Ladda upp en bild, eller falla tillbaka på dina initialer.
• API Keys — Skapa personliga API-tokens; se API-guide.
• Theme — Agile, Labs, Dark eller Light (även växlingsbart från sidofältet).
• Delete Account — En tvåstegsbekräftelse. Tar bort dig från alla organisationer och projekt.

Säkerhet

Från avataren längst upp till höger → Security:

• Two-factor (TOTP) — Ställ in en kod från valfri autentiseringsapp (1Password, Authy, Google Authenticator, …). Få 10 engångsbaserade recovery codes — de visas en gång, så spara dem. Inaktivera senare med antingen en aktuell kod eller en recovery code.
• Passkeys — Lägg till en enhetsbunden WebAuthn-passkey (Touch ID, Windows Hello, hårdvarusäkerhetsnyckel). Logga in lösenordsfritt därefter. Lägg till, namnge och ta bort nycklar från samma sida.

Sessioner och refresh-tokens

En lyckad inloggning präglar två tokens: en kortlivad access-JWT och en långlivad refresh-token (30 dagar, roterad vid varje användning). SPA:n förnyar access-token automatiskt när den löper ut; du förblir inloggad tills refresh-token löper ut eller du loggar ut. Utloggning återkallar refresh-token på serversidan, så en stulen kopia kan inte spelas upp på nytt.

Fakturering

De flesta konton är Free Forever för personligt bruk. Om ditt konto har en mätbaserad kreditbalans hittar du den under Account → Billing — fyll på via Paddle-utcheckningen, se transaktionshistorik.

Organisationer

Varje konto tillhör en eller flera organisationer. En ny registrering får en personlig organisation (“<Name> Org”) automatiskt skapad i Linear/Vercel-anda. Projekt bor inuti organisationer, och organisationsmedlemskap styr projektmedlemskap.

Byta organisation

Klicka på organisationsväljaren i toppfältet för att växla mellan organisationer du tillhör. Den aktiva organisationen tonar sidofältet, avgränsar listan “Projects” och förväljs när du skapar ett nytt projekt.

Hantera en organisation (admin)

Klicka på organisationsblocket i sidofältet → Manage organization → du landar på /organization/{id}/projects. Sidofältet visar tre admin-flikar:

• Projects — Alla projekt i denna organisation.
• Members — Aktuella medlemmar, roller och väntande inbjudningar. Bjud in via e-post; inbjudan är e-postlåst med en TTL-token och ett roltak (medlemmar kan inte bjuda in administratörer).
• Settings (endast owners) — Organisationsnamn, slug, plan. Överför ägarskap till en annan medlem här.

Ta bort en medlem

Att ta bort en medlem från en organisation kaskaderar: deras projektvisa medlemskap i organisationens projekt återkallas i samma transaktion. Bokmärkta board-URL:er slutar fungera i samma ögonblick som de förlorar organisationsåtkomst — det finns inget föräldralöst spår.

Projekt

Skapa ett projekt

Från sidan Projects, klicka på New Project. Skapandeformuläret frågar bara efter två saker:

• Title — Krävs.
• Description — Valfritt; synligt för alla medlemmar.

Allt annat — iterationslängd, startdag, initial velocity, estimatskala, klart-tillstånd, växling av tasks — ställs in senare i Project Settings och seedas med rimliga standardvärden.

Projektinställningar

Under projektets meny Settings, fyra flikar:

• Project — Redigera titel, beskrivning, iterationslängd och startdag, velocity-strategi (genomsnitt av senaste 3 / 5 / 10), klart-tillstånd, estimatskala, växling av tasks.
• Member — Bjud in, befordra/degradera och ta bort mänskliga medlemmar (se Medlemmar och inbjudningar nedan).
• Agent — Prägla och återkalla agent-API-nycklar för detta projekt (se Agenter nedan). Endast för owners.
• Import — Hämta in stories från en annan tracker (se Import från andra trackers nedan).

Medlemmar och inbjudningar

I fliken Member i Project Settings, bjud in människor via e-post. Väntande inbjudningar sitter i en separat hink tills de accepteras; du ser vem som är inbjuden och kan skicka om eller återkalla. Aktiva medlemmar kan befordras/degraderas mellan viewer, member och owner. Owners kan ändra projektinställningar; viewers kan läsa men inte skriva.

Projekthistoriken finns på en egen sida — varje ändring av projektinställningar, varje medlemskapsändring, med aktören (människa eller agent).

Stories

Skapa en story

Använd affordansen + Add story på valfri board-panel (Current, Backlog, Icebox eller en egen) — skriv en titel och tryck på Enter.

Nya stories som skapas i Current får som standard current_state = 'unstarted'. Det är PT-paritet: en Current-iteration är en plan för arbete, inte en partition efter tillstånd. Ägaren startar uttryckligen storyn när arbetet börjar — cykeltidsklockan startar inte förrän då.

Krävs: titel. Välj en typ (standard är feature). Lägg till beskrivning, estimat (endast features), etiketter, ägare, följare, blockerare — alla dessa kan fyllas i senare från detaljpanelen.

Tryck på Enter två gånger snabbt? Inga problem — knappen är skyddad; du får exakt en story.

Estimera features

Features är den enda typen som tar poäng. Klicka på poängcirkeln på ett kort (eller i detaljpanelen) och välj från skalan. Oestimerade features visar en tom cirkel.

• Fibonacci scale — 0, 1, 2, 3, 5, 8, 13. Standard-XP. Allt större än 13 bör delas upp i mindre stories.
• East Agile scale — 0, 1, 2, 3. Stramare. En 3:a betyder en hel iteration av en persons tid. Inget passar bortom 3.
• 3-Point scale — 1, 2, 3 (Small / Medium / Large). Strikt t-shirt-storleksättning — inget noll-alternativ, inga halvpoäng.

Välj skala en gång i Project Settings; du kan ändra den senare (befintliga estimat mappas över).

Flytta fram tillstånd

Tre sätt att flytta en story genom livscykeln:

1. Klicka på den inline-åtgärdsknappen på kortet — Start, Finish, Deliver, Accept, Reject. Knapptexten speglar nästa giltiga tillstånd för storyns typ.
2. Dra kortet till en annan kolumn. Systemet tillämpar den övergång som korsandet av kolumnen innebär. Bakåtflyttar ber om bekräftelse.
3. Massövergång — Markera flera stories, Transition all — varje story övergår oberoende. Om en är otillåten går de andra ändå igenom.

Detaljpanel

Klicka var som helst på en story-rad för att expandera den inline. Detaljpanelen visar:

• Titel (redigerbar), beskrivning (Markdown), typ, estimat, beställare.
• Ägare (lägg till/ta bort medlemmar eller agenter), följare, etiketter.
• Tasks (om aktiverat), kommentarer, bilagor, blockerare, länkar, granskningar.
• En 3-prickars meny för duplicera, radera och andra mindre vanliga åtgärder.

Tryck på Escape för att stänga den senast öppnade storyn (den minns stacken — fäll ihop en i taget).

Kommentarer

Upp till 10 000 tecken, Markdown renderas. Redigera och radera dina egna kommentarer; granskningsloggen behåller historiken. @-nämn medlemmar och autocomplete plockar upp dem.

Bilagor

Dra en fil till detaljpanelen, eller använd uppladdningsknappen. Upp till 2 GB per fil — ja, stort nog för videoinspelningar av skärmgenomgångar. Använd videospelaren inline.

Etiketter

Från sidan Labels i sidofältet: skapa etiketter med namn och färger, arkivera när de blir inaktuella (arkiverade etiketter försvinner från boarden men förblir sökbara). Lägg till etiketter per story i detaljpanelen.

Blockerare, länkar, granskningar

• Blockerare — En fritextanteckning om “detta är blockerat av X”. Markera löst/olöst. Filtrera boarden på has:blocker.
• Länkar — Sex relationstyper: relates to, duplicates, blocks, is blocked by, pull request, branch. Klistra in en GitHub-URL så detekteras typen automatiskt.
• Granskningar — Tilldela en granskare (människa eller agent) med en status (pending, approved, rejected) och en valfri kommentar.

Tasks

Om aktiverat i Project Settings får stories deluppgifter — en checklista inuti storyn. Bocka av dem allt eftersom; antalet visas på kortet.

Story-fältreferens

Varje valvariabel på story-detaljytan har en liten [?]-ikon bredvid sin etikett. Klicka på den i appen för att se samma vägledning som sammanfattas nedan. Översättare levererar texten i appen tillsammans med resten av gränssnittet; denna sektion är den kanoniska referensen i långform.

Fälten är listade i den ordning de visas i fliken Overview.

Status

Storyns plats i livscykeln: Unstarted → Started → Finished → Delivered → Accepted (eller Rejected tillbaka till Started).

Det kritiska tillståndet är Delivered: ingenjören markerar den som levererad, men den är inte klar förrän produktägaren uttryckligen Accepts den mot acceptanskriterierna — eller avvisar den, vilket sparkar tillbaka den. Detta bakar in en kundåterkopplingsloop i varje story snarare än att skjuta upp acceptansen till en demo i slutet av sprinten.

Om stories hopar sig i Delivered är det en signal att accept/reject-loopen har stannat. Titta på antalet i Delivered i slutet av varje iteration — om det växer är det din signal att produktägaren är underbemannad eller att acceptanskriterierna inte är tillräckligt tydliga i förväg.

Iteration

Vilken iteration storyn är inplanerad i. Lämna den som None för att hålla storyn i Backlog, där systemet automatiskt grupperar den under en kommande iteration baserat på velocity.

Manuell åsidosättning här är användbar när du vill fästa en story till en specifik iteration oavsett ordning — t.ex. att knyta en release-story till ett fast datum. Annars, låt ordningen i Backlog driva iterationstilldelningen; det är det som håller velocity-prognosen ärlig.

Owners

Vem som utför arbetet. Ägare kan vara människor eller agenter — båda renderas som namngivna deltagare i granskningsloggen, kommentarsförfattarskap och analys. Det finns inget sätt att förkläda en agentägare som en människa.

Flera ägare är det synliga uttrycket för parprogrammering (eller par-med-agent). Lägg till agenten som plockade upp storyn och människan som granskar — båda namnen visas på kortet. Detta håller pågående arbete lågt; att avsluta innan man startar nästa story är den enskilt största hävstången på cykeltid.

Ägare är inte samma sak som Followers (ett separat fält på kortet). Följare är personer som bryr sig om storyn men inte utför arbetet — vanligtvis prenumeranter på aviseringar.

Story type

De fyra typerna är inte utbytbara — skillnaden är hela poängen med datamodellen.

• Feature — Nytt användarobserverbart värde. Den enda typen som bär poäng och räknas mot velocity. Detta tvingar dig att skiva upp arbete i värde användaren kan se.
• Bug — En defekt. Opoängsatt. Defekter ger ingen velocity-kredit, vilket håller omarbetskostnaden synlig snarare än belönad.
• Chore — Nödvändigt arbete utan direkt användarvärde (refaktoreringar, infra, uppsättning). Opoängsatt. Teamet pressas att paketera chores in i features där det går så att värderamen förblir ärlig.
• Release — En markör med noll poäng för en milstolpe. Går direkt från Unstarted till Accepted och förankrar ett datum för prognosen.

Om du kommer på dig själv med att vilja poängsätta en bug eller chore: låt bli. Det bryter prognosen som gör hela systemet ärligt. Velocity är ett mätinstrument; man manipulerar inte sitt eget instrument.

Priority

Använd inte detta om du kan undvika det. Backloggen är prioriteten — uppifrån och ner, en enda prioritet, inga delade platser. Produktägaren äger ordningen.

Ett “priority”-fält är det klassiska antimönstret som tyst förvandlar en empirisk, ordnad backlog tillbaka till önsketänkande planering. Om du kommer på dig själv med tre P1:or har du ingen prioritet — du har en Backlog med fel ordning. Fixa ordningen; ta bort prioritetssignalen.

Fältet finns för kompatibilitet med importer från trackers som använder ett (Jira, Asana, …) så att importerade stories inte förlorar information på vägen in. Lämna det på “None” i nytt arbete.

Points

Relativ storlek på storyn. Features får poäng; bugs, chores och releases förblir noll.

Estimering är ett samtal om storlek, inte ett löfte. Översätt inte poäng till timmar; blås inte upp poäng för att se snabb ut. Velocity är ett mätinstrument — man manipulerar inte sitt eget instrument.

Tre skalor levereras:

• Fibonacci — 0, 1, 2, 3, 5, 8, 13. Den klassiska XP-skalan. Allt större än 13 bör delas upp.
• East Agile — 0, 1, 2, 3. En tätare skala. En 3:a betyder en hel iteration av en persons tid.
• 3-Point — 1, 2, 3 (Small / Medium / Large). Strikt t-shirt-storleksättning.

Om du ofta estimerar i 5:or, 8:or eller 13:or är dina stories för stora. Dela tills var och en är självständigt levererbar (S:et och I:et i INVEST).

Requester

Vem som bad om storyn. Vanligtvis en person — produktägaren, en intressent, eller en agent som agerar för någons räkning.

Beställaren är inte ägaren. Ägaren är den som utför arbetet; beställaren är den som bryr sig om resultatet och kommer (eller inte kommer) att acceptera det. De kan vara samma person, men de är skilda roller. Att registrera beställaren är det som ger dig granskningssvaret på “vem bad om detta?” sex månader senare.

Labels

Färgade taggar. Stories kan bära flera. Används för tvärgående kategorisering — mvp, tech-debt, security, ett visst release-namn — och för board-filtrering (label:mvp i sökrutan, eller spara den som en anpassad filterpanel).

Etiketter är projektavgränsade. Hantera dem på sidan Labels i sidofältet. Arkivera inaktuella etiketter istället för att radera; arkivet håller historiken sökbar samtidigt som det rensar boarden.

Blockers

Fritextanteckningar som beskriver vad som hindrar storyn från att gå framåt. Markera som löst när hindret lyfts.

Blockerare är en flödessignal, inte en kö. Använd den dagliga standupen för att lyfta dem; lös dem utanför mötet. Om du har mer än en eller två öppna blockerare per story i mer än en dag är planeringen fel — dela storyn eller ändra beroendet. Målet är att Blocked-panelen ska vara mestadels tom större delen av tiden.

Description

Vad storyn är och hur man känner igen att den är klar. Markdown.

Acceptanskriterier hör hemma här — helst i Given / When / Then-form så att de mappar direkt mot acceptanstester:

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST är förnuftskontrollen på om en story är välformad:

• Independent — kan släppas utan andra stories.
• Negotiable — fångar avsikt, inte en frusen spec.
• Valuable — för en användare eller intressent.
• Estimable — teamet kan storleksbestämma den.
• Small — får bekvämt plats i en iteration.
• Testable — har acceptanskriterier som kan utövas.

En story högst upp i backloggen med vaga acceptanskriterier är en planeringsbug — inte ett framtida problem att ignorera. Fixa den innan du låter den gå vidare.

Massåtgärder

Markera flera stories på boarden (shift-klick för intervall, eller Select all in panel). Sedan:

• Massövergång
• Massradering
• Massduplicering

Boarden

Boarden är hemskärmen för varje projekt. Tre kolumner som standard:

• Current — Stories i den aktiva iterationen. Grupperade efter iterationsrubrik (nuvarande, sedan kommande, sedan stängda). Korten visas i iterationens tidsföljdsordning med sitt tillstånd synligt på varje kort; kolumnen är inte skivad efter tillstånd — det bryter den iterationstidsföljd som teamet planerar i.
• Backlog — Strikt ordnad kö. Systemet grupperar automatiskt kommande iterationer baserat på velocity. Produktägaren äger ordningen uppifrån och ner; tydlighet tillåts försämras allt eftersom du rullar nedåt, men aldrig högst upp.
• Icebox — Idéer utan datum. Oordnade, oestimerade. Iceboxen tillåts vara en kyrkogård.

Konfigurerbara paneler — kryssrutor i sidofältet

Sidofältets Board-sektion listar varje förinställd kolumn med en kryssruta: bocka i en ruta för att visa den kolumnen, bocka ur för att dölja. Växlingarna sparas per projekt per användare (de synkas genom GET/PUT /preferences). Förinställningarna är:

• Current Iteration (på som standard)
• Backlog (på som standard)
• Icebox (på som standard)
• Done — Accepterade stories.
• My Work — Stories där du är ägare.
• Blocked — Stories med olösta blockerare.
• Epics — Sammanställningar på epic-nivå.
• Chat — Projektavgränsad chattkolumn.

Egna filterpaneler

Fäst en sökning som en panel: klistra in en query som type:feature label:mvp owner:claire, spara den. Ändra storlek på kolumner som passar; bredder sparas mellan sessioner.

Sök

Sökfältet accepterar filtersyntaxen som beskrivs i Introduktion. Sökresultaten lever i en resultatpanel; klicka på vilken som helst för att hoppa till den på boarden.

Chip för aktuell iteration

Toppfältet visar aktuellt iterationsnummer, datumintervall och poäng accepterade vs planerade. Klicka för att hoppa till kolumnen Current.

Iterationer

Systemet skapar iterationer automatiskt baserat på din längd och startdag. Du behöver inte “öppna” eller “stänga” dem.

För att planera framåt, dra stories från Backlog till kommande iterationsgrupper. Systemet markerar grupper rött om de överskrider din velocity. För att planera längre fram, rulla i backloggen — den visar tre eller fyra iterationer framåt.

För att spola tillbaka: klicka på valfri tidigare iterationsrubrik i kolumnen Current för att gå in i iterationsrapporten.

Releaser

Releaser är en story-typ, inte ett separat objekt. Skapa en release på samma sätt som du skulle skapa vilken story som helst: välj Release som typ, ge den ett namn (t.ex. v2.4), dra den till iterationen där du tänker leverera.

Releaser hoppar över tillstånden Started/Finished/Delivered/Rejected — de går från Unstarted till Accepted i ett steg. Acceptera en release när du levererar; analysvyerna visar releasemarkören.

Analys

Analytics-fliken (högst upp i projektet) ger dig sex rapporter:

• Project Overview — Velocity-trend, KPI:er för senaste iterationen, burnup, burndown, kumulativt flöde.
• Iteration — Fördjupa i en enskild iteration: KPI:er, burndown, tillståndsflöde.
• Releases & Burndowns — Releasetidslinje, burndown per release.
• Story Activity — Vem gjorde vad, filtrerbart per aktör, typ, datumintervall.
• Cycle Time — Medelvärde och fördelning av tid från Started till ditt klart-tillstånd.
• Projections — Prognos för när backloggen blir klar vid nuvarande velocity.

Agenter

Detta är den del av produkten som sätter den i särklass. En agent är en namngiven lagkamrat — men en AI.

Lägg till en agent i ett projekt

Du måste vara projekt-owner (eller administratör). Öppna Project Settings → Agents:

1. Create new agent key.
2. Ge agenten ett namn (det visas som det namnet i granskningsloggar, kommentarsförfattarskap och ägaravatarer).
3. Välj en roll — viewer (skrivskyddat) eller member (kan skriva). Owner-rollen är begränsad till människor.
4. Nyckeln visas en gång — kopiera den; vi lagrar den inte återhämtningsbart. Prefixet är ea_agent_….

Vad agenter kan göra

En agent med member-roll kan göra allt som en mänsklig medlem kan:

• Skapa, redigera, byta tillstånd på, radera stories
• Kommentera, bifoga filer, lägga till etiketter, sätta ägare
• Välja sig själv som ägare av en story
• Läsa aktivitet, följa händelser

Granskningsloggen registrerar varje skrivning med agentens identitet. Det finns inget sätt att få en agentåtgärd att se ut som en mänsklig åtgärd.

Hantera agentnycklar

I Project Settings → Agents ser du alla aktiva nycklar, deras namn, roller och senast använda tidsstämpel. Återkalla en nyckel när som helst; agenten förlorar åtkomsten omedelbart. Agentens tidigare aktivitet förblir i granskningsloggen för alltid.

Använd agenter med API:et

Se API-guide → Agentnycklar för kodexempel.

Import från andra trackers

Om du kommer från ett annat verktyg har vi importörer för åtta källor:

• Pivotal Tracker
• Jira
• Asana
• GitLab
• Shortcut
• Trello
• Linear
• Plane

Från Project Settings → Import, ladda upp en export (CSV från de flesta, JSON från Plane). Stories, ägare, kommentarer, etiketter och tillstånd mappas automatiskt; vissa källor tar också med iterationer.

En förhandsvisning visar vad som kommer att importeras. Avvikelser (t.ex. en etikett som inte finns i ditt projekt) ger en prompt — skapa eller hoppa över, ditt val.

Teman

Fyra teman levereras. Växla i sidofältets sidfot (eller i Account Settings → Theme):

• Agile — Marknadsföringssidans palett. Varma vita toner, djupblå varumärkesaccent (#1f6f9f), mättade story-typsikoner. Det ledande alternativet i väljaren.
• Labs — Pivotal Tracker-paletten, kärleksfullt bevarad. Mörkt gränssnitt, blå topbar, pastellfärgade kolumnmellanrum. Originalet.
• Dark — Rent neutralt mörkt.
• Light — Rent neutralt ljust. Bläck på papper.

Ditt tema sparas mellan sessioner.

Språk

Gränssnittet är översatt till 15 språk: engelska, franska, tyska, spanska, japanska, kinesiska, koreanska, portugisiska, italienska, nederländska, svenska, danska, tjeckiska, finska, polska. Byt i sidofältets sidfot — gränssnittet, autentiseringssidorna, konto-/säkerhetsdelen, projektlistan och marknadsföringssidan lokaliseras omedelbart. Lokalisering av story-detaljer / analys / inställningar följer.

Kortkommandon

Några som förtjänar sin plats:

• Escape — Fäll ihop den senast öppnade storyn.
• Enter i ett inline-fält — Skicka (fäller inte ihop raden).
• Shift-klick — Intervallmarkera stories.

Fler tillkommer över tid; se Help i sidofältet för aktuell lista.

Self-hosting

East Agile Tracker är öppen källkod. Hela källkoden finns på github.com/EastAgile/agile-tracker — klona, bygg, kör på din egen infrastruktur. Samma funktionsuppsättning som den hostade versionen.

För installation, se projektets README.