Table of Contents

• Use When
• Workflow
• 1. Detect or Select Language
• 2. Collect Project Metadata
• 3. Review Existing Files
• 4. Render and Apply Templates
• 5. Initialize Git (if needed)
• 6. Verify Setup
• 7. Next Steps
• Error Handling
• Success Criteria
• Examples
• Example 1: New Python Project

Project Initialization Skill

Use When

• Starting a new Python, Rust, or TypeScript project
• Updating existing project tooling to current standards
• Need to set up git, GitHub workflows, pre-commit hooks, Makefile
• Want consistent project structure across team
• Converting unstructured project to best practices
• Adding missing configurations to established codebases

Workflow

1. Detect or Select Language

modules/language-detection.md

• Auto-detect from existing files (pyproject.toml, Cargo.toml, package.json)
• If ambiguous or empty directory, ask user to select
• Validate language is supported (python, rust, typescript)

2. Collect Project Metadata

modules/metadata-collection.md

• Project name (default: directory name)
• Author name and email
• Project description
• Language-specific settings:
  • Python: version (default 3.10)
  • Rust: edition (default 2021)
  • TypeScript: framework (React, Vue, etc.)
• License type (MIT, Apache, GPL, etc.)

3. Review Existing Files

ls -la

--help

• Show what would be overwritten
• Ask for confirmation or selective overwrite
• Offer merge mode (preserve custom content)

4. Render and Apply Templates

modules/template-rendering.md

python3 plugins/attune/scripts/attune_init.py \
  --lang {{LANGUAGE}} \
  --name {{PROJECT_NAME}} \
  --author {{AUTHOR}} \
  --email {{EMAIL}} \
  --python-version {{PYTHON_VERSION}} \
  --description {{DESCRIPTION}} \
  --path .

--help

5. Initialize Git (if needed)

# Check if git is initialized
if [ ! -d .git ]; then
  git init
  echo "Git repository initialized"
fi

git status

6. Verify Setup

# Check Makefile targets
make help

# List created files
git status

git status

7. Next Steps

# Install dependencies and hooks
make dev-setup

# Run tests to verify setup
make test

# See all available commands
make help

pytest -v

Error Handling

• Language detection fails: Ask user to specify

  --lang

• Script not found: Guide to plugin installation location
• Permission denied: Suggest

  chmod +x

  on scripts
• Git conflicts: Offer to stash or commit existing work

Success Criteria

• All template files created successfully
• No overwrites without user confirmation
• Git repository initialized

• make help

  shows available targets

• make test

  runs without errors (even if no tests yet)

Examples

Example 1: New Python Project

**Verification:** Run `pytest -v` to verify tests pass.
User: /attune:project-init
## Troubleshooting

### Common Issues

**Command not found**
Ensure all dependencies are installed and in PATH

**Permission errors**
Check file permissions and run with appropriate privileges

**Unexpected behavior**
Enable verbose logging with `--verbose` flag