# AGENTS.md (Root)

## Project Identity

- **Project Name**: {{project_name}}
- **Mission**: {{project_mission}}
- **Primary Domain**: {{primary_domain}}
- **Key Stakeholders**: {{stakeholders}}

## Tech Stack

- **Language**: {{primary_language}}
- **Framework**: {{primary_framework}}
- **Database**: {{database_type}}
- **Infra/Deployment**: {{deployment_environment}}
- **Services**: {{supporting_services}}

## Global Standards

### Engineering Principles

- Prefer clarity over cleverness
- Keep boundaries explicit (modules, layers, namespaces)
- Favor stability: avoid breaking changes without migration notes

### Documentation Rules

- Update core docs when architecture changes
- Keep terminology consistent across README, ARCHITECTURE, and AGENTS
- Document external dependencies and their purpose

### Security & Compliance

- Enforce input validation and output encoding
- Store secrets only in environment or secrets managers
- Avoid logging sensitive data

## Execution Guidance

- Confirm stack before major changes
- Use spec-driven development (see docs/plans/AGENTS.md)
- Keep all changes traceable to a spec or ticket