Added AQA Process and Scoring

docs/QA-TEMPLATE.md

@@ -0,0 +1,147 @@
+# Quality Assessment -- [DATE]
+
+**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
+
+1.
+2.
+3.
+
+---
+
+## Recommended Actions (Priority Order)
+
+| # | Action | Effort | Impact | Dimensions Affected |
+|---|--------|--------|--------|---------------------|
+| 1 | | | | |
+| 2 | | | | |
+| 3 | | | | |
+| 4 | | | | |
+| 5 | | | | |
+
+---
+
+## Notes
+
+[Any judgment calls, caveats, or context for this assessment.]