reflect

Analyze coding session histories to detect convention violations and propose configuration updates.

9|2|Updated Nov 29, 2024
One-click install
npx skills add https://github.com/bbvch-ai/aihub-core --skill reflect-bbvch-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/bbvch-ai/aihub-core/tree/main/.claude/skills/reflect
Command: npx skills add https://github.com/bbvch-ai/aihub-core --skill reflect-bbvch-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of repeating the same coding mistakes across sessions by identifying where the AI assistant violated project conventions, missed established patterns, or required user steering, eliminating wasted time on recurring issues.

Core Features & Use Cases

  • Convention Violation Detection: Scans session history for breaches of the 16 core coding conventions (type hints, Pydantic usage, fail-fast patterns, etc.) defined in the root CLAUDE.md.
  • Targeted Fix Proposal: Categorizes issues to direct improvements to the correct location: CLAUDE.md files, skills, agents, or hooks, prioritizing systemic fixes over one-off corrections.
  • Use Case: For example, if your team repeatedly corrects the AI for using Poetry instead of uv, or creating controller directories instead of routes in the API package, this Skill identifies the recurring issue and proposes a permanent fix to prevent future mistakes.

Quick Start

Use the reflect skill after a coding session to get a prioritized list of actionable improvements for your project's documentation and AI configuration.

Frequently Asked Questions about reflect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stop an AI assistant from repeatedly violating project coding conventions?

To stop an AI assistant from repeatedly violating project coding conventions, you can analyze session histories to detect breaches and generate permanent configuration proposals for your CLAUDE.md files, skills, or hooks to prevent future recurrences.

How do I analyze a coding session history to improve my workflow?

You can analyze a coding session history by scanning it for instances where the AI violated architectural patterns or required user steering, then categorizing those issues to propose targeted systemic fixes to your project's AI configuration.

What is the best way to update CLAUDE.md files after a coding session?

The best way to update CLAUDE.md files is to run a retrospective analysis on your session history to identify convention violations, which generates categorized, actionable proposals for updating your documentation to prevent recurring mistakes.

Can I detect Pydantic usage and type hint standard violations from past sessions?

Yes, you can detect Pydantic usage and type hint standard violations by scanning past session histories against your project's core coding conventions to identify where the AI assistant failed to follow established patterns.

Does this convention violation detection work with the Swiss AI-Hub core codebase?

Yes, this convention violation detection applies specifically to software development workflows using the Swiss AI-Hub core codebase, covering violations of type hint standards, Pydantic usage, scope boundaries, and tooling conventions.

When should I run a retrospective on my AI coding sessions?

You should run a retrospective on your AI coding sessions immediately after the session ends, allowing you to capture fresh context on convention violations and generate prioritized actionable improvements for your project's documentation and AI configuration.