workflow-enforcement

• [Quick Start](#quick-start)

- [Prerequisites](#prerequisites)

- [Basic Usage](#basic-usage)

- [Create Alias for Easy Access](#create-alias-for-easy-access)

• [Core Concepts](#core-concepts)

- [Workflow](#workflow)

- [Philosophy](#philosophy)

• [Configuration](#configuration)

- [Anthropic (Default)](#anthropic-default)

- [Azure OpenAI](#azure-openai)

- [GitHub Copilot CLI](#github-copilot-cli)

- [Custom Workflows](#custom-workflows)

• [Commands Reference](#commands-reference)
• [Agents Reference](#agents-reference)

- [Core Agents](#core-agents-6)

- [Specialized Agents](#specialized-agents-23)

• [Features](#features)

- [Workflow Orchestration by Default](#workflow-orchestration-by-default)

- [Goal-Seeking Agent Generator](#goal-seeking-agent-generator)

- [Profile Management](#profile-management)

- [GitHub Pages Documentation Generation](#github-pages-documentation-generation)

- [Additional Features](#additional-features)

- [Statusline](#statusline)

• [Documentation](#documentation)

- [Getting Started](#getting-started)

- [Features](#features-1)

- [Patterns](#patterns)

- [Configuration](#configuration-1)

- [Development](#development-1)

- [Methodology](#methodology)

- [Security](#security)

- [Core Principles](#core-principles)

• [Development](#development)

- [Contributing](#contributing)

- [Local Development](#local-development)

- [Testing](#testing)

• [License](#license)

Prerequisites

• MacOS, WSL, or Linux
• Python 3.2+, Node.js 18+, npm, git
• GitHub CLI (gh) for PR/issue management
• az cli for AzDO and Azure skills
• uv ([astral.sh/uv](https://docs.astral.sh/uv/))

For detailed installation instructions, see

[docs/PREREQUISITES.md](https://rysweet.github.io/amplihack/PREREQUISITES/).

You may find that its useful to use amplihack with

[azlin](https://github.com/rysweet/azlin) which makes it easy to start linux

based agentic coding vms in the azure cloud.

Basic Usage

```sh

# Launch Claude Code with amplihack

amplihack launch

# With Azure OpenAI (requires azure.env configuration)

amplihack launch --with-proxy-config ./azure.env

# Work directly in a GitHub repository

amplihack launch --checkout-repo owner/repo

```

New to amplihack? After launching, try the interactive tutorial:

```

Task(subagent_type='guide', prompt='I am new to amplihack. Teach me the basics.')

```

The guide agent will walk you through workflows, prompting strategies, and

hands-on exercises. Takes 60-90 minutes to complete.

Already familiar? Tell Claude Code to cd /path/to/my/project and provide

your prompt. All prompts are automatically wrapped with /amplihack:ultrathink

for workflow orchestration (use --no-ultrathink flag to opt-out for simple

tasks).

Create Alias for Easy Access

Instead of typing the full uvx command, create an alias:

```sh

# Add to your ~/.bashrc or ~/.zshrc

alias amplihack='uvx --from git+https://github.com/rysweet/amplihack amplihack'

# Reload your shell

source ~/.bashrc # or source ~/.zshrc

```

No