Project Init

Initialize or update projects with complete development infrastructure and standard tooling.

When To Use

Use this command when you need to:

• Start a new project from scratch
• Set up development infrastructure (git, Makefile, CI/CD)
• Bootstrap project with language-specific tooling
• Initialize empty repository with standards
• Create project structure and configurations

When NOT To Use

Avoid this command if:

• Project already initialized and configured
• Only need specific component updates (use /attune:upgrade-project)
• Need architecture selection first (use /attune:arch-init)
• Modifying established project structure

Usage

# Interactive mode (recommended)
/attune:project-init

# Specify language
/attune:project-init --lang python

# Full specification
/attune:project-init --lang python --name my-project --author "Your Name"

What This Command Does

1. Detects or accepts language specification (Python, Rust, TypeScript)
2. Initializes git repository (if not already initialized)
3. Creates or updates configuration files:

• .gitignore - Language-specific ignores
• Makefile - Development automation
• .pre-commit-config.yaml - Code quality hooks
• pyproject.toml / Cargo.toml / package.json - Dependency management

1. Sets up or updates GitHub workflows:

• Test workflow
• Lint workflow
• Type check workflow

1. Creates project structure (if not present):

• src/ directory with initial module
• tests/ directory
• README.md

Note: For existing projects, init will detect present configurations and offer to update them to current standards. Use --force to overwrite without prompting, or the interactive mode for selective updates.

Workflow

# 1. Invoke skill to guide initialization
Skill(attune:project-init)

# 2. Gather project metadata
#    - Project name (default: directory name)
#    - Language (detect or ask)
#    - Author name
#    - Python version (if Python)
#    - License type

# 3. Run initialization script
python3 plugins/attune/scripts/attune_init.py \
  --lang python \
  --name "my-awesome-project" \
  --author "Your Name" \
  --path .

# 4. Validate setup
…

Arguments

• --lang - Project language (python, rust, typescript)
• --name - Project name (default: directory name)
• --author - Author name
• --email - Author email
• --python-version - Python version (default: 3.10)
• --description - Project description
• --path - Project path (default: current directory)
• --force - Overwrite existing files without prompting
• --no-git - Skip git initialization

Interactive Mode

When no arguments provided, the skill guides you through:

1. Language detection: Auto-detect or let you choose
2. Project metadata: Name, author, description
3. Feature selection: Which components to initialize
4. Confirmation: Review before applying changes
5. Execution: Run initialization with your choices

Safety Features

• Non-destructive: Prompts before overwriting existing files
• Validation: Checks for conflicts before copying templates
• Dry-run option: Preview changes without applying (#97)
• Backup option: Create backups of overwritten files (#98)

Examples

Example 1: New Python CLI Project

/attune:project-init --lang python --name awesome-cli --description "An awesome CLI tool"

Creates:

awesome-cli/
├── .git/
├── .gitignore
├── .pre-commit-config.yaml
├── pyproject.toml
├── Makefile
├── README.md
├── src/
│   └── awesome_cli/
│       └── __init__.py
├── tests/
│   └── __init__.py
└── .github/
    └── workflows/
        ├── test.yml
        ├── lint.yml
        └── typecheck.yml

Example 2: Initialize in Existing Project

cd my-existing-project
/attune:project-init --lang python

Prompts:

File exists: pyproject.toml. Overwrite? [y/N]: n
⊘ Skipped: pyproject.toml
File exists: Makefile. Overwrite? [y/N]: y
✓ Created: Makefile
...

Example 3: Force Overwrite All Files

/attune:project-init --lang python --force

Overwrites all existing files without prompting.

Post-Initialization Steps

After initialization, run:

# Install dependencies and set up pre-commit hooks
make dev-setup

# Verify installation
make test

# See all available targets
make help

Troubleshooting

Git not initialized:

# Initialize manually
git init
/attune:project-init --lang python