Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tikteb il-Kodiċi ma' Codex

Lezzjoni 5 / 20 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Mill-Idea għall-Kodiċi f’Istruzzjoni Waħda
  2. Ħolqien ta’ Fajl jew Modulu Ġdid
  3. Żieda ta’ Karatteristiċi f’Kodiċi Eżistenti
  4. Ġenerazzjoni tal-Kodiċi minn Speċifikazzjoni
  5. Ħidma ma’ Fajlijiet Multipli
  6. Pariri għal Riżultati Ottimali
  7. Punti Ewlenin

Mill-Idea għall-Kodiċi f’Istruzzjoni Waħda

Il-kitba tal-kodiċi hija l-kompitu li se tassenja l-aktar spiss lil Codex, u huwa fejn id-differenza bejn Codex u ġeneratur sempliċi ta’ frammenti ssir l-aktar evidenti. L-aġent ma jipproduċix biss framment ta’ kodiċi iżolat li mbagħad ikollok tadatta. Minflok, jaqra l-bażi tal-kodiċi tiegħek, jiddeduċi l-konvenzjonijiet tiegħek, u jikteb xi ħaġa li tidħol b’mod seamless fl-arkitettura eżistenti tiegħek. Ix-xogħol tiegħek, għalhekk, huwa inqas dwar id-deskrizzjoni tal-kodiċi u aktar dwar id-deskrizzjoni ta’ post fi ħdan sistema.

Ħolqien ta’ Fajl jew Modulu Ġdid

Meta tiġġenera kodiċi kompletament ġdid, il-preċiżjoni hija importanti daqs il-kuntest kemm għall-funzjonalità mistennija.

"Create a service at src/services/notification.service.ts that handles 
sending notifications via email and webhook. Use the same pattern as 
src/services/auth.service.ts. The service must expose sendEmail(to, subject, body) 
and sendWebhook(url, payload)."

Codex jaqra auth.service.ts biex jifhem il-mudell attwali, janalizza l-imports u d-dipendenzi tal-proġett, joħloq il-fajl bl-istess struttura, iżid it-tipi TypeScript xierqa, u jesporta l-funzjonijiet skont il-konvenzjonijiet tal-proġett. Ir-riżultat jidher hekk:

// src/services/notification.service.ts
import { z } from "zod";
import { logger } from "@/lib/logger";
import { env } from "@/lib/env";

const emailSchema = z.object({
  to: z.string().email(),
  subject: z.string().min(1),
  body: z.string().min(1),
});

export async function sendEmail(
  to: string, 
  subject: string, 
  body: string
): Promise<void> {
  const validated = emailSchema.parse({ to, subject, body });
  // ... implementation
}

export async function sendWebhook(
  url: string, 
  payload: Record<string, unknown>
): Promise<Response> {
  // ... implementation
}

Dettall wieħed jistħoqqilha attenzjoni: ħadd ma talab validazzjoni ta’ Zod. Codex żiedha għax innota li l-proġett juża Zod kullimkien ieħor. Għalhekk li tirreferi fajl mudell iħallas—frażi ta’ għaxar kliem tiffrankalek paragrafu sħiħ ta’ speċifikazzjoni.

Żieda ta’ Karatteristiċi f’Kodiċi Eżistenti

L-aġenti jagħtu l-aktar valur fuq kodiċi eżistenti, mhux għax il-kitba tal-linji hija diffiċli, iżda għax ir-rispett ta’ kull ma jdur magħhom huwa.

"In src/api/routes/users.ts, add a GET /users/:id/activity endpoint 
that returns the user's last 50 actions. Use the same authentication 
middleware as the other routes."

Codex janalizza r-rotot tal-qrib, jidentifika l-middleware attwali fis-seħħ, jinnota l-format attwali tar-rispons, u mbagħad iżid l-endpoint b’mod konsistenti. Dan ix-xogħol ta’ rikonoxximent jieħdok ferm itwal mill-kodiċi attwali, u huwa eżattament il-parti li n-nies jaqtgħu l-kantunieri meta jkunu f’tħabbira.

Ġenerazzjoni tal-Kodiċi minn Speċifikazzjoni

Għal karatteristiċi kumplessi, itla’ livell u ikteb speċifikazzjoni xierqa. Kull punt isir rekwiżit li l-aġent jittratta bħala tali.

"Implement a rate limiting system for the API:
- Maximum 100 requests per minute per IP
- Maximum 1000 requests per hour per authenticated user
- Return an X-RateLimit-Remaining header
- Return 429 Too Many Requests when the limit is reached
- Store counters in Redis (already configured in the project)
- Create the middleware in src/middleware/rate-limit.ts"

Din l-ispeċifikazzjoni tipprovdi valuri numeriċi, l-isem tal-header, il-kodiċi tal-istatus HTTP, l-infrastruttura disponibbli, u l-post tal-fajl. Kull dettall ineħħi deċiżjoni arbitrarja li Codex kieku jagħmel għalik—deċiżjoni li ssejbha biss waqt ir-reviżjoni tal-kodiċi.

Ħidma ma’ Fajlijiet Multipli

Kompitu wieħed jista’ leġittimament jifrex fuq diversi saffi tal-applikazzjoni, sakemm telenka l-prodotti finali.

"Add an in-app notification system:
1. Prisma model Notification (id, userId, type, message, read, createdAt)
2. Service at src/services/notification.service.ts
3. CRUD API routes in src/api/routes/notifications.ts
4. Tests in src/api/routes/notifications.test.ts"

Codex jipproduċi l-erba’ fajlijiet kollha b’mod koerenti: is-servizz jiddependi fuq il-mudell Prisma, ir-rotot iseħħu s-servizz, u t-testijiet ikopru r-rotot. Il-kisba ta’ din il-konsistenza vertikali hija diffiċli jekk taqsam it-talba f’erba’ kompiti separati, fejn kull pass irid jerġa’ jiskopri x’iddeċieda ta’ qablu—u xi kultant jikkontradixxih.

Pariri għal Riżultati Ottimali

L-ewwel, ftakar fil-qawwa li tirreferi kodiċi eżistenti: “bħal f’auth.service.ts” tittrasmetti f’ħames kelmiet mudell li jieħdok paġna biex tiddeskrivih. Semmi l-libreriji b’mod espliċitu—“uża Zod għall-validazzjoni” minflok “żid validazzjoni”—u speċifika l-format tal-output meta jkollu importanza, bħal oġġett uniformi { success, data, error } madwar l-API kollha tiegħek. Semmi każijiet limitu li jħassbuk, bħal “immaniġġja l-każ fejn l-utent ma jeżistix”: mitluq għad-deviċi tiegħu stess, l-aġent jimmaniġġja l-mogħdija ferrieħa u jħallik tiskopri l-bqija. Fl-aħħar, kull ma tirrepeti minn kompitu għal kompitu jappartjeni għal AGENTS.md, u b’hekk iżżomm l-istruzzjonijiet tiegħek qosra.

Punti Ewlenin

  • Codex jifhem il-bażi tal-kodiċi tiegħek u jirrispetta l-konvenzjonijiet eżistenti tiegħek
  • Irreferi fajlijiet eżistenti biex tiggwida l-istil u l-mudelli
  • Speċifikazzjonijiet dettaljati jipproduċu riżultati aktar preċiżi
  • Codex jista’ joħloq u jimmodifika fajlijiet multipli f’kompitu wieħed
  • AGENTS.md jikkomplementa l-istruzzjonijiet tiegħek b’regoli permanenti