This repository contains the central documentation, reusable workflows, and shared actions for all ROTA repositories.

All organizational documentation lives in docs/:

• Getting Started - Overview and quick links
• Architecture - System design and repo structure
• Guidelines - Coding standards, testing, CI/CD, git workflow

Located in .github/workflows/:

Runs linting, type-checking, tests, and build for any repo.

Usage:

jobs:
  ci:
    uses: ROTA-edu/.github/.github/workflows/reusable-ci.yml@main
    with:
      node-version: '18'
      coverage-threshold: 80

Publishes packages to GitHub Packages with AI-generated changelog.

Usage:

jobs:
  publish:
    uses: ROTA-edu/.github/.github/workflows/reusable-publish.yml@main
    secrets:
      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Located in actions/:

Dual-purpose agent for wiki maintenance and issue triage.

Wiki Mode (Weekly):

- uses: ROTA-edu/.github/actions/wiki-issue-agent@v1
  with:
    openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}
    mode: 'wiki'

Issue Mode (Auto on issue open):

- uses: ROTA-edu/.github/actions/wiki-issue-agent@v1
  with:
    openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}
    mode: 'issue'
    issue-number: ${{ github.event.issue.number }}

Daily security and bug scanning.

Daily Scan:

- uses: ROTA-edu/.github/actions/bug-finder-agent@v1
  with:
    openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}
    scan-mode: 'daily'

PR Scan:

- uses: ROTA-edu/.github/actions/bug-finder-agent@v1
  with:
    openrouter-api-key: ${{ secrets.OPENROUTER_API_KEY }}
    scan-mode: 'pr'
    pr-number: ${{ github.event.pull_request.number }}

Comprehensive PR code review.

Usage:

- uses: ROTA-edu/.github/actions/ai-code-review@v1
  with:
    anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
    focus-areas: security,performance,testing

Cost: ~$2-7/month per repo (using cheap models)

.github/
├── .github/
│   └── workflows/           # Reusable workflows
│       ├── reusable-ci.yml
│       └── reusable-publish.yml
├── actions/                 # Custom GitHub Actions
│   └── ai-code-review/
│       └── action.yml
├── docs/                    # Central documentation
│   ├── README.md
│   ├── architecture/
│   ├── guidelines/
│   ├── core/
│   └── api/
├── workflow-templates/      # Starter templates for new repos
└── README.md               # This file

1. Copy workflow template:

   cp .github/workflow-templates/package-ci.yml your-repo/.github/workflows/ci.yml

2. Update repo-specific details (if needed)

3. Enable branch protection:

   • Settings → Branches → Add rule
   • Branch name pattern: main
   • Require pull request before merging
   • Require status checks to pass

4. Add secrets (if using AI features):

   gh secret set ANTHROPIC_API_KEY -b"sk-ant-..." --repo ROTA-edu/your-repo

1. Create branch: git checkout -b docs/update-xyz
2. Edit relevant files in docs/
3. Create PR with clear description
4. Tag @tech-leads for review

1. Test changes in a separate test repo first
2. Create PR with explanation of changes
3. Update version tags after merge

• ROTA Organization
• GitHub Actions Documentation
• Reusable Workflows Guide

Questions? Create an issue or post in #engineering-help