Skip to content

Conversation

OpenStaxClaude
Copy link
Contributor

Summary

Adds a comprehensive CLAUDE.md guide for Claude agents working on the openstax-cms repository.

What's Included

  • Setup instructions: Complete walkthrough from clone to running server
  • Project structure: Overview of directories and key files
  • Migration workflow: Step-by-step guide for creating Django migrations
  • Development tasks: Common commands for testing, Docker, database management
  • Key models: Documentation of important models (especially Assignable)
  • Troubleshooting: Solutions for common setup issues

Why This Matters

Claude agents have ephemeral workspaces that reset between sessions. This documentation ensures:

  • Consistent setup procedures across sessions
  • Proper migration creation (avoiding manual migration files)
  • Understanding of project architecture
  • Quick reference for common tasks

Related

Jira: https://openstax.atlassian.net/browse/CORE-1277

🤖 Generated with Claude Code

OpenStaxClaude and others added 2 commits October 7, 2025 17:18
Provides comprehensive documentation for Claude agents working on this repo:
- Setup instructions with all prerequisites
- Project structure overview
- Django migration creation workflow
- Common development tasks
- Key model descriptions
- Troubleshooting tips

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Updated installation steps and migration best practices in CLAUDE.md. Removed redundant steps and clarified requirements.
@TomWoodward TomWoodward merged commit 032d90c into main Oct 7, 2025
6 checks passed
@TomWoodward TomWoodward deleted the CORE-1277-add-claude-md branch October 7, 2025 17:39
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