# ARCHITECTURE.md

## Tech Stack
- **Framework**: [Primary framework/language]
- **Database**: [Database system]
- **Frontend**: [Frontend technology]
- **Backend**: [Backend technology]
- **Infrastructure**: [Hosting/deployment]
- **Build Tools**: [Build system]

## Directory Structure
```
project/
├── src/              # Source code
├── tests/            # Test files
├── docs/             # Documentation
├── config/           # Configuration files
└── scripts/          # Build/deployment scripts
```

## Key Architectural Decisions

### [Decision 1]
**Context**: [Why this decision was needed]
**Decision**: [What was decided]
**Rationale**: [Why this approach was chosen]
**Consequences**: [Trade-offs and implications]

## Component Architecture

### [ComponentName] Structure <!-- #component-anchor -->
```typescript
// Major classes with exact line numbers
class MainClass { /* lines 100-500 */ }    // <!-- #main-class -->
class Helper { /* lines 501-600 */ }       // <!-- #helper-class -->
```

## System Flow Diagram
```
[User] -> [Frontend] -> [API] -> [Database]
           |            |
           v            v
       [Cache]     [External Service]
```

## Common Patterns

### [Pattern Name]
**When to use**: [Circumstances]
**Implementation**: [How to implement]
**Example**: [Code example with line numbers]

## Keywords <!-- #keywords -->
- architecture
- system design
- tech stack
- components
- patterns