AI-koodaustyökalut ja projektisäännöt

Tekoäly on muuttanut ohjelmistokehityksen perustavanlaatuisesti. Tässä oppitunnissa opit valitsemaan oikeat AI-koodaustyökalut ja konfiguroimaan projektisäännöt, jotka ohjaavat AI-agentin toimintaa.

Agenttinen koodaus

Perinteinen koodaus on ihmisvetoista: kehittäjä kirjoittaa jokaisen rivin itse. Agenttisessa koodauksessa tekoäly toimii aktiivisena kehityskumppanina — se generoi, ehdottaa ja iteroi koodia ihmisen ohjauksen mukaan.

AI-koodaustyökalut

Modernit AI-koodaustyökalut jakautuvat kolmeen kategoriaan:

IDE-integraatiot

IDE-integraatiot ovat yleisin tapa käyttää AI:ta koodauksessa. Ne tarjoavat:

• Automaattitäydennys — AI ehdottaa seuraavaa koodiriviä kontekstin perusteella
• Inline-chat — kysy AI:lta suoraan editorissa
• Agenttitila — AI suorittaa monivaiheisia tehtäviä itsenäisesti

CLI-agentit

CLI-agentit ovat tehokkaimmillaan suurissa, toistuvissa tehtävissä:

# Aloita uusi keskustelu projektissa
claude

# Anna tehtävä suoraan
claude -p "Lisää virheenkäsittely kaikkiin API-reitteihin"

# Käytä tiedostoa promptina
claude -p "$(cat task-spec.md)"

Projektisäännöt — AGENTS.md

Projektisäännöt kertovat AI-agentille, miten toimia projektissa. Tärkein tiedosto on AGENTS.md — avoin standardi, jonka lukee valtaosa työkaluista (poikkeukset ja silta alempana).

Hyvän AGENTS.md:n rakenne

# AGENTS.md

## Projektin kuvaus
NextPath AI on oppimisalusta, joka käyttää Next.js 15,
TypeScript, Supabase ja Tailwind CSS:ää.

## Tech Stack
- Framework: Next.js 15 (App Router)
- Kieli: TypeScript (strict mode)
- Tietokanta: Supabase (PostgreSQL + RLS)
- Tyylitys: Tailwind CSS + shadcn/ui

## Koodauskäytännöt
- Käytä funktionaalisia komponentteja (ei class-komponentteja)
- Kirjoita tyypit erilliseen types-kansioon
- Käytä server actions tietokantaoperaatioihin
- Nimeä tiedostot kebab-case: my-component.tsx

## Testaus
- Yksikkötestit: Vitest
- E2E-testit: Playwright
- Testikattavuustavoite: 80 %

## Rajoitteet
- Älä käytä any-tyyppiä
- Älä lisää uusia riippuvuuksia ilman perustelua
- Älä muokkaa migraatiotiedostoja suoraan

Eri työkalut, samat säännöt

Eri AI-työkalut lukevat sääntöjä eri tiedostoista:

Tilanne on selkiytynyt: AGENTS.md on nykyään avoin standardi, jota ylläpitää Agentic AI Foundation (Linux Foundation) ja jota lukee natiivisti yli kaksikymmentä työkalua — Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Aider, Windsurf, Zed ja muut. Kirjoita säännöt kerran sinne.

Yksi tiedosto, kaikki työkalut

Claude Code lukee edelleen CLAUDE.md:n. Älä ylläpidä kahta tiedostoa — sillaksi riittää yksi rivi tai yksi symlink:

# Vaihtoehto A: import-rivi (suositeltu — CLAUDE.md voi silti sisältää omaa)
echo "@AGENTS.md" > CLAUDE.md

# Vaihtoehto B: symlink (kun sisältö on täsmälleen sama)
ln -s AGENTS.md CLAUDE.md

Kontekstihierarkia

AI-agentti saa kontekstia useasta lähteestä. Ymmärrä hierarkia:

1. Projektitason säännöt — AGENTS.md (globaalit säännöt)
2. Kansiontason säännöt — Alikansioiden omat AGENTS.md:t (spesifiset säännöt)
3. Tiedostotason konteksti — Avoimet tiedostot, importit, tyypit
4. Keskustelukonteksti — Käyttäjän antamat promptit ja aiempi keskustelu

projekti/
├── AGENTS.md              # Globaalit säännöt
├── src/
│   ├── AGENTS.md          # src-kansion säännöt
│   ├── components/
│   │   └── AGENTS.md      # Komponenttisäännöt
│   └── lib/
│       └── AGENTS.md      # Kirjastosäännöt
└── tests/
  └── AGENTS.md          # Testisäännöt

Yhteenveto

• Agenttinen koodaus muuttaa kehittäjän roolia koodin kirjoittajasta ohjaajaksi
• AI-koodaustyökalut jakautuvat IDE-integraatioihin, CLI-agentteihin ja chat-käyttöliittymiin
• AGENTS.md on tärkein tiedosto AI-avusteisen kehityksen ohjaamiseen
• Projektisäännöt varmistavat yhdenmukaisen ja laadukkaan koodin
• Kontekstihierarkia mahdollistaa kansiokohtaiset tarkennetut säännöt
• Seuraavaksi opimme Skills-järjestelmän, joka tekee AI:n kyvykkyyksistä löydettäviä