Altinn / Altinn/team-kitt

[EPIC] KITT KI-Platform – Build Production Frontend from Prototype using Agentic AI

Open
#102 0 comments 0 reactions 1 assignee Claimed by @adidahl View on GitHub
status/draft
Dominant language
No language data
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

### Description

## 🎯 Objective

Transform the attached KITT KI-Platform HTML prototype into a
production-ready frontend, using an Agentic AI development approach
to accelerate delivery, reduce manual effort and maintain consistency
across the codebase.

---

## πŸ“Ž Prototype Reference

A fully functional HTML prototype is attached to this Epic.

**Before writing a single line of code β€” open it.**

The prototype covers:
- Full 7-section landing page (conversion-optimised order)
- 4 interactive sub-pages accessible via top navigation
- Norwegian copy throughout
- Component patterns: cards, tables, accordions, tabs, alerts,
badges, step flows
- Responsive layout
- Digdir Designsystemet-inspired design tokens

> The prototype is the source of truth for layout, copy,
> UX flow and component structure. Do not redesign β€”
> translate it faithfully into production code.

---

## πŸ—οΈ Scope

### Landing Page β€” 7 sections
- Β§1 Hero – value proposition + quick resource navigation
- Β§2 Problem / Value – 4 BOD pain points
- Β§3 Features – 4 KITT resources with navigation to sub-pages
- Β§4 Benefits – lifecycle visualisation + outcomes
- Β§5 FAQ – accordion with 6 objection-handling entries
- Β§6 CTA – three contextual call-to-action options
- Β§7 Footer – links, brand info, Designsystemet credit

### Sub-pages (via top navigation)
- πŸ“‹ Rutine for ansvarlig KI-bruk
- πŸ” Lisenser og abonnementer (with tabbed table)
- βœ… Egenvurdering for KI-initiativ (5-step process)
- πŸ›  Metodikk og Playbook (3-phase cards + resources)

### Design system
- Implement using Digdir Designsystemet components
- Reference: https://designsystemet.no/en/components
- Design tokens from the prototype CSS variables are the baseline

---

## βœ… Acceptance Criteria

- [ ] All 7 landing page sections implemented and match prototype
- [ ] All 4 sub-pages accessible and functional via top nav
- [ ] Navigation state (active pill, back button, breadcrumb) works correctly
- [ ] All copy is in Norwegian and matches prototype content
- [ ] Responsive on mobile, tablet and desktop
- [ ] Meets WCAG 2.1 AA accessibility standards
- [ ] Uses Designsystemet component library
- [ ] No scroll on the main view β€” sub-pages are panel-switched
- [ ] Performance score β‰₯ 90 on Lighthouse
- [ ] All interactive elements (tabs, accordions, FAQ, CTAs) functional

---

## πŸ“ Technical Decisions (open for team input)

| Decision | Suggestion | Status |
|---|---|---|
| Framework | React or Next.js | πŸ”΅ To be decided |
| Component library | @digdir/designsystemet-react | πŸ”΅ To be decided |
| Routing | Next.js App Router or React Router | πŸ”΅ To be decided |
| Styling | CSS Modules + Designsystemet tokens | πŸ”΅ To be decided |
| Hosting | Digdir internal infra / Vercel | πŸ”΅ To be decided |
| Auth | Internal SSO (if needed) | πŸ”΅ To be decided |

---

## πŸ”— Related Issues (to be created)

- [ ] #1 – Setup project scaffolding and Designsystemet integration
- [ ] #2 – Build top navigation component with view routing
- [ ] #3 – Build Hero section (Β§1)
- [ ] #4 – Build Problem / Value section (Β§2)
- [ ] #5 – Build Features section (Β§3)
- [ ] #6 – Build Benefits / Lifecycle section (Β§4)
- [ ] #7 – Build FAQ accordion section (Β§5)
- [ ] #8 – Build CTA section (Β§6) and Footer (Β§7)
- [ ] #9 – Build sub-page: Rutine for KI-bruk
- [ ] #10 – Build sub-page: Lisenser og abonnementer
- [ ] #11 – Build sub-page: Egenvurdering
- [ ] #12 – Build sub-page: Metodikk og Playbook
- [ ] #13 – Accessibility audit and fixes
- [ ] #14 – Responsive QA across breakpoints
- [ ] #15 – Lighthouse performance audit

---

## πŸ€– Agentic AI Development Approach

See full recommendation below ↓

[kitt-platform-v2.html](https://github.com/user-attachments/files/25411734/kitt-platform-v2.html)

### In scope

[kitt-platform-v2.html](https://github.com/user-attachments/files/25411746/kitt-platform-v2.html)

### Out of scope

_No response_

### Additional Information

_No response_

### Tasks

_No response_

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.