Skip to main content

Getting Started

Onboarding a new repository​

Run this from any Slack channel the Alakai bot is in:

/init repo=your-org/your-repo

/init will:

  1. Enable GitHub automations for the repository
  2. Open a PR that adds docs/alakai.md if the file does not exist yet
  3. Return a GitHub App installation link

After running /init:

  1. Install the Alakai GitHub App using the returned link
  2. Review and merge the docs/alakai.md PR
  3. Edit the file to accurately describe our repository (architecture, conventions, constraints)
  4. Start using Slack commands — see Slack Commands

Our first prompt​

Once a repository is set up, generate a prompt with:

/prompt repo=your-org/your-repo Describe what you want to build

To generate a prompt and open a PR in one step:

/prompt-pr repo=your-org/your-repo targetBranch=feature/my-feature Describe what you want to build

See Slack Commands for the full command reference.

GitHub automations​

Once the GitHub App is installed, Alakai reacts automatically to:

  • New GitHub issues → generates a prompt PR (docs(prompts): issue-<number>)
  • Merged docs(prompts): PRs → triggers the implementation agent

See GitHub Automations for details.