junie-training CLAUDE.md

Project Guidelines for Claude

Project Context

This is a comprehensive Junie training repository for teaching JetBrains' AI coding assistant across multiple IDEs. The training materials were developed with Claude's assistance and demonstrate best practices for AI-assisted development.

Slide Presentation Best Practices

When creating or editing slides (especially in Slidev format):

One Idea Per Slide

• Each slide should contain ONE major concept
• Avoid the "bullet-riddled corpse" anti-pattern
• Better to have many simple slides than few dense ones
• 60+ focused slides work better than 30 cramped ones

Content Guidelines

• Maximum 5-6 bullet points per slide
• Use progressive disclosure across multiple slides
• Keep code examples short and focused (5-10 lines max)
• Leave visual breathing room

Visual Design for Dark Mode

• Use high contrast colors for text on colored backgrounds
• Test all color combinations for readability
• Prefer lighter text shades (e.g., #dbeafe instead of white on blue)
• Add borders to colored boxes for definition
• Keep Mermaid diagrams simple to avoid parsing errors

Example Structure

---
## Single Concept Title

Key point or statement

Supporting detail if needed
---

Lab Instructions Format

When creating lab instructions:

Structure

1. Learning Objectives - Clear, measurable goals
2. Prerequisites - Tools and knowledge required
3. Parts - Logical progression from simple to complex
4. Tasks - Numbered, specific actions
5. Expected Outcomes - What success looks like
6. Common Issues - Troubleshooting section
7. Challenge Extensions - Optional advanced tasks
8. Reflection Questions - Reinforce learning

Writing Style

• Use clear, imperative language for tasks
• Provide example code and expected output
• Include timing estimates for each section
• Add hints for common stumbling blocks

Project-Specific Patterns

File Organization

/
├── slides.md           # Main presentation (source of truth)
├── slides.pdf         # Exported for distribution
├── labs/
│   ├── labA-java-rest/
│   │   ├── README.md
│   │   ├── .junie/AGENTS.md
│   │   └── [starter code]
│   └── [other labs...]
├── .junie/
│   └── skills/
├── resources/
│   ├── cheat-sheets/
│   ├── prompts/
│   └── quick-reference.md
└── demo-playwright/