Files
dev_agent_team/skills/code-review/SKILL.md
T
Your Name 2dabf8ef03 Phase 1-3: Add memory, skills, and improvement systems
- memory/: cross-session project memory with decisions, lessons, failures,
  architecture, and sessions categories. Each has format templates and
  lifecycle documentation.
- skills/: 12 reusable specialized methodologies (tdd, systematic-debugging,
  architecture-design, code-review, security-review, repository-analysis,
  failure-analysis, refactoring, test-analysis, incident-investigation,
  browser-automation, research). Each has frontmatter and methodology sections.
- improvements/: proposal-based improvement system requiring human approval.
- scripts/memory-lifecycle.sh: deterministic memory operations (recall, store,
  list, search, sessions, cleanup).
- scripts/test-memory-system.sh: 12 structural tests for all new systems.
- orchestrator.md: added Memory Recall stage, Learning and Memory Storage
  stage, Improvement Proposals workflow, memory/skills rules, and 3 new
  actions (A23-A27) to the action catalog. Updated behavioral acceptance test
  and state separation model.
- All 12 subagents: added Memory & Skills Awareness sections with recall
  and store instructions.
- docs/AGENT_ARCHITECTURE.md: documented memory, skills, and improvements
  systems (sections 12-14). Updated action count (27), state model, and
  remaining weaknesses.
- README.md: documented new systems, updated repository layout, added
  test-memory-system.sh documentation.

All 39 tests pass (16 architecture + 12 memory + 11 bootstrap).
2026-09-08 04:31:40 -04:00

1.9 KiB

name, description, version, owner, prerequisites
name description version owner prerequisites
code-review Code review process — systematic review of changes for quality, correctness, and maintainability 1.0 Reviewer implementation completed, tests passing

Code Review

When to use this skill

  • Before accepting a completed implementation
  • When reviewing a pull request or change set
  • When verifying scope compliance

Core methodology

READ CHANGES → CHECK CORRECTNESS → CHECK SCOPE → CHECK TESTS → CHECK DESIGN → CHECK SAFETY → VERDICT

Review checklist

Correctness

  • Does the code do what it claims?
  • Does it handle edge cases?
  • Are error paths handled?
  • Are there off-by-one errors?

Scope compliance

  • Does the change match the approved scope?
  • Is there unauthorized scope expansion?
  • Are only the files that should change actually changed?

Tests

  • Do tests verify the behavior (not implementation)?
  • Are edge cases tested?
  • Is there regression test coverage?
  • Do tests pass?

Design

  • Is the code consistent with existing patterns?
  • Are interfaces clean and minimal?
  • Is there unnecessary complexity?
  • Would a future developer understand this?

Safety

  • Are there security implications?
  • Are there performance implications?
  • Are there race conditions?
  • Are secrets or credentials handled safely?

Documentation

  • Are public APIs documented?
  • Are non-obvious decisions explained?
  • Is the change self-documenting?

Common pitfalls

  • Rubber-stamping (approving without reading)
  • Nitpicking style when correctness matters
  • Not testing the change locally
  • Accepting "it works" without evidence
  • Missing scope creep

Exit criteria

  • All checklist items addressed (pass or explain why not)
  • Findings categorized: BLOCKING / REQUIRED / SUGGESTED / NOTE
  • Verdict: ACCEPT / ACCEPT_WITH_NOTES / CHANGES_REQUIRED / BLOCKED