Kirjoita toimiva brief

Jokainen vuoro projektissa alkaa composerista — syötekentästä projektinäytön alalaidassa (ja aloitusnäytöllä uutta projektia varten). Mitä siihen kirjoitat, ratkaisee ajon enemmän kuin mikään asetus: tämä sivu käy läpi sen kontrollit ja miten agenttia kannattaa briefata.

Composer — syöte, agentti-chip, effort, laatutila ja Send-painike

Kontrollit

  • Input — itse brief. Yksi viesti per vuoro; Enter lähettää, Shift+Enter katkaisee rivin.
  • Agent chip — CLI ja malli, jolla tämä vuoro ajetaan (Claude Code · Default). Klikkaa vaihtaaksesi agenttia tai mallia ajoa kohden.
  • Effort — kuinka kovasti agentti työskentelee ongelman parissa; Fast iteraatioon, korkeampi viimeistelyyn.
  • Quality mode — Fast, Reviewed tai Council — miten tulos tarkistetaan ennen kuin se laskeutuu (katso Laatutilat).
  • Attach — pudota tiedostoja tai videoviitteitä vuoroon (katso Liitteet ja videoviitteet).
  • History — palauta projektin aiempi tila (katso Historia ja palautus).
  • Send — käynnistää vuoron; agentin työskennellessä se vaihtuu busy-tilaan.

Briefin anatomia

Hyvä brief kantaa kolme asiaa, yleensä yhdessä tai kahdessa lauseessa:

  1. Mitä se on — "aloitussivu", "hinnoitteluosio", "tyhjä tila"
  2. Kenelle tai mille se on — "kahvitilaukselle", "ensikertalaisille käyttäjille"
  3. Tunnelma — "tumma, editorial, itsevarma typografia", "hiljainen, kalliin tuntuinen"

Jätä speksitason yksityiskohdat (tarkat pikselit, tarkat hex-arvot) pois — design system omistaa ne päätökset, ja niiden ohittaminen paloittain tuottaa huonompia tuloksia kuin selkeä suunta johdonmukaisesti sovellettuna.

Jatkot ovat ohjausta, eivät uudelleenkäynnistyksiä

Ensimmäisen vuoron jälkeen composer on keskustelu. Jokainen jatko muokkaa samoja tiedostoja paikallaan — "vaihda hero-kuva tuotekuvaan" tai "tee navista kevyempi" — joten hiot sen sijaan, että generoisit uudelleen. Täysin eri suuntaan haarauta versio tai aja variantteja sen sijaan.

Vinkki: Kun korjaus koskee tiettyä elementtiä, älä kuvaile sitä — pinnaa se. ⌥-klikkaa elementtiä esikatselussa, niin kommentti laskeutuu tarkalleen oikeaan solmuun. Katso Poimi, kommentoi ja piirrä.

Pinnit, kommentit ja viitteet kulkevat mukana

⌥-klikkauksella asettamasi kommentit, Designer Talk -muistiinpanot ja liitetyt tiedostot taitetaan seuraavaan briefiin automaattisesti — agentti näkee ohjauksen kontekstissa, ei paljaana ohjeena. Ratkaise tai tyhjennä pinnit, kun korjaus laskeutuu, jotta seuraava vuoro ei lue vanhoja muistiinpanoja uudelleen.

Katso myös