Suunnittelutila ja suora suoritus
Suunnittele suuret tai monitulkintaiset muutokset ja suorita pienet, selkeät muutokset suoraan.
Suunnittelutila ja suora suoritus on ilmainen Claude Architect-oppitunti CoddyKitissä. Tämä on oppitunti 3/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.
Kaksi toimintatilaa, yksi päätös
Claude Codessa teet jatkuvasti yhden harkintapäätöksen: suunnitellako ensin vai suorittaako heti?
Plan Mode antaa Clauden tutkia ja lukea tiedostoja sekä ehdottaa kirjallista suunnitelmaa, jonka hyväksyt ennen kuin muutokset tehdään. Suora suoritus siirtyy heti muutosten tekemiseen.
Taitoa ei ole tarkoitettu valitsemaan yhtä toimintatapaa pysyvästi. Se sovittaa toimintatilan tehtävän kokoon ja selkeyteen. Suuri tai epäselvä tehtävä? Suunnittele. Pieni ja selkeä? Suorita.
Mitä Plan Mode käytännössä tarjoaa
Plan Mode tarjoaa neljä konkreettista hyötyä:
- Turvallinen tutkiminen — Claude lukee ja tutkii koskematta tiedostoihin.
- Hyväksyntävaihe — tarkistat ehdotetun suunnitelman ennen muokkausten tekemistä.
- Lähestymistapojen vertailu — kun ratkaisuja on useita, näet ne rinnakkain.
- Arkkitehtuurin hahmottaminen — suunnittelupäätökset tulevat esiin varhain, eivät kesken muokkauksen.
Käytä sitä suuriin muutoksiin, tilanteisiin joissa lähestymistapoja on useita, sekä arkkitehtuuripäätöksiin, joissa väärän suunnan korjaaminen olisi kallista.
Milloin suora suoritus on parempi
Plan Mode aiheuttaa ylimääräisen vaiheen: luet suunnitelman ja hyväksyt sen. Pienessä työssä tämä ylimääräinen vaihe on pelkkää kitkaa.
Siirry suoraan suorittamiseen, kun muutos on:
- Yhden tiedoston korjaus, jossa muutos on ilmeinen.
- Sellainen, johon selkeä stack trace osoittaa suoraan tietyn rivin.
- Pieni, hyvin rajattu ja riskiltään vähäinen.
Jos tiedät jo tiedoston, rivin ja korjauksen, suunnittelu vain hidastaa työtä.
Päätöksen heuristiikka
Tiivistä päätös kahteen kysymykseen:
- Onko muutos suuri? Useita tiedostoja, uusia moduuleja, refaktorointeja tai migraatioita.
- Onko muutos epäselvä? Epäselvät vaatimukset, useita kelvollisia suunnitelmia tai tuntematon vaikutusala.
Jos jompikumpi pitää paikkansa, suunnittele ensin. Jos kumpikaan ei pidä paikkaansa — muutos on pieni ja selkeä — suorita se suoraan.
Tämä vastaa kokeen periaatetta: varaa raskaampi prosessi tilanteisiin, joissa epävarmuus ja vaikutukset ovat suuria, ja pidä kevyet polut kevyinä.
Selkeä virhe: suorita suoraan
Tässä stack trace ilmoittaa tiedoston ja syyn. Oikea korjaus on yksi, eikä suunnittelupäätöstä tarvita. Suunnittelu ei tuo lisäarvoa.
Pyytäisit Claudea yksinkertaisesti tekemään korjauksen: se lukisi tiedoston työkalulla Read ja tekisi täsmällisen Edit-muokkauksen ainoalle täsmäävälle riville.
# Clear stack trace -> direct execution, no plan needed
# TypeError: 'NoneType' object has no attribute 'id'
# at services/billing.py line 88: customer.id
# Prompt to Claude Code:
# "billing.py:88 crashes when get_customer returns None.
# Guard the None case and return a 404-style error. Apply the fix."
# Claude: Read billing.py -> Edit line 88 (unique match) -> done.Suuri muutos: suunnittele ensin
Verrataan tätä pyyntöön kuten "lisää sovellusliittymään monen vuokraajan tuki". Muutos koskee todennusta, tietokerrosta, reititystä ja migraatioita. Kelvollisia suunnitelmia on useita ja vaikutusala on suuri.
Tämä on tyypillinen Plan Mode -tilanne: anna Clauden tutkia koodikantaa vain luku -tilassa ja ehdottaa sitten suunnitelmaa, jonka hyväksyt ennen ensimmäistäkään muokkausta.
# Ambiguous + large -> enter Plan Mode first
# In Claude Code: toggle Plan Mode, then:
# "Add tenant isolation across the API. Explore the current
# auth, models, and routing. Propose 2 approaches with trade-offs.
# Do NOT edit anything until I approve a plan."
# Output: a written plan + approaches -> you approve -> edits begin.Eristä etsintä Explore-subagentilla
Suurten muutosten suunnittelu tarkoittaa monien tiedostojen lukemista, ja etsinnän tuloste on yksityiskohtaista. Sen kaiken tuominen pääkontekstiin aiheuttaa lost-in-the-middle-tarkkaavaisuushäviötä ja kuluttaa tokeneita.
Eristä etsintä käyttämällä Explore-subagenttia. Se tutkii kohteen ja palauttaa tiiviin yhteenvedon, jolloin suunnittelukonteksti pysyy siistinä. Taidot voivat tehdä saman käyttämällä asetusta context: fork yksityiskohtaisen tulosteen eristämiseen.
# .claude/skills/explore-codebase/SKILL.md frontmatter
---
name: explore-codebase
description: Map files relevant to a feature and return a concise summary
context: fork # isolate verbose discovery output
allowed-tools: [Glob, Grep, Read] # read-only, least privilege
argument-hint: <feature-area>
---Plan Mode ja hyväksyntävaihe
Hyväksyntävaihe on koko toimintatavan ydin. Luettavan suunnitelman avulla voit havaita väärän oletuksen ennen kuin se johtaa 15 tiedoston muokkaamiseen.
Tämä on determinististä, ihmisen mukana pitävää hallintaa. Se sopii luontevasti arkkitehdin ajattelutapaan: kun vaikutukset ovat suuret, tarvitset tiukan tarkistuspisteen etkä toivoa siitä, että malli arvasi tarkoituksesi oikein. Kehotteet ovat noin 90-prosenttisesti probabilistisia; hyväksyntävaihe on 100-prosenttisesti omassa hallinnassasi.
Tutki ennen päätöstä
Joskus et voi tietää tehtävän kokoa ennen tutkimista. Älä arvaa — tutki vaiheittain ja valitse vasta sitten toimintatila.
Sisäänrakennettu toimintamalli on: suorita Grep lähtökohdille, lue tärkeät tiedostot komennolla Read, etsi käyttökohdat komennolla Grep ja lue käyttäjät komennolla Read. Jos vaikutusala osoittautuu suureksi, siirry Plan Modeen; jos kyse on yhdestä erillisestä kohdasta, korjaa se suoraan.
# Incremental investigation drives the plan-vs-execute call
# 1) find where the symbol lives
# Grep "def calculate_tax"
# 2) read it
# Read services/tax.py
# 3) find callers
# Grep "calculate_tax("
# 4) read consumers -> 1 caller? execute. 12 callers? plan.Plan Mode toimii yhdessä TDD:n ja CLAUDE.md:n kanssa
Plan Mode ei toimi yksin — se on osa Claude Code -työnkulkuasi.
- Jaettu ./CLAUDE.md (versionhallinnassa) antaa suunnitelmalle standardisi ja käytäntösi etukäteen.
- TDD: pyydä suunnitelmaa kirjoittamaan ensin epäonnistuvat testit ja toteuta sitten ratkaisu niin, että testit menevät läpi.
- Vinokomentot / taidot hakemistossa
.claude/voivat sisältää toistettavan, tiimin kanssa jaetun "suunnittele tämä ominaisuus" -työnkulun.
Suunnitelmasta tulee sopimus, ja testit osoittavat, että se täytettiin.
# CLAUDE.md feeds the plan your rules
## Engineering rules
- Write a failing test before implementing (TDD).
- New endpoints require an integration test.
- Plan multi-file changes; approve before editing.Älä suunnittele liikaa tai liian vähän
Kumpikin ääripää maksaa:
- Ylisuunnittelu yhden rivin korjauksessa, jonka stack trace tekee ilmeiseksi, tuhlaa aikaa ja lisää tarpeettoman hyväksyntävaiheen.
- Alisuunnittelu laajassa refaktoroinnissa tarkoittaa, että muokkaukset tehdään ennen lähestymistavan tarkistamista — juuri sen kalliin virheen ehkäisemiseksi hyväksyntävaihe on olemassa.
Sovita toimintasi tehtävän kokoon ja selkeyteen. Kun olet aidosti epävarma, suosi suunnittelua suurissa tai epäselvissä tehtävissä ja suoraa suoritusta pienissä, selkeissä tehtävissä nopean tarkistuksen jälkeen.
Pikatarkistus: valitse toimintatila
Sovella päätöksen heuristiikkaa realistiseen pyyntöön.
Kertaus: sovita toimintatila tehtävään
Tärkeimmät opit:
- Plan Mode suuriin tai epäselviin tehtäviin: laajat muutokset, useat lähestymistavat, arkkitehtuuripäätökset sekä turvallinen tutkiminen, jota seuraa hyväksyntä ennen muokkauksia.
- Suora suoritus pieniin ja selkeisiin tehtäviin: yhden tiedoston korjauksiin ja selkeisiin stack traceihin.
- Päätössääntö: jos muutos on suuri TAI epäselvä, suunnittele; jos se on pieni JA selkeä, suorita.
- Tutki vaiheittain (Grep -> Read -> Grep -> Read), jos et pysty arvioimaan kokoa etukäteen, ja valitse toimintatila vasta sitten.
- Eristä yksityiskohtainen etsintä Explore-subagentilla (tai taidolla, jossa on
context: fork) suojataksesi suunnittelukontekstia. - Hyväksyntävaihe on determinististä ihmisen hallintaa — älä luovu siitä vaikutuksiltaan merkittävissä muutoksissa.
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
Usein kysytyt kysymykset
Onko oppitunti ”Suunnittelutila ja suora suoritus” ilmainen?
Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa Claude Architect-oppimispolun 3 oppituntia, myös oppitunnin “Suunnittelutila ja suora suoritus”. 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 ”Suunnittelutila ja suora suoritus”?
Suunnittele suuret tai monitulkintaiset muutokset ja suorita pienet, selkeät muutokset suoraan. 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 3/4.
Kuinka kauan ”Suunnittelutila ja suora suoritus”-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
- Mukautetut komennot ja taidot
- Taidon frontmatter
- Suunnittelutila ja suora suoritus
- Iteratiivinen tarkentaminen esimerkkien avulla