Skip to main content
aislop init scaffolds the project files that turn a one-off scan into a repeatable quality gate.

Usage

aislop init
aislop init ./packages/api
The command writes:
FilePurpose
.aislop/config.ymlEngine toggles, quality thresholds, scoring weights, CI threshold, telemetry, includes, and excludes
.aislop/rules.ymlOptional custom Architecture engine rules
.github/workflows/aislop.ymlOptional GitHub Actions workflow

Strict mode

Use --strict when you want a higher default bar immediately.
aislop init --strict
Strict mode writes an enterprise-grade baseline:
SettingStrict default
EnginesAll engines enabled
Type-aware lintingEnabled
CI thresholdfailBelow: 85
WorkflowIncluded automatically

Default workflow shape

The generated workflow uses the set-and-forget CLI path:
name: aislop

on:
  pull_request:
  push:
    branches: [main]

jobs:
  quality-gate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 24
      - run: npx --yes aislop@latest ci

After running init

  1. Review .aislop/config.yml.
  2. Commit the config and workflow files.
  3. Run aislop scan locally.
  4. Push a branch and let aislop ci enforce the threshold.
Use Config File to understand every generated key before tightening the gate.