romfast/comun
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
05d91a05c6b713f3d601187b63a4d20caea5ee3a
comun/docs/prompt_project_insights_docs.md
Marius Mutu c4d869921d verificare partener: garda pe cont NULL, hook-uri de disciplina, docs compactate 
- ooperatii_comune: verific_partener nu mai construieste SQL NULL cand contul
  primit e NULL (EMPTY(.NULL.) e .F. in VFP)
- utile\context_watch.ps1 si utile\docs_revizie_check.ps1: masurarea contextului
  sesiunii si cadenta reviziei de documentatie, prin hook-uri Claude Code
  (instalare in docs\monitorizare-context.md)
- reguli_lucru: delegare la subagenti, modificari minime si scoped, scrierea si
  revizuirea documentatiei, changelog strictul necesar (regulile 3, 6, 9, 11, 12)
- scripturi-migrare-db: continutul unui script (scoped, fara select, idempotent)
- teste noi pentru cele doua erori din achizitia de import
- restul documentatiei compactata, fara pierdere de reguli

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RYbiinqXxdEqXi53x4Ro7K
2026-08-02 22:30:44 +03:00

1.7 KiB
Raw Blame History

Prompt: seteaza conventia docs/ (insight-uri de proiect) intr-un proiect ROA

Template partajat intre proiectele ROA* (similar cu changelog_template.txt). Copiaza blocul de mai jos (adaptat, daca e nevoie) intr-o sesiune Claude Code din radacina oricarui proiect ROA* pentru a initializa aceeasi conventie.

In acest proiect vreau sa creezi un director docs/ cu documentatie tehnica concisa, minimalista, descoperita in timp ce lucrezi la sarcini reale (nu documentatie generica, nu ce e deja evident din cod).

Cerinte:

  1. Creeaza docs/README.md — index cu lista fisierelor din docs/ si o regula scurta: se adauga/actualizeaza o notita ori de cate ori descoperi ceva nou si ne-evident despre structura proiectului (flux ascuns, capcana, conventie, procedura/pachet cheie, tabel relevant) in timpul rezolvarii unei sarcini. Nu re-documenta ce oricine ar afla citind codul in 30 de secunde.
  2. Organizeaza notitele in fisiere separate pe subiect, nu un singur fisier uriaș — ex: flux-<nume-flux>.md, pachet-<nume-pachet>.md, tabele.md.
  3. In CLAUDE.md (la final), adauga o sectiune "Project insights (docs/)" care:
    • trimite spre docs/README.md
    • imi cere sa iti ofer proactiv actualizarea docs/ ori de cate ori descoperi un insight ne-evident, fara sa astept sa fiu intrebat
  4. Daca docs/ sau o sectiune similara in CLAUDE.md exista deja, nu duplica — extinde ce exista.
  5. Nu inventa continut acum daca nu am rezolvat inca o problema concreta in acest proiect — doar pregateste structura (README + sectiunea din CLAUDE.md). Prima notita de continut se scrie cand rezolvam ceva impreuna.

Intreaba-ma doar daca trebuie sa alegi intre variante (ex. denumirea directorului); altfel foloseste docs/ ca implicit.