warden-architecture

Project Directory Structure Template

Policy Area: ARCH — Architecture Version: 2.0 Last Reviewed: 2026-02-11 Owner: Human+AI References: workflow.md Enforcement: Active (CLAUDE.md rule) + Hard (hooks)

---

Purpose

This is a TEMPLATE for projects using Warden. Customize it for your project's specific directory structure and naming conventions.

This directive defines the only approved directories and file locations for your project. Any file or directory not listed here is unauthorized. The AI must consult this directive before creating any file and must update this directive (with human approval) before creating any new directory.

For the Warden Framework's own structure, see the "Framework Directory Structure" section in README.md.

---

Instructions

INS-DA1-001: Approved Directory Tree

IMPORTANT: This is an EXAMPLE structure. Replace it with your project's actual directories. The following shows common patterns for different project types — choose one or adapt as needed.

Option 1: Simple CLI/Library Project

/project-root/
├── src/                     # Source code
│   ├── core/               # Core functionality
│   ├── utils/              # Utilities (max 5 files)
│   └── cli/                # CLI interface (if applicable)
├── tests/                   # Tests mirror src/ structure
│   ├── test_core/
│   └── test_utils/
├── docs/                    # Documentation (non-governance)
└── .claude/                     # Governance files (see .claude/rules/policy.md)

Option 2: Web Application (Frontend + Backend)

/project-root/
├── backend/
│   ├── app/
│   │   ├── models/         # Data models
│   │   ├── routes/         # API endpoints
│   │   ├── services/       # Business logic
│   │   └── core/           # Config, middleware
│   ├── tests/              # Mirrors backend/app/ structure
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── components/     # UI components
│   │   ├── pages/          # Page components
│   │   ├── services/       # API client
│   │   └── utils/          # Utilities (max 5 files)
│   └── package.json
├── scripts/                 # Build/deploy scripts
├── docs/                    # Documentation
└── .claude/                     # Governance files (see .claude/rules/policy.md)