context-files

Review recent sessions and suggest improvements to the project's Claude Code setup (CLAUDE.md, hooks, skills, MCP, settings)

Read-only agent that analyzes Claude Code session JSONL files to extract patterns across multiple sessions. <example> Context: The improve command needs to analyze recent sessions for a project user: "Analyze sessions in ~/.claude/projects/-home-max-projects-chat/" assistant: "I'll scan the session files for recurring patterns." <commentary> This agent reads raw JSONL session files and returns structured findings about repeated mistakes, workflow friction, and knowledge gaps. </commentary> </example>

Apply when the user is working on CLAUDE.md, AGENTS.md, context files, agent memory, or AI coding assistant instructions. Teaches the minimal-context approach backed by empirical research.

Review and optimize AI context files (CLAUDE.md, AGENTS.md) in the current project. Classifies each line as KEEP, REMOVE, or MOVE using the core test — would removing this cause the agent to make mistakes?

Review the current session for friction, repeated mistakes, and actionable improvements. Classifies findings as fix-in-codebase, add-tooling, add-to-context-file, or one-off. Run at the end of or during a session.

Review recent sessions for the current project to identify recurring patterns, systemic issues, and improvements across multiple sessions.