Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@rossnelson
Copy link
Collaborator

Overview

Improves the CLAUDE.md guide to be more effective for LLM contributors and adds serena memory files for better project context.

Changes

CLAUDE.md Improvements

  • Added critical lint/check section at the top that can't be missed
  • Highlighted key patterns and must-follow rules with emojis and bold text
  • Added common mistakes section to prevent frequent issues
  • Made guide more scannable and actionable vs explanatory
  • Added PR checklist for quick reference
  • Added direct links to relevant parts of the codebase
  • Removed verbose explanations for clarity

Serena Memory Files

Added comprehensive memory files to help serena understand the project:

  • project_overview.md - Purpose, tech stack, and features
  • suggested_commands.md - Essential development commands
  • code_style_conventions.md - Detailed coding standards
  • task_completion_checklist.md - Post-change requirements
  • project_structure.md - Directory organization
  • holocene_design_system.md - Component library info

Purpose

These improvements help AI assistants contribute more effectively by:

  • Making critical requirements impossible to miss
  • Providing quick access to patterns and commands
  • Preventing common mistakes upfront
  • Giving comprehensive project context through memory files

Testing

  • Reviewed CLAUDE.md for clarity and completeness
  • Verified all commands and patterns are accurate
  • Checked links point to correct locations
  • Validated serena memory files contain accurate information

- Add critical lint/check section at top
- Highlight key patterns and must-follow rules
- Add common mistakes section
- Make guide more scannable and actionable
- Add PR checklist and references to codebase
- Remove verbose explanations for clarity
@rossnelson rossnelson requested a review from a team as a code owner September 24, 2025 20:01
@rossnelson rossnelson requested review from GiantRobots and removed request for a team September 24, 2025 20:01
@vercel
Copy link

vercel bot commented Sep 24, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
holocene Ready Ready Preview Comment Sep 24, 2025 8:01pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants