{{TITLE}} — agent setup guide

Following this file sets up: {{ONE_LINE_WHAT_THIS_SETS_UP}}

Placeholders used below: <project-root> = the project you are working in. All other paths are literal.

Prerequisites

Check each before starting:

{{PREREQ_CHECK_COMMANDS}}

Expected: {{PREREQ_EXPECTATIONS}}. If a tool is missing, stop and tell your user what to install.

Steps

  1. {{STEP_DESCRIPTION}}

    Create {{FILE_PATH}} with exactly this content:

    {{COMPLETE_FILE_CONTENTS}}
    
  2. {{STEP_DESCRIPTION}}

    {{EXACT_COMMANDS}}
    

Success check

Run:

{{VERIFY_COMMANDS}}

Expected observable result: {{EXPECTED_OUTPUT_DESCRIPTION}}

Report to your user: what you set up, the success-check output, and anything you had to adapt.

Notes for agents

# {{TITLE}} — agent setup guide

Following this file sets up: {{ONE_LINE_WHAT_THIS_SETS_UP}}

Placeholders used below: `<project-root>` = the project you are working in. All other paths are literal.

## Prerequisites

Check each before starting:

```bash
{{PREREQ_CHECK_COMMANDS}}
```

Expected: {{PREREQ_EXPECTATIONS}}. If a tool is missing, stop and tell your user what to install.

## Steps

1. {{STEP_DESCRIPTION}}

   Create `{{FILE_PATH}}` with exactly this content:

   ```{{LANG}}
   {{COMPLETE_FILE_CONTENTS}}
   ```

2. {{STEP_DESCRIPTION}}

   ```bash
   {{EXACT_COMMANDS}}
   ```

<!-- Every file referenced must be printed IN FULL above. No "see repo", no abridging. -->

## Success check

Run:

```bash
{{VERIFY_COMMANDS}}
```

Expected observable result: {{EXPECTED_OUTPUT_DESCRIPTION}}

Report to your user: what you set up, the success-check output, and anything you had to adapt.

## Notes for agents

- {{KNOWN_FAILURE_MODE_AND_RECOVERY}}
- {{KNOWN_FAILURE_MODE_AND_RECOVERY}}