Skip to content

Directory Structure

Complete listing of files generated by devenv.

Overview

my-project/
├── .claude/                 # Claude AI configuration
├── .devcontainer/          # VS Code Dev Container
├── .serena/                # Serena MCP memories
├── docs/                   # MkDocs documentation
├── project-management/     # BEACON framework
├── src/my_project/         # Python package
├── tests/                  # Test suite
├── .gitignore
├── .mcp.json               # MCP server configuration
├── .pre-commit-config.yaml
├── CLAUDE.md               # Main Claude prompt
├── Dockerfile
├── README.md
├── docker-compose.yml
├── justfile
├── mkdocs.yml
└── pyproject.toml

Detailed Structure

.claude/ - AI Configuration

.claude/
├── agents/
│   ├── frontend-typescript-dev.md
│   ├── python-expert.md
│   └── synthetic-data-specialist.md
├── common/
│   ├── pragmatic-principles.md
│   ├── system-prompt-conversion.md
│   └── tool-usage-guide.md
├── reference/
│   └── python/
│       └── package-layout-and-architecture.md
├── settings.json
└── settings.local.json

.devcontainer/ - Dev Container

.devcontainer/
├── mcp/                    # MCP server configs
│   ├── context7/
│   ├── crawl4ai/
│   ├── memgraph-ai-toolkit/
│   └── searxng/
├── compose.yml             # Main dev container
├── compose-mcp.yml         # MCP services
├── devcontainer.json       # VS Code configuration
├── Dockerfile
├── playwright.sh           # Browser setup
└── startup.sh              # Container startup

docs/ - Documentation

docs/
├── api/
│   ├── cli.md
│   └── rest.md
├── architecture/
│   ├── adapters.md
│   ├── domain.md
│   ├── overview.md
│   └── services.md
├── development/
│   ├── beacon.md
│   ├── contributing.md
│   └── testing.md
├── getting-started/
│   ├── configuration.md
│   ├── installation.md
│   └── quickstart.md
├── includes/
│   └── abbreviations.md
├── reference/
│   ├── adapters.md
│   ├── api.md
│   ├── domain.md
│   ├── index.md
│   ├── infrastructure.md
│   └── services.md
├── changelog.md
└── index.md

project-management/ - BEACON Framework

project-management/
├── ADRs/
│   └── ADR-000-template.md
├── Background/
│   └── 00-problem-statement.md
├── Roadmap/
│   └── README.md
└── Work/
    └── README.md

src/my_project/ - Python Package

src/my_project/
├── adapters/
│   ├── __init__.py
│   └── repositories/
│       └── __init__.py
├── api/
│   ├── __init__.py
│   └── main.py
├── cli/
│   ├── __init__.py
│   └── main.py
├── domain/
│   ├── __init__.py
│   └── entities.py
├── infrastructure/
│   ├── __init__.py
│   └── config.py
├── services/
│   └── __init__.py
└── __init__.py

tests/ - Test Suite

tests/
├── integration/
│   ├── __init__.py
│   └── test_api.py
├── unit/
│   ├── domain/
│   │   ├── __init__.py
│   │   └── test_entities.py
│   └── services/
│       ├── __init__.py
│       └── test_example_service.py
├── __init__.py
└── conftest.py

Root Files

File Purpose
.gitignore Git ignore patterns
.mcp.json MCP server configuration
.pre-commit-config.yaml Pre-commit hooks
CLAUDE.md Main Claude AI prompt
Dockerfile Production container
README.md Project documentation
docker-compose.yml Service orchestration
justfile Development commands
mkdocs.yml Documentation config
pyproject.toml Package configuration

File Purposes

Configuration Files

  • pyproject.toml - Python package metadata, dependencies, tool configs
  • mkdocs.yml - Documentation site configuration
  • .mcp.json - MCP server definitions for Claude
  • .pre-commit-config.yaml - Code quality hooks

Docker Files

  • Dockerfile - Multi-stage production build
  • docker-compose.yml - Full stack services
  • .devcontainer/ - VS Code Dev Container setup

Documentation

  • README.md - Quick start and overview
  • CLAUDE.md - AI assistant instructions
  • docs/ - Full MkDocs documentation

Source Code

  • src/ - Application source using src-layout
  • tests/ - pytest test suite

Development

  • justfile - Task runner commands
  • project-management/ - BEACON artifacts