Initializeaza conventia partajata ROA* pentru insight-uri de proiect: docs/README.md listeaza doar notite structurale permanente (nu PRD-uri, spike-uri sau diff-uri de review, care sunt legate de sarcini punctuale).
832 B
832 B
docs/ — insight-uri de proiect ROAAUTO
Documentație tehnică concisă, minimalistă, descoperită în timp ce lucrăm la sarcini reale (nu documentație generică, nu ce e deja evident din cod).
Regulă: adaugă sau actualizează o notiță aici ori de câte ori descoperi ceva nou și ne-evident despre structura proiectului (flux ascuns, capcană, convenție, procedură/pachet cheie, tabel relevant) în timpul rezolvării unei sarcini. Nu re-documenta ce oricine ar afla citind codul în 30 de secunde.
Notițele sunt organizate pe fișiere separate, câte un subiect pe fișier (ex.
flux-<nume-flux>.md, pachet-<nume-pachet>.md, tabele.md), nu un singur fișier uriaș.
Fișiere
- cautare_vcx_vct.md — cum se caută cod în binarele
.vcx/.scx(conversie text + grep pe cache)