Importere ADR-er

Hva er ADR-pakker?

En ADR-pakke er en kuratert samling av Architecture Decision Records buntet sammen under et felles tema. Hver pakke inkluderer:

• En archgate-pack.yaml-manifestfil med metadata (navn, versjon, vedlikeholdere, tagger)
• En eller flere ADR-markdownfiler i en adrs/-katalog
• Valgfrie tilhørende .rules.ts-filer som håndhever hver beslutning automatisk

Pakker lar deg starte et prosjekt med utprøvde arkitekturkonvensjoner i stedet for å skrive alt fra bunnen av.

Importere fra registeret

Archgate awesome-adrs-registeret er vert for fellesskapsvedlikeholdte pakker. Importer en med:

archgate adr import packs/typescript-strict

Dette kloner registeret, kopierer ADR-ene til .archgate/adrs/-katalogen din, og tilordner ID-er på nytt for å passe prosjektets nummereringsskjema.

Låse til en versjon

Legg til @<ref> for å låse til en spesifikk git-tag eller gren:

archgate adr import packs/[email protected]

Plukke ut individuelle ADR-er

Du trenger ikke importere en hel pakke. Pek til en spesifikk ADR-fil inni en pakke:

archgate adr import packs/security/adrs/SEC-001-no-secrets-in-code

Bare den ene ADR-en (og dens tilhørende regelfil, hvis den finnes) vil bli importert.

Importere fra tredjepartsrepositorier

Ethvert GitHub-repositorium med ADR-filer fungerer som kilde. Bruk syntaksen med tre segmenter org/repo/sti:

archgate adr import acme/company-adrs/packs/api-standards

Dette kloner https://github.com/acme/company-adrs.git og importerer fra den angitte underkatalogen.

Importere fra en hvilken som helst git-URL

For ikke-GitHub-repositorier eller når du trenger full kontroll, send en fullstendig URL:

archgate adr import https://github.com/org/repo/tree/main/packs/my-pack

CLI-en parser GitHub /tree/<ref>/<sti>-formatet automatisk. For andre verter kan du sende enhver git-klonbar URL:

archgate adr import https://gitlab.com/team/repo.git

Forhåndsvis med --dry-run

Se hva som ville blitt importert uten å skrive noe:

archgate adr import packs/typescript-strict --dry-run

Utskriften viser de opprinnelige ID-ene, nytilordnede ID-er og titler i en tabell.

Liste importerte ADR-er med --list

Sjekk hva som har blitt importert tidligere:

archgate adr import --list

Dette leser .archgate/imports.json og viser hver kilde, versjon og ADR-ID-ene den produserte.

Hvordan ID-nytilordning fungerer

Når du importerer ADR-er, blir de opprinnelige ID-ene nytilordnet for å matche prosjektets domeneprefikser. Hver ADRs domain-felt bestemmer hvilket prefiks den får — for eksempel blir en ADR med domain: frontend til FE-XXX, mens en med domain: backend blir BE-XXX. Hvert domene har sin egen teller, så import av en pakke med blandede domener produserer korrekt prefiksede ID-er uten kollisjoner.

For eksempel, når du importerer en pakke med tre frontend-ADR-er og to backend-ADR-er inn i et prosjekt som allerede har FE-001 og BE-001, produseres:

• FE-002, FE-003, FE-004 (frontend)
• BE-002, BE-003 (backend)

Nytilordningen sikrer:

1. Ingen ID-kollisjoner med eksisterende ADR-er
2. Hvert domene opprettholder sin egen nummereringssekvens
3. Importerte regelfiler fungerer umiddelbart uten manuelle endringer

imports.json-manifestet

Hver import registreres i .archgate/imports.json:

{
  "imports": [
    {
      "source": "packs/typescript-strict",
      "version": "0.3.0",
      "importedAt": "2026-05-10T14:32:00.000Z",
      "adrIds": ["ARCH-006", "ARCH-007", "ARCH-008"]
    }
  ]
}

Dette manifestet lar deg spore opprinnelse — hvor hver importerte ADR kom fra og når. Commit det til versjonskontroll sammen med ADR-ene dine.

Referanse for kommandoalternativer

| Alternativ | Beskrivelse | | ----------- | ----------------------------------------- | | --yes | Hopp over bekreftelsesdialogen | | --json | Skriv ut resultater som JSON | | --dry-run | Forhåndsvis endringer uten å skrive filer | | --list | List tidligere importerte ADR-er |