Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Syvällinen arkistoanalyysi

Oppitunti 12 / 20 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Syvällinen arkistoanalyysi
  2. Analysoi muuttamatta mitään
  3. Nopeuta teknistä perehdytystä
  4. Tarkista riippuvuudet ja tekninen velka
  5. Arvioi ulkoinen projekti ennen käyttöönottoa
  6. Hanki toimintakelpoisia raportteja
  7. Keskeiset asiat

Oppitunti päivitetty 3. marraskuuta 2026 Codex-oppaan perusteella: “Deep Research for GitHub” ei ole Codex-ominaisuus. Arkistoanalyysi suoritetaan Codexilla lukutilassa, kun taas syvällinen tutkimus on ChatGPT Work -ominaisuus, jonka saatavuus riippuu tilistäsi ja työtilastasi. Edellisen version lähdeviitteetön kestojen vertailutaulukko on poistettu. Lähteet: Codex CLI · Ei-vuorovaikutteinen tila.

Syvällinen arkistoanalyysi

Ennen koodin muokkaamista sinun on usein ymmärrettävä se ensin: vanhan projektin arkkitehtuuri, sen riippuvuudet ja tekninen velka. Tähän tarkoitukseen sopii kaksi työkalua. Codex analysoi arkistoa sisältäpäin – se lukee tiedostoja, tutkii Git-historiaa ja suorittaa diagnostisia komentoja – tekemättä muutoksia. ChatGPT Workin syvällinen tutkimus tekee selvityksiä useista lähteistä ja toimittaa lähdeviitteellisen raportin; se on oikea työkalu kysymyksiin, jotka ylittävät arkiston rajat, kuten ulkoisen kirjaston arviointiin.

Analysoi muuttamatta mitään

Tavallinen Codex-tehtävä suorittaa toiminnon: kirjoittaa koodia, korjaa bugin tai generoi testejä. Analyysia varten pyydä Codexia tiivistämään muuttamatta mitään ja anna sille keinot pysyä tässä rajoituksessa. Aseta istunto lukutilaan (/permissions, tila read-only) tai suorita analyysi komennolla codex exec, joka oletusarvoisesti käyttää lukutilan hiekkalaatikkoa. Se voi skannata satoja tiedostoja, tutkia Git-historiaa ja tuottaa yksityiskohtaisen raportin. Tämä ero näkyy välittömästi kehotteessasi, jonka tulee keskittyä ymmärtämiseen eikä muokkaamiseen:

"Analyze the architecture of this project without modifying any files. 
How does data flow from the API to the database? What patterns are 
used? Where are the fragility points?"

Tulos ei ole commit vaan jäsennelty asiakirja, joka sisältää viittauksia asiaankuuluviin tiedostoihin ja suosituksia. Käyt läpi tuloksen, keskustelet siitä teknisessä palaverissa ja korjaat virheet.

Nopeuta teknistä perehdytystä

Kun kehittäjä liittyy tiimiin, hän käyttää yleensä ensimmäiset kaksi viikkoa sellaisen kartan henkiseen rekonstruointiin, jota kukaan ei ole koskaan kirjoittanut ylös: mikä palvelu kutsuu mitäkin, miksi moduulilla on nimi, joka ei enää vastaa sen sisältöä, tai missä laskutuslogiikka piileskelee. Codex voi piirtää tämän kartan hänelle:

"Analyze this repository and generate an onboarding guide 
for a new developer. Cover:
- General architecture and layers
- Naming and structure conventions
- End-to-end flow of a typical request
- The most important files to read first
- Common pitfalls and project-specific quirks"

Syntyvä asiakirja toimii viitekehyksenä ensimmäisten viikkojen aikana, ja sitä korjataan tiimin antaman palautteen myötä. Tällä korjausharjoituksella on odottamaton hyöty: se paljastaa sokeita pisteitä, joita kukaan ei ole vaivautunut dokumentoimaan, koska “kaikki tietävät, miten tämä toimii”.

Tarkista riippuvuudet ja tekninen velka

Toinen luonteva käyttötarkoitus on inventaario. Kolme vuotta vanha koodikanta kerää hylättyjä kirjastoja, toiminnallisia duplikaatteja ja kuolleita tuonteja, joita kukaan ei uskalla poistaa yleiskuvan puuttuessa:

"Analyze all project dependencies (package.json 
and lock file). Identify:
- Obsolete packages (last update > 1 year ago)
- Known vulnerabilities
- Duplicate packages (same functionality)
- Unused packages (imported nowhere)
- Packages with incompatible licenses"

Tässä analyysissä ristiviitataan package.json, lukitustiedosto ja koodissa todella esiintyvät tuonnit. Tunnettujen haavoittuvuuksien ja pakettien ylläpitostatuksen selvittäminen vaatii julkista dataa, joten sinun on joko sallittava verkkoyhteys nimenomaisesti tai käytettävä paketinhallintatyökalusi auditointityökaluja (kuten npm audit). Teknisen velan arviointi noudattaa samaa logiikkaa, yhtä lisävaatimusta lukuun ottamatta – kehotteen viimeinen rivi. Ilman lajittelukriteereitä saat listan neljästäkymmenestä ongelmasta ilman käsitystä siitä, mistä aloittaa.

"Evaluate the technical debt of this project. Analyze:
- Cyclomatic complexity of core modules
- Most frequently modified files (Git hotspots)
- Code duplication patterns
- Unresolved TODOs and FIXMEs
- Test coverage by module
Rank problems by impact and effort to fix."

Näiden analyysien arvo piilee sijoitetun ajan ja saatujen tulosten suhteessa: muutama tarkka ohje korvaa päivien lukemisen. Mittaa tämä omilla projekteillasi äläkä luota yleisiin arvioihin, ja käy aina raportti läpi: agentti voi olla väärässä, erityisesti siitä, mitä arkistossa ei ole.

Arvioi ulkoinen projekti ennen käyttöönottoa

Kun harkitset avoimen lähdekoodin kirjaston käyttöönottoa, kysymys ulottuu arkistoa laajemmalle: julkaisutiheys, ongelmien aktiivisuus ja maine. Tämä on ChatGPT Workin syvällisen tutkimuksen aluetta. Vaihda työpöytäsovelluksessa tilaan Work, avaa Plugins ja valitse Deep research; verkkoselaimessa avaa +-valikko Work-keskustelussa. Saatavuus riippuu tilistäsi ja työtilastasi:

"Analyze the repository github.com/org/library. 
Evaluate its maturity:
- Release frequency and maintenance
- Documentation quality
- Community activity (issues, PRs)
- Test coverage
- Recommendation: Is it safe to adopt in production?"

Tämä on varmistusvaihe, jonka lähes aina ohitamme, koska emme voi uhrata siihen puolta päivää, mutta sen puuttuminen maksaa meille kaksi vuotta myöhemmin: kirjastoa ei enää ylläpidetä, sen ainoa ylläpitäjä on kadonnut, ja sinulle jää riippuvuus, joka on kirjoitettava uudelleen kiireessä.

Hanki toimintakelpoisia raportteja

Raportin laatu riippuu suoraan kehotteen tarkkuudesta. “Missä ovat heikkouskohdat?” tuottaa paljon hyödyllisemmän tuloksen kuin “Analysoi projekti”, koska ensimmäinen muotoilu asettaa näkökulman ja pakottaa hierarkian muodostamiseen. Pyydä myös eksplisiittiä muotoilua – “lajittele tärkeysjärjestykseen”, “järjestä moduuleittain” – saadaksesi asiakirjan, jonka voi silmäillä eikä lukea kantta kanteen. Seuraa tätä konkreettisilla Codex-tehtävillä, jotka korjaavat tunnistetut ongelmat. Tässä vaiheessa analyysi lakkaa olemasta vain yksi raportti lisää ja siitä tulee työsuunnitelman lähtökohta. Lopuksi jaa nämä raportit tiimisi kanssa, sillä niiden arvo kasvaa sen myötä, kuinka moni henkilö viittaa niihin päivittäin.

Keskeiset asiat

  • Analysoi arkistoa suorittamalla Codex lukutilassa (/permissions tai codex exec, joka on oletusarvoisesti lukutilassa)
  • Ihanteellinen perehdytykseen, auditointeihin ja teknisen velan arviointiin
  • ChatGPT Workin syvällinen tutkimus sopii useista lähteistä peräisin oleviin kysymyksiin, kuten ulkoisen kirjaston arviointiin
  • Tulokset syötetään konkreettisiin Codex-tehtäviin tunnistettujen ongelmien korjaamiseksi
  • Käy jokainen raportti läpi: agentti voi olla väärässä, erityisesti puuttuvan sisällön osalta