architecture/old/skills/create-repo/SKILL.md

---
name: create-repo
description: >
  Create a new repository with standard structure. Scaffolds vision.md, CLAUDE.md,
  and CI configuration. Use when creating repos, initializing projects, or when user
  says /create-repo.
model: haiku
argument-hint: <repo-name>
context: fork
user-invocable: true
---

# Create Repository

@~/.claude/skills/repo-conventions/SKILL.md
@~/.claude/skills/vision-management/SKILL.md
@~/.claude/skills/claude-md-writing/SKILL.md
@~/.claude/skills/gitea/SKILL.md

Create a new repository with Flowmade's standard structure.

## Process

1. **Get repository name**: Use `$1` or ask the user
   - Validate: lowercase, hyphens only, no `flowmade-` prefix
   - Check it doesn't already exist: `tea repos flowmade-one/<name>`

2. **Determine visibility**:
   - Ask: "Should this repo be public (open source) or private (proprietary)?"
   - Refer to repo-conventions skill for guidance on open vs proprietary

3. **Gather vision context**:
   - Read the organization manifesto: `../architecture/manifesto.md`
   - Ask: "What does this product do? (one sentence)"
   - Ask: "Which manifesto personas does it serve?"
   - Ask: "What problem does it solve?"

4. **Create the repository on Gitea**:
   ```bash
   tea repos create --name <repo-name> --private/--public --description "<description>"
   ```

5. **Clone and set up structure**:
   ```bash
   # Clone the new repo
   git clone ssh://git@git.flowmade.one/flowmade-one/<repo-name>.git
   cd <repo-name>
   ```

6. **Create vision.md**:
   - Use the vision structure template from vision-management skill
   - Link to `../architecture/manifesto.md`
   - Fill in based on user's answers

7. **Create CLAUDE.md** (following claude-md-writing skill):
   ```markdown
   # <Repo Name>

   <One-line description from step 3>

   ## Organization Context

   This repo is part of Flowmade. See:
   - [Organization manifesto](../architecture/manifesto.md) - who we are, what we believe
   - [Repository map](../architecture/repos.md) - how this fits in the bigger picture
   - [Vision](./vision.md) - what this specific product does

   ## Setup

   ```bash
   # TODO: Add setup instructions
   ```

   ## Project Structure

   TODO: Document key directories once code exists.

   ## Development

   ```bash
   make build    # Build the project
   make test     # Run tests
   make lint     # Run linters
   ```

   ## Architecture

   TODO: Document key patterns and conventions once established.
   ```

8. **Create Makefile** (basic template):
   ```makefile
   .PHONY: build test lint

   build:
   	@echo "TODO: Add build command"

   test:
   	@echo "TODO: Add test command"

   lint:
   	@echo "TODO: Add lint command"
   ```

9. **Create CI workflow**:
   ```bash
   mkdir -p .gitea/workflows
   ```

   Create `.gitea/workflows/ci.yaml`:
   ```yaml
   name: CI
   on:
     push:
       branches: [main]
     pull_request:
       branches: [main]

   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: Build
           run: make build
         - name: Test
           run: make test
         - name: Lint
           run: make lint
   ```

10. **Create .gitignore** (basic, expand based on language):
    ```
    # IDE
    .idea/
    .vscode/
    *.swp

    # OS
    .DS_Store
    Thumbs.db

    # Build artifacts
    /dist/
    /build/
    /bin/

    # Dependencies (language-specific, add as needed)
    /node_modules/
    /vendor/
    ```

11. **Initial commit and push**:
    ```bash
    git add .
    git commit -m "Initial repository structure

    - vision.md linking to organization manifesto
    - CLAUDE.md with project instructions
    - CI workflow template
    - Basic Makefile

    Generated with [Claude Code](https://claude.com/claude-code)

    Co-Authored-By: Claude <noreply@anthropic.com>"

    git push -u origin main
    ```

12. **Report success**:
    ```
    Repository created: https://git.flowmade.one/flowmade-one/<repo-name>

    Next steps:
    1. cd ../<repo-name>
    2. Update CLAUDE.md with actual setup instructions
    3. Update Makefile with real build commands
    4. Start building!
    ```

## Output Example

```
## Creating Repository: my-service

Visibility: Private (proprietary)
Description: Internal service for processing events

### Files Created

- vision.md (linked to manifesto)
- CLAUDE.md (project instructions)
- Makefile (build template)
- .gitea/workflows/ci.yaml (CI pipeline)
- .gitignore (standard ignores)

### Repository URL

https://git.flowmade.one/flowmade-one/my-service

### Next Steps

1. cd ../my-service
2. Update CLAUDE.md with setup instructions
3. Update Makefile with build commands
4. Start coding!
```

## Guidelines

- Always link vision.md to the sibling architecture repo
- Keep initial structure minimal - add complexity as needed
- CI should pass on empty repo (use placeholder commands)
- Default to private unless explicitly open-sourcing