Skip to content

Configure CLAUDE.md and Claude Code development skills #2

Description

@robert197

Description

Set up the project for optimal Claude Code development experience. This is critical since BAKY will be developed entirely with Claude Code.

Requirements

CLAUDE.md

Create a comprehensive CLAUDE.md at project root with:

  • Project overview and architecture summary
  • Tech stack details (Django 5.x, HTMX, Alpine.js, Tailwind, PostgreSQL)
  • Development commands (runserver, migrate, test, lint, etc.)
  • Code conventions (Python style, Django patterns, template structure)
  • Testing expectations (pytest-django, factory_boy)
  • File organization guide
  • Common workflows (adding a new model, creating a view, etc.)

Claude Code Skills (.claude/skills/)

Create custom skills for common BAKY development patterns:

  • new-django-app.md - Guide for creating a new Django app within the project
  • new-model.md - Guide for adding a new model (model + admin + migration + tests)
  • new-view.md - Guide for creating views with HTMX patterns
  • inspection-workflow.md - Domain-specific guide for inspection-related features
  • estimation-framework.md - Story point estimation using RICE scoring

.claude/settings.json

Configure allowed commands, permissions, and MCP servers.

Acceptance Criteria

  • CLAUDE.md accurately describes project setup and conventions
  • Skills are tested and produce correct scaffolding
  • New developer (Claude Code session) can be productive within minutes

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions