impakt/docs/QA-TEMPLATE.md

Quality Assessment -- [DATE]

Score: [ ] / 100 — Grade: [ ] [ one-sentence summary of overall quality and key movement since last assessment ]

Dimension	Score
Test Health	/10
Type Safety	/10
Lint Hygiene	/10
Architecture	/10
Documentation	/10
Complexity	/10
Security	/10
Maintainability	/10

Version: [VERSION] Assessed by: [human / LLM model] Previous assessment: [filename or "None (baseline)"]

---

Inventory

Metric	Value
Source files
Source lines
Test files
Test lines
Test:source ratio
Direct dependencies

---

Raw Metrics

Test Suite

[paste pytest output]

• Tests collected:
• Tests passed:
• Tests failed:
• Test duration:

Type Safety (mypy --strict)

[paste mypy summary]

• Total errors:
• Files with errors: / total
• Top error categories:

Lint (ruff)

[paste ruff summary]

• Total violations:
• Auto-fixable:
• Top violation rules:

Complexity

• File size: min= / median= / mean= / max=
• Files >300 lines: / total
• High-complexity files (branch density >15):

[paste high-complexity file list]

Documentation

• Docstring coverage: / definitions ( %)
• Modules with __all__: / total
• README: lines
• Architectural diagrams: yes/no

Security

• eval/exec (sandboxed):
• eval/exec (unsandboxed):
• subprocess:
• Hardcoded secrets:
• Bare except:

Maintainability

• TODO:
• FIXME:
• HACK:
• Logging calls:
• try/except blocks:
• Internal imports (coupling):

---

Scorecard

#	Dimension	Weight	Score	Weighted	Justification
1	Test Health	20%	/10
2	Type Safety	15%	/10
3	Lint Hygiene	10%	/10
4	Architecture	15%	/10
5	Documentation	10%	/10
6	Complexity	10%	/10
7	Security	10%	/10
8	Maintainability	10%	/10

Composite Score: [ ] / 100

Grade: [ ]

---

Delta from Previous Assessment

Dimension	Previous	Current	Change
Test Health
Type Safety
Lint Hygiene
Architecture
Documentation
Complexity
Security
Maintainability
Composite

---

Top Improvements Since Last Assessment

---

Recommended Actions (Priority Order)

#	Action	Effort	Impact	Dimensions Affected
1
2
3
4
5

---

Notes

[Any judgment calls, caveats, or context for this assessment.]