ADORSYS-GIS / ADORSYS-GIS/ai-helm

[Epic]: Citation integrity — ADRs and docs that resolve to one true thing

Ouverte
#1,078 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
Go Template
Étoiles
3
Forks
1
Merge moyen
19 h 24 min
PR mergées (30 j)
80

Description

### Summary

ADR numbers are cited as cross-repo contracts. Three of them currently resolve to **two Accepted decisions each**, and a fourth family of tickets cites ADRs that do not exist at all.

### Intent

A citation that resolves to two documents is not a contract. This has already cost real investigation time and, worse, is load-bearing right now: a live in-progress ticket (#1063) depends on "ADR-0118" while two Accepted files carry that number, and six tickets touching the **auth boundary** cite ADR-0077/0078, which on `main` are Grafana dashboard and span-attribution decisions.

### Children

- **#1073** — renumber the three collisions (0050, 0077, 0118) and add a CI guard
- **#1074** — decide the fate of the GitLab epic whose ADR-0077/0078 citations point at nothing
- **#1051** — sync the cert-manager docs with the shipped Route53 DNS-01 fix

### Acceptance Criteria

1. `ls docs/adr/*.md | sed 's#.*/##' | cut -d- -f1 | sort | uniq -d` returns empty, and CI keeps it that way.
2. No open issue in any repo cites ADR-0077 or ADR-0078 for a GitLab/multi-forge claim.
3. **House rule recorded: cite ADRs by filename, not bare number**, at least until the guard exists.

### Out of Scope

- Editing any ADR's decision body — they are Accepted and immutable.

### Technical Context

⚠️ **#1073's own AC names "0136" as the next free number.** That is true today and will be wrong as soon as any ADR merges — which would instruct a fourth collision. Compute `max(prefix)+1` at PR time instead; the CI guard is the real check.

### AI Usage Declaration

Grouping identified and drafted by Claude Opus 5 during the 2026-09-01 triage sweep; the collisions and the missing GitLab ADR were verified on `origin/main`. AI output is not truth; the owner verifies.

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Start by reading the epic and its child issues #1073, #1074, and #1051. The concrete check mentioned is `ls docs/adr/*.md | sed 's#.*/##' | cut -d- -f1 | sort | uniq -d`; done means duplicate ADR prefixes are gone, ADR-0077/0078 citations are resolved, the house rule is recorded, and CI prevents regressions.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
gitlab, markdown, shell
Domaine
ci-cd, documentation
Type d'issue
Documentation
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
28/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.