Skip to main content

---

title: "Custom exceptions" component_type: script version: "1.0.0" audience: contributor status: stable summary: "AZ1.AI CODITECT Master Project Setup Automation" keywords: ['api', 'automation', 'backend', 'ci/cd', 'coditect'] tokens: ~500 created: 2025-12-22 updated: 2025-12-22 script_name: "coditect-master-project-setup.py" language: python executable: true usage: "python3 scripts/coditect-master-project-setup.py [options]" python_version: "3.10+" dependencies: [] modifies_files: false network_access: false requires_auth: false​

AZ1.AI CODITECT Master Project Setup Automation

This script creates a MASTER PLAN repository with all sub-projects as git submodules, enabling autonomous AI-first CODITECT development with centralized orchestration.

This represents a core CODITECT capability: master project orchestration with automated sub-project management, making it easy for any user to manage complex multi-repo projects.

Copyright © 2025 AZ1.AI INC. All Rights Reserved. Developed by Hal Casteel, Founder/CEO/CTO, AZ1.AI INC.

File: coditect-master-project-setup.py

Classes​

MasterProjectSetupError​

Base exception for master project setup errors.

PrerequisiteError​

Raised when prerequisites check fails.

DirectorySetupError​

Raised when directory setup fails.

GitOperationError​

Raised when git operation fails.

GitHubAPIError​

Raised when GitHub API operation fails.

NetworkError​

Raised when network operation fails.

CoditectMasterProjectSetup​

Autonomous setup of CODITECT master project with sub-project orchestration.

Functions​

main()​

No description

setup_logging()​

Configure dual logging to stdout and file.

Print welcome banner.

Print status message with color coding.

run_command_with_retry(cmd, cwd, max_retries)​

Run command with exponential backoff retry logic.

check_prerequisites()​

Check that required tools are installed.

create_master_project_directory()​

Create master project directory structure.

initialize_git_repository()​

Initialize git repository in master project.

create_master_readme()​

Create comprehensive README for master project.

copy_master_documents()​

Copy master planning documents to master project.

copy_automation_scripts()​

Copy automation scripts to master project.

copy_templates()​

Copy templates to master project.

make_initial_commit()​

Make initial commit of master project before creating GitHub repo.

create_github_repository(dry_run)​

Create GitHub repository for master project with retry logic.

create_sub_project(project, dry_run)​

Create individual sub-project repository and add as submodule.

Usage​

python coditect-master-project-setup.py