# azure-development

An APM (Agent Primitives Manager) application for Azure development best practices and deployment guidelines.

## Quick Start

```bash
# Install dependencies
apm install

# Compile APM context into AGENTS.md
apm compile

# Run Azure best practices review
apm run start --param project_path="./src"

# Run deployment assessment
apm run deploy --param service_type="function" --param environment="production"

# Run architecture review
apm run architecture --param architecture_file="architecture.md"

# Preview before execution
apm preview --param project_path="./src"
```

## APM context Compilation

This project demonstrates Azure-focused APM context system:

### Available Primitives
- **Chatmodes**: `default`, `azure-architect`, `devops-engineer`
- **Instructions**: Azure Functions, App Service, Container Apps guidelines
- **Context**: Azure services information, Security best practices

For Azure-specific development, this module provides comprehensive guidance for cloud-native application development.

### Compilation Commands
```bash
# Compile all primitives into AGENTS.md
apm compile

# Watch for changes and auto-recompile
apm compile --watch

# Validate primitives without compiling
apm compile --validate

# Dry run to preview output
apm compile --dry-run

# Use specific chatmode
apm compile --chatmode azure-architect
```

### Directory Structure
```
.apm/
├── chatmodes/
│   ├── default.chatmode.md
│   ├── azure-architect.chatmode.md
│   └── devops-engineer.chatmode.md
├── instructions/
│   ├── azure-functions.instructions.md
│   ├── app-service.instructions.md
│   ├── container-apps.instructions.md
│   └── azure-security.instructions.md
└── context/
    ├── azure-services.context.md
    └── deployment-patterns.context.md

```

## Available Workflows

### Azure Best Practices Review
- `azure-best-practices.prompt.md` - Comprehensive Azure development best practices review
- **Recommended chatmode**: `azure-architect` or `devops-engineer`
- Usage: `apm compile --chatmode azure-architect && apm run start`

### Azure Deployment Assessment  
- `azure-deployment.prompt.md` - Deployment assessment and CI/CD pipeline guidance
- **Recommended chatmode**: `devops-engineer` or combination with `azure-architect`
- Usage: `apm compile --chatmode devops-engineer && apm run deploy`

### Azure Architecture Review
- `azure-architecture-review.prompt.md` - Architecture review following Well-Architected Framework
- **Recommended chatmode**: `azure-architect` (primary focus)
- Usage: `apm compile --chatmode azure-architect && apm run architecture`

### Azure Security Audit
- `azure-security-audit.prompt.md` - Comprehensive security assessment for Azure resources
- **Recommended chatmode**: `azure-architect` with security context
- Usage: `apm compile --chatmode azure-architect && apm run security`

### Chatmode Combinations

For comprehensive analysis, you can combine chatmodes:
```bash
# Architecture + DevOps perspective
apm compile --chatmode azure-architect,devops-engineer

# Use specific context for focused analysis  
apm compile --chatmode azure-architect --context security-focused
apm compile --chatmode azure-architect --context enterprise-scale
```

## About

This project was created with APM - The package manager for AI-Native Development.

Learn more at: https://github.com/github/apm-cli