Codebase Concerns

April 14, 2026 ยท View on GitHub

Core Sections (Required)

1) Top Risks (Prioritized)

SeverityConcernEvidenceImpactSuggested action
[high/med/low][issue][file or scan output][impact][next action]

2) Technical Debt

List the most important debt items only.

Debt itemWhy it existsWhereRisk if ignoredSuggested fix
[item][reason][path][risk][fix]

3) Security Concerns

RiskOWASP category (if applicable)EvidenceCurrent mitigationGap
[risk][A01/A03/etc or N/A][path][what exists][what is missing]

4) Performance and Scaling Concerns

ConcernEvidenceCurrent symptomScaling riskSuggested improvement
[issue][path/metric][symptom][risk][action]

5) Fragile/High-Churn Areas

AreaWhy fragileChurn signalSafe change strategy
[path][reason][recent churn evidence][approach]

6) [ASK USER] Questions

Add unresolved intent-dependent questions as a numbered list.

  1. [ASK USER] [question]

7) Evidence

  • [scan output section reference]
  • [path/to/code-file]
  • [path/to/config-or-history-evidence]

Extended Sections (Optional)

Add only when needed:

  • Full bug inventory
  • Component-level remediation roadmap
  • Cost/effort estimates by concern
  • Dependency-risk and ownership mapping