claude-specific

Overview

This document provides Claude-specific instructions for working with this CDK constructs library monorepo.

Project Context

When working with Claude, be aware of:

1. Monorepo Structure: This is a workspace with multiple packages
2. Build Order: Packages must be built in dependency order
3. Workspace Dependencies: Use "*" for internal package references
4. No Circular Dependencies: Always check dependency structure

Key Guidelines

Code Generation

When generating code:

• Always follow import conventions (explicit named imports)
• Include JSDoc comments for all public APIs
• Use proper naming conventions
• Follow construct patterns from existing code
• Ensure environment-aware configurations

Refactoring

When refactoring:

1. Check dependency order in tsconfig.build.json
2. Verify no circular dependencies are created
3. Update all affected packages
4. Run npm run build:workspaces to verify
5. Run npm run lint to check for issues

Adding Features

When adding new features:

1. Determine if it belongs in root or a subpackage
2. Follow the subpackage structure if creating new package
3. Add proper tests and documentation
4. Update relevant documentation files
5. Ensure proper exports from index.ts

Available Skills

Claude Code has access to specialized skills for this project:

• repository-structure - Project structure and architecture
• import-conventions - Import rules and ordering
• naming-conventions - Naming standards
• construct-development - Construct patterns and best practices
• package-management - Package configuration and dependencies
• build-and-deployment - Build process and commands
• testing - Testing requirements and examples
• common-tasks - Step-by-step guides for common tasks
• formatting-standards - Code formatting rules

Important Reminders

1. New constructs go in subpackages, not the root package
2. Always use explicit imports, never wildcards
3. Match CDK versions across all packages
4. Include environment in resource names to prevent collisions
5. Gate expensive features to production environments
6. Export everything from src/index.ts
7. Create test files for all constructs
8. Add JSDoc comments to all public APIs
9. Run lint and format before committing
10. Follow dependency order when adding packages