Issues

Wat is een issue?

Een issue is een stuk werk dat is voortgekomen uit een binnengekomen e-mail. Zodra je in de Inbox op Convert to issue klikt, krijgt het ticket een eigen detailpagina, een kind, een prioriteit en een status. Vanaf dat moment is het traceerbaar werk in plaats van een mailtje.

Elke issue heeft drie kernvelden die het gedrag bepalen:

• kind — BUG, FEATURE of SUPPORT. De UI past zich hierop aan.
• priority — critical, high, medium of low.
• readiness — ready (klaar voor dev), investigate (eerst uitzoeken) of blocked.

readiness staat los van status. Een issue kan ready zijn qua status maar investigate qua readiness — bijvoorbeeld wanneer de intake-agent een lage confidence had.

Operator-workbench

Issues is de dichtste lijstpagina van het product. Layout volgt Linear/Jira-conventies — bestaande spiergeheugen werkt direct.

• Sticky chrome. Header, filterstrip, DataTable-toolbar en kolomheader blijven vastgezet terwijl de rijenlijst scrolt. De filterstrip verbergt zichzelf als geen enkele bucket gevuld is.
• Split view. Enter (of klik op een rij) opent het issue in een rechter detail-pane. De lijst houdt zijn filter+sort; je triagt zonder de queue te verlaten. De pane-breedte is resizable (sleep de divider, of focus 'm en gebruik ←/→; Shift voor stappen van 64 px) en wordt per operator onthouden. De pane-toggle in de toolbar zet 'm aan/uit — staat 'ie uit, dan routen activaties naar de standalone detailroute.
• Detail-pager. In de rechter pane (en op /issues/:key) loopt de prev/next-pager door de huidige filterset, niet de hele tenant. [ is prev, ] is next.
• Bulk select. x togglet de actieve rij, Shift+x extendt een Gmail-style range vanaf de laatste anchor, Cmd/Ctrl+A selecteert alle zichtbare rijen op de pagina. Selectie overleeft pagineren, sort en filterwissels — herfilter om de zichtbare set in te perken, ga door met aanvinken, en pas één bulk-actie toe op de hele unie.
• Bulk-acties. Een sticky toolbar verschijnt boven de tabel zodra je iets selecteert: Approve, Reject, Delete. De bar toont N selected (M on page) en biedt één klik op "select all matching" wanneer er meer achter de huidige pagina zit.
• Rij-shortcuts. Met een actieve rij: a voert de primaire actie uit (open / approve / send afhankelijk van kind), f triggert Run fix. Beide gebruiken dezelfde handlers als de knoppen — optimistic state en audit blijven identiek.
• Live status. Als een agent-run aan een rij hangt, schakelt de status-cel naar een live pill met een inline cancel; je hoeft niet naar Runs om af te breken.

De DataTable-keymap (j/k, /, Enter, Esc, …) en het globale command palette staan in Toetsenbord & command palette.

Per kind: BUG, FEATURE, SUPPORT

Het kind is geen label — het stuurt actief de pagina. Wat je ziet en welke knoppen je krijgt verandert mee.

Bij een SUPPORT-issue zijn dev-pijplijnknoppen verborgen — de klant heeft een antwoord nodig, geen patch. Bij een BUG met priority=critical of een PAYMENT-flag wordt Dry run automatisch de veilige standaardknop, en zie je een waarschuwing dat een CTO-gate nodig kan zijn.

Plangoedkeuring vóór de uitvoering

Bij riskant werk stelt het AI-team eerst een uitvoeringsplan op vóór het begint te bouwen. Dat plan verschijnt als de kaart "Wacht op plangoedkeuring" op de issue-pagina: de probleeminterpretatie, de aanpak, de betrokken systemen, het risico, de validatie- en terugrolstrategie — in gewone taal. Jij kiest Plan goedkeuren, Wijzigingen vragen (de AI maakt een nieuwe versie met jouw feedback) of Plan afwijzen. Zolang het plan niet is goedgekeurd, begint de AI niet.

Dit is de krachtigste plek om bij te sturen: je corrigeert de aanpak vóór er code is, niet door achteraf een verkeerde patch af te keuren. De volledige uitleg staat in Goedkeuringen.

AI-uitvoeringsweergave

Loopt er een missie op een issue, dan toont de detailpagina een AI-uitvoeringsweergave: een statusheader met de huidige fase, een audit-samenvatting van wat het AI-team deed, de QA-slagingsgraad en — waar van toepassing — een echte rollback-knop. Alles is audit-first: je leest wat er is gebeurd, niet alleen wat er nu draait.

Statussen

Een issue bewandelt deze statussen:

• intake — net binnengekomen, nog niet beoordeeld.
• review — onder beoordeling.
• ready — goedgekeurd, klaar voor de dev-pijplijn.
• in_progress — er wordt aan gewerkt.
• blocked — wacht op input of een externe partij.
• done — afgehandeld of afgewezen.

AI-supervisie op issues

Elke issue draagt supervisie-metadata van de intake-agent en — als er patches zijn — van de patch-reviewers:

• Confidence — hoe zeker de classificatie is.
• Risk — losstaande inschatting van de gevolgen van actie (niet hetzelfde als confidence).
• Why — de onderbouwing van de beslissing.
• Sources — knowledge-fragmenten die zijn geraadpleegd.
• Uncertainty — wat onzeker bleef.
• Assumptions — welke aannames zijn gedaan.

Confidence is geen veiligheid. Een zelfverzekerde foute classificatie blijft fout. Lees altijd de "Why" voordat je actie neemt — zeker bij risk medium of high.

Loopt er een agent-run op de issue, dan toont de status-pill van de rij de live fase (generating, applying, verifying) met een inline cancel — dezelfde handler als op de Runs-pagina, dus de audit trail blijft gelijk.

Patches en retry-lineage

Zodra een patch wordt geproduceerd, surface't de detailpagina:

• De huidige revisie in het Patch trust-paneel (confidence, risk, sources, "wat is er veranderd").
• Retry-lineage — de keten van revisies als die er zijn. Elke entry toont status (approved, rejected, changes_requested, superseded) en de reden.
• Dry run-resultaten wanneer een dry run is uitgevoerd.

Auto-revise is begrensd — standaard wordt de keten na drie rondes gevlagd voor menselijke triage in plaats van blijven loopen.

Acties op een issue

De sticky bar onderaan de pagina is je controlepaneel:

• Approve — zet de issue op ready en duwt 'm de dev-pijplijn in (verborgen voor SUPPORT).
• Reject — sluit de issue af.
• Mark duplicate — koppel aan een bestaand issue.
• Split — splits in meerdere child-issues.
• Dry run — laat AI een patch voorstellen zonder iets te mergen.
• Run fix — voer de fix uit en open een PR.

Een run starten vanaf een rij navigeert niet meer weg. De run streamt in de zijpaneel (of in de status-pill van de rij als de pane dicht staat) — je blijft op /issues om door te triagen.

Na een Run fix verschijnt rechts een PR → link en, indien beschikbaar, een Last verification-paneel met de checks van de laatste run.

Veelgemaakte fouten

• Een lage-confidence classificatie goedkeuren zonder de onderbouwing te lezen. Het "Why"-paneel is kort met opzet — lees het.
• Run fix uitvoeren zonder dry run bij high-risk patches. De UI nudget je niet voor niets richting dry run.
• `kind` als vast beschouwen. Je kunt het wijzigen op de detailpagina; de layout schakelt direct mee.

Veelgestelde vragen

Het `kind` klopt niet — kan ik het wijzigen? Ja, op de detailpagina. Het hele paneel-layout schakelt direct mee.

Waarom zie ik geen Approve-knop? Dit is een SUPPORT-issue. Daar is goedkeuren niet van toepassing — verstuur het concept-antwoord vanuit het Auto-reply-paneel.

Waarom is Dry run vetgedrukt en Run fix niet? De issue is critical, raakt een PAYMENT-flow, of de patch heeft risk=high. FixControl raadt aan eerst een dry run te doen.

Wat gebeurt er na de derde revisie in de retry-lineage? Auto-revise stopt en de issue komt in de operator-queue terecht met requires triage. Jij beslist of je handmatig een revisie draait, de prompt aanpast of de issue sluit.

Zie ook: Toetsenbord & command palette.