junie-training AGENTS.md

Project Guidelines for Coding Agents

AGENTS.md is the open, tool-agnostic guidance file read by Junie, Codex, and other coding agents. Keep it in sync with CLAUDE.md (which carries the same guidance for Claude Code). Edit both when project conventions change.

Project Context

This is a comprehensive Junie training repository for teaching JetBrains' AI coding agent across multiple IDEs, the Junie CLI, and CI/CD. The training materials were developed with AI 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
• ~30 focused slides work better than a dozen 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