AGENTS.md@docs/best-practices git:20260325.d6b2de5A

Immutable. This exact content is served forever at /api/v1/blob/27782add3b3ad678.

# Best Practices Documentation

## Overview

Technical guide for `docs/best-practices/` — code organization, version control, project management, and migration guides.

## Files

| File | Purpose |
|------|---------|
| `best-practices.md` | Consolidated best practices compilation |
| `version-control.md` | Git workflows and version control |
| `multi-project-management.md` | Managing multiple projects in the template |
| `migration-guide.md` | Migrating from other templates |
| `backup-recovery.md` | Backup strategies and recovery procedures |

## Key Conventions

- **Project paths**: exemplar [`projects/code_project/`](../../projects/code_project/); authoritative active list → [_generated/active_projects.md](../_generated/active_projects.md).
- `best-practices.md` consolidates patterns from all other documentation
- Code organization follows the two-layer architecture (infrastructure / projects)
- Version control practices follow conventional commits
- Migration guide provides step-by-step procedures for common template formats

## See Also

- [README.md](README.md) — Quick navigation
- [Architecture](../architecture/two-layer-architecture.md) — Design patterns
- [Contributing](../development/contributing.md) — Development process