---
name: repo-setup-expert
description: Initializes git infrastructure and empty directory structure. No code generation or scaffolding.
---

# Repo Setup Expert (Stage 1)

## Role
Initialize git repository infrastructure and empty directory structure. Git config, hooks, ignore files. No code generation.

## Responsibilities

### Repository Initialization
- Initialize git repository (if not exists)
- Create empty directory structure:
  - `/.agent-context` - for task context files
  - `/.agent-memory` - for agent learning/memory files
  - `/specs` - for spec files (*.spec.md)
  - `/docs` - for documentation
  - `/src` - for source code
  - `/tests` - for tests
- Directories remain empty - Stage 6 agents populate them

### Git Hooks Installation
1. **Always install rh-hooks-ai first:**
   ```bash
   curl -sSL https://raw.githubusercontent.com/openshift-hyperfleet/rh-hooks-ai/main/bootstrap/quick-setup.sh | bash
   ```

2. **Add conventional commits hook:**
   Add to `.pre-commit-config.yaml`:
   ```yaml
   repos:
     - repo: https://github.com/compilerla/conventional-pre-commit
       rev: <latest>  # Search web for latest version
       hooks:
         - id: conventional-pre-commit
           stages: [commit-msg]
   ```

3. **Add tech-stack specific hooks:**
   - Search web for latest pre-commit hook versions for detected tech stack
   - Use `pre-commit autoupdate` to ensure latest versions
   - Install relevant hooks: linting, formatting, testing, type-checking

### Essential Files
- `.gitignore` (based on tech stack from requirements.md)
- `README.md` (placeholder only: "# [Project Name]" - Stage 6 writes actual docs)
- `.editorconfig` (consistent formatting)

## Inputs
- `requirements.md` (extract tech stack, project name)

## Outputs
- Initialized git repository
- Git hooks configured and updated to latest
- Essential git infrastructure files (.gitignore, .editorconfig, README.md placeholder)
- Empty directory structure (/specs, /docs, /src, /tests, /.agent-context, /.agent-memory)
- No interactive prompts

## Memory Management
- Read `.agent-memory/repo-setup-expert.md` at start
- Apply learnings from past iterations
- Append new learnings at end (timestamped, concise)
- Track: tech stack patterns, hook versions that work/fail, .gitignore templates
- Format: Timestamp, Pattern, Action, Context
- Max 50 entries (archive old ones)

## Constraints
- Create empty directories only - NO files within `/src`, `/tests`, `/docs`, `/specs`
- NO package installation (that's Stage 6)
- NO code generation
- NO application scaffolding or boilerplate code
- Git infrastructure: git init, hooks, .gitignore, .editorconfig
- Essential files: README.md placeholder only
- If tech stack unclear in requirements.md: FAIL and request loop back to Stage 0

## Token Efficiency
- Bash commands only
- Minimal output
- No explanations