Claude Architect · Oppitunti

Koodin generointi ja kehittäjien tuottavuus

CLAUDE.md, suunnittelutila, sisäänrakennetut työkalut ja tutkiminen.

Oppitunti 2/413 vaihetta

Koodin generointi ja kehittäjien tuottavuus on ilmainen Claude Architect-oppitunti CoddyKitissä. Tämä on oppitunti 2/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu Claude Architect-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Claude Architect-kurssilla on yhteensä 4 oppituntia.

Skenaario 4: Kehittäjän tuottavuus

Tämä oppitunti käsittelee skenaariota 4 — Kehittäjän tuottavuus, joka on yksi kahdeksasta koeskenaariosta. Arkkitehdin tehtävä on tehdä Claude Codesta tehokas työtoveri oikeassa repositoriossa: tutkia vierasta koodia, suunnitella muutoksia turvallisesti ja säilyttää tiimin käytännöt.

Tässä skenaariossa suurin osa kokeen painosta kohdistuu kolmeen pilariin:

CLAUDE.md — pysyvä, jaettu projektimuisti.
Plan mode — tutki ja ehdota ennen muokkaamista.
Sisäänrakennetut työkalut ja vaiheittainen tutkiminen — Glob-, Grep-, Read-, Write-, Edit- ja Bash-työkaluja käytetään kurinalaisessa silmukassa.

Kun hallitsette nämä päätökset, osaatte ratkaista useimmat D3 (Config & Workflows) -kysymykset.

CLAUDE.md-hierarkia

CLAUDE.md on pysyvä konteksti, joka ladataan automaattisesti jokaiseen istuntoon. Sillä on kolme laajuutta, ja oikean laajuuden valitseminen on usein kokeessa testattava päätös:

Käyttäjätaso ~/.claude/CLAUDE.md — henkilökohtaiset asetukset. EI jaeta VCS:n kautta, joten uudet tiimin jäsenet eivät koskaan näe sitä.
Projektitaso ./CLAUDE.md tai .claude/CLAUDE.md — commitoidaan repositorioon ja jaetaan koko tiimille.
Hakemistotaso — rajattu alipuuhun ja ladataan kyseisessä kansiossa työskenneltäessä.

Nyrkkisääntö: kaiken, mitä jokaisen osallistujan on noudatettava, tulee olla projektitason tiedostossa. Tiimin käytäntöjen sijoittaminen vain käyttäjätason tiedostoon on klassinen ansavastaus.

# Project memory — committed to VCS, shared with the team
# ./CLAUDE.md

## Build
- `yarn build` then run `dist/main.js`

## Conventions
- Use absolute imports from `src/`
- All API errors return structured `{ code, message }`
- Never commit secrets; read from env vars

CLAUDE.md:n modulaaristaminen @import-komennoilla

Monoliittinen CLAUDE.md kasvaa hankalaksi hallita ja kuluttaa kontekstitunnisteita jokaisella vuorolla. Kaksi mekanismia pitää sen tiiviinä:

@path-importit — tuovat modulaarisia tiedostoja, esimerkiksi @./standards/coding-style.md, jolloin jaetut standardit ovat omissa versioiduissa tiedostoissaan.
.claude/rules/-tiedostot — jokainen sisältää YAML-etumateriaalin ja paths-globin, ja latautuu vain vastaavia tiedostoja muokattaessa. Näin säästyy kontekstia verrattuna siihen, että kaikki ahdettaisiin yhteen aina ladattavaan CLAUDE.md-tiedostoon.

Käyttäkää sääntöjä tarkasti rajattuun ohjeistukseen (esimerkiksi testikäytäntöihin), joka on suurimman osan ajasta tarpeetonta.

---
# .claude/rules/testing.md
paths:
  - "**/*.test.ts"
  - "**/*.spec.ts"
---

# Loaded ONLY when editing test files
- Use the existing `makeTestClient()` helper
- One assertion concern per `it(...)` block
- Never mock the database; use the in-memory fixture

Muistin muokkaaminen: /memory ja /compact

Kaksi kauttaviivakomentoa hallitsee pitkäkestoista kontekstia:

/memory muokkaa CLAUDE.md-tiedostoa suoraan ja säilyy istuntojen välillä — käyttäkää sitä hyväksi havaitun käytännön tallentamiseen, jotta sitä noudatetaan seuraavalla kerralla.
/compact tiivistää nykyisen keskustelun vapauttaakseen tilaa konteksti-ikkunaan. Huomioikaa: vaiheittainen tiivistäminen tekee luvuista, prosenteista ja päivämääristä epätarkkoja. Jos tarkoilla arvoilla on merkitystä, säilyttäkää ne sanatarkasti yhteenvedon ulkopuolella sen sijaan, että luottaisitte /compactiin.

Kokeessa verrataan mielellään pysyvää muistia (CLAUDE.md) ja tilapäistä tiivistämistä (/compact) — ne ratkaisevat eri ongelmia.

# Persist a convention into CLAUDE.md (survives future sessions)
/memory

# Compress the running conversation to reclaim context window
/compact

Plan mode: tutki ennen muokkaamista

Plan mode antaa Clauden tutkia koodikantaa ja ehdottaa lähestymistapaa, jonka hyväksytte ennen kuin mitään muutoksia otetaan käyttöön. Käyttäkää sitä, kun:

Muutos on suuri tai koskee useita tiedostoja.
Punnittavana on useita toimivia lähestymistapoja.
Kyseessä on arkkitehtuuripäätös.
Haluatte tutkia vierasta koodia ensin turvallisesti.

Yhden tiedoston korjauksessa tai selkeän stack tracen tapauksessa ohittakaa plan mode ja siirtykää suoraan suoraan suoritukseen — suunnittelun lisäkustannus menisi siinä hukkaan. Tämän skenaarion ydinpäätös on sovittaa tila tehtävän kokoon.

Tutkimisen eristäminen Explore-aliagentilla

Tutkiminen tuottaa paljon yksityiskohtaista tulostetta — tiedostovedoksia, hakutuloksia ja jäljitystietoja — jotka voivat täyttää pääkonteksti-ikkunan. Explore-alusagentti eristää tämän selvitystyön ja palauttaa tiivistetyn yhteenvedon raakadatan sijaan.

Tämä noudattaa samaa periaatetta kuin Skill, jossa on context: fork: suorita sotkuinen ja paljon tokeneita kuluttava osa eristetyssä kontekstissa, jotta pääistunto pysyy keskittyneenä. Yhdistä suunnittelutila Explore-vaiheeseen, kun muutokset ovat suuria ja ennestään tuntemattomia.

---
# .claude/skills/audit-deps.md
name: audit-deps
description: Scan the repo for outdated/vulnerable dependencies
context: fork          # isolate verbose scan output
allowed-tools: [Bash, Grep, Read]
argument-hint: "[package-name]"
---

Run the dependency audit and report only actionable findings.

Sisäänrakennetut työkalut

Claude Code sisältää kohdennetun joukon sisäänrakennettuja työkaluja. Kokeessa on olennaista tietää, MIHIN kukin niistä on tarkoitettu:

Glob — etsii tiedostoja mallin perusteella, esimerkiksi **/*.test.tsx.
Grep — hakee tiedostojen sisällöstä.
Read — lataa tiedoston kontekstiin.
Write — luo tiedoston.
Edit — tekee täsmällisen muutoksen yksilöllisen osuman perusteella.
Bash — suorittaa shell-komentoja.

Glob etsii tiedostoja nimen tai mallin perusteella, kun taas Grep etsii tiedostojen sisällöstä. Näiden sekoittaminen keskenään on yleinen harhautusvaihtoehto.

# Glob: locate files by pattern
**/*.service.ts

# Grep: search contents across the repo
grep -rn "process_refund" src/

# Bash: run the test suite
yarn test --runInBand

Edit verrattuna Read+Writeen

Edit tekee täsmällisen muutoksen etsimällä tiedostosta yksilöllisen merkkijonon. Jos kohdemerkkijono ei ole yksilöllinen, muutos epäonnistuu — tämä on turvaominaisuus, ei virhe.

Oikea varamenettely on lukea tiedosto Readillä ja kirjoittaa se sitten Writeillä kokonaan korjattuna versiona. Vaihtoehtoisesti voitte laajentaa osumaa ympäröivällä kontekstilla niin, että siitä tulee yksilöllinen. Älkää pakottako epäselviä muutoksia, sillä vaarana on väärän esiintymän muuttaminen.

Edit sopii kirurgisiin ja yksiselitteisiin muutoksiin, kun taas Read+Write sopii laajempiin tai epäselviin uudelleenkirjoituksiin.

# Pseudocode of the decision
# 1) Try a unique-match Edit
#    old_string must appear EXACTLY once in the file
# 2) If the match is not unique -> Edit fails
# 3) Fallback: Read the whole file, then Write the corrected version
#    (or add more surrounding lines to old_string to disambiguate)

Vaiheittainen tutkiminen

Kokeessa palkitaan kurinalainen tutkimissilmukka sen sijaan, että koko repositorio ladattaisiin kontekstiin. Kanoninen toimintamalli on seuraava:

Grep lähtöpisteistä: mistä tämä ominaisuus alkaa?
Read löytämistänne olennaisista tiedostoista.
Grep löytämienne symbolien käyttökohteista.
Read käyttävistä osista ymmärtääksenne vaikutukset.

Näin rajaatte aluetta vaihe vaiheelta ja vältätte liian täyteen ahdetun kontekstin aiheuttaman keskeltä unohtamisen ongelman. Karsikaa samalla työkalujen yksityiskohtaisesta tulosteesta esiin vain olennaiset kentät.

# 1) Find the entry point
grep -rn "router.post('/refund'" src/

# 2) Read the handler file (Read tool)
# 3) Grep usages of the function it calls
grep -rn "processRefund(" src/

# 4) Read each consumer to assess blast radius

Ulottuvuuden laajentaminen MCP:llä

Sisäänrakennetut työkalut kattavat paikallisen tiedostojärjestelmän ja shellin. Ulkoisiin järjestelmiin — kuten GitHub-repositorioon, tietokantaan tai issue-seurantaan — pääsette yhdistämällä MCP-palvelimen.

Palvelimen primitiivit: Tools (toiminnot), Resources (vain luku -muotoinen data, kuten skeemat ja luettelot) sekä Prompts (mallipohjat).
Laajuus: project .mcp.json (jaettu versionhallinnassa) verrattuna user ~/.claude.json -asetukseen (henkilökohtainen).
Salaisuudet välitetään ympäristömuuttujien, kuten ${GITHUB_TOKEN}, kautta — älkää koskaan commitoiko tokeneita.
Suosikaa ylläpidettyä yhteisön MCP-palvelinta oman palvelimen rakentamisen sijaan tavallisissa integraatioissa.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

Komennot ja Skillit

Uudelleenkäytettävät työnkulut sijaitsevat kahdessa paikassa. .claude/commands/ on vanha muoto ja .claude/skills/ nykyinen muoto. Molemmissa noudatetaan samaa laajuussääntöä:

Projektin laajuus (repositoriossa) — jaetaan tiimille versionhallinnan kautta.
Käyttäjän laajuus (~/.claude/) — henkilökohtainen eikä jaettu.

Skillin frontmatter antaa todellisen hallinnan: context: fork eristää yksityiskohtaisen tulosteen, allowed-tools rajoittaa käyttöoikeuksia (vähimpien oikeuksien periaate) ja argument-hint dokumentoi syötteet. Paketoikaa toistuva tutkiminen projektin laajuiseksi Skilliksi, jotta koko tiimi suorittaa sen yhdenmukaisesti.

---
# .claude/skills/triage-bug.md  (project scope -> shared via VCS)
name: triage-bug
description: Reproduce a bug, locate root cause via incremental investigation
context: fork
allowed-tools: [Grep, Read, Bash]
argument-hint: "<issue-id or stack trace>"
---

Grep entry points, Read suspects, Grep usages, then summarize root cause.

Pikatarkistus: lähestymistavan valinta

Skenaariokysymys Claude Coden määrittämisestä kehittäjien tuottavuutta tukevaa työnkulkua varten.

Vastaa interaktiivisessa oppitunnissa

Kertaus: kehittäjän tuottavuuden perusteet

Skenaarion 4 tärkeimmät opit:

CLAUDE.md:n laajuus: projektitaso (jaettu versionhallinnassa) tiimin säännöille, käyttäjätaso henkilökohtaisille ja jakamattomille asetuksille sekä hakemistotaso alihakemistopuille.
Pidä kokonaisuus kevyenä: @path-tuonnit modularisoivat sisällön, ja .claude/rules/ yhdessä paths-globin kanssa lataa säännöt vain silloin, kun ne ovat merkityksellisiä.
/memory säilyttää käytännöt, kun taas /compact tiivistää sisältöä mutta voi hämärtää lukuja ja päivämääriä.
Suunnittelutila sopii suuriin, useita lähestymistapoja vaativiin tai arkkitehtonisiin muutoksiin; suora suoritus yksittäisen tiedoston korjauksiin ja selkeisiin stack traceihin. Explore-alusagentti eristää meluisan selvitystyön.
Sisäänrakennetut työkalut: Glob (haku mallin perusteella), Grep (haku sisällöstä), Read, Write, Edit (yksilöllinen osuma; tarvittaessa Read+Write) ja Bash. Tutkikaa vaiheittain: Grep lähtöpisteet -> Read -> Grep käyttökohteet -> Read käyttävät osat.
MCP laajentaa yhteydet ulkoisiin järjestelmiin; suosikaa yhteisön palvelimia, määrittäkää laajuus .mcp.json-tiedostolla ja välittäkää salaisuudet ympäristömuuttujien kautta.

Sovittakaa työkalu ja tila tehtävään ja antakaa pysyvän asetuksen huolehtia muistamisesta.

Aloita maksutta

Opi Python tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit: 26
Oppitunnit: 104

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Koodin generointi ja kehittäjien tuottavuus” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Claude Architect-oppimispolun 3 oppituntia, myös oppitunnin “Koodin generointi ja kehittäjien tuottavuus”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Claude Architect-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Koodin generointi ja kehittäjien tuottavuus”?

CLAUDE.md, suunnittelutila, sisäänrakennetut työkalut ja tutkiminen. Harjoittelet Claude Architect-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni Claude Architect-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin Claude Architect-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 2/4.

Kuinka kauan ”Koodin generointi ja kehittäjien tuottavuus”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä Claude Architect-oppitunnilla?

Kyllä. Jokainen Claude Architect-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

Tukiagentti ja monen agentin tutkimus
Koodin generointi ja kehittäjien tuottavuus
CI/CD ja rakenteinen poiminta
Keskustelumallit ja agenttiset työkalut

← Takaisin: Claude Architect