Imported from kcbailey111/Capital-Allocation-via-AI- (.claude/skills/code-review/SKILL.md). Install upstream with npx skills add kcbailey111/Capital-Allocation-via-AI- --skill code-review. Copyright stays with the author.

AI System Code Review (Rubric-Based)

Use this skill to review the project against the AI System rubric and provide actionable feedback before each checkpoint.

Required Inputs

• Repository context (current module spec, recent changes, test results).
• Elegance Rubric: https://csc-343.path.app/rubrics/code-elegance.rubric.md
• AI System Rubric: https://csc-343.path.app/projects/project-2-ai-system/ai-system.rubric.md

Review Process

1. Identify the module(s) included in the current checkpoint.
2. Read the module spec and README updates.
3. Inspect implementation, tests, and documentation.
4. Score each rubric criterion with short justification.
5. List concrete fixes or improvements needed before submission.

Output Format

Summary

One short paragraph describing overall readiness.

Rubric Scores

Provide a score and justification for each criterion in the rubric.

Findings

List issues by severity (critical, major, minor). Each finding must include:

• Evidence (file paths, function names, or README sections)
• Impact on rubric scoring
• Suggested fix

Action Items

Checklist of next steps to address issues.

Questions

Any missing information needed to finalize the review.

Style Guidelines

• Cite evidence from the repository.
• Be concise and direct.
• Prefer clear, actionable feedback over general advice.