feat: initial cli

.claude/skills/extending-catalog/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: extending-catalog
+description: Extends the ADE catalog with new facets, options, or practices. Use when adding a new architecture (e.g. Next.js), a new practice (e.g. Trunk-Based Development), or a new facet to the catalog.
+---
+
+# Extending the ADE catalog
+
+Catalog: `packages/core/src/catalog/`. Facets: one file each under `facets/`. Types: `packages/core/src/types.ts`.
+
+## Adding an option
+
+Single-file change. Append an `Option` to the facet's `options` array. Read the existing facet file for the shape — follow the pattern already there.
+
+- Architecture options go in `facets/architecture.ts` (single-select)
+- Practice options go in `facets/practices.ts` (multi-select, stack-independent)
+- Each option's `recipe` uses existing writers: `skills`, `workflows`, `instruction`, `mcp-server`, `knowledge`, `installable`
+- Inline skill bodies should be concise — only add context Claude doesn't already have
+- For third-party skills use `ExternalSkill`: `{ name, source }` instead of `{ name, description, body }`
+- `docsets` are optional — only add repos with genuinely useful reference docs
+
+## Adding a facet
+
+1. Create `facets/<name>.ts` — export a `Facet` object. Read an existing facet for the shape
+2. Register it in `packages/core/src/catalog/index.ts` — add to the `facets` array
+3. The CLI auto-discovers facets from the array — no UI changes needed
+
+Key decisions: `required` (must every project choose?), `multiSelect` (composable or mutually exclusive?), `dependsOn` (resolved after which facets?).
+
+## Adding a provision writer
+
+Expensive — touches types, registry, resolver, and every harness writer. Avoid unless existing writers cannot express the output.
+
+1. Extend `ProvisionWriter` union in `types.ts`
+2. Implement `ProvisionWriterDef` with `write(config, context) → Partial<LogicalConfig>`
+3. Register in `WriterRegistry`
+4. If needed, extend `LogicalConfig` and update merge logic in `resolver.ts`
+5. Update every harness writer in `packages/harnesses/src/writers/`
+
+## Resolution flow
+
+`UserConfig.choices` → `resolve()` iterates facets → matches options → runs each provision's writer → merges into `LogicalConfig` → harness writers emit agent-specific files. See `packages/core/src/resolver.ts`.

.github/workflows/pr.yml

@@ -0,0 +1,38 @@
+name: PR
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: "22"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Check formatting
+        run: pnpm run format:check:all
+
+      - name: Run linting
+        run: pnpm run lint:all
+
+      - name: Build project
+        run: pnpm run build
+
+      - name: Run tests
+        run: pnpm test

.github/workflows/release.yml

@@ -0,0 +1,124 @@
+name: Release and Publish
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: "22"
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Check formatting
+        run: pnpm run format:check:all
+
+      - name: Run linting
+        run: pnpm run lint:all
+
+      - name: Build project
+        run: pnpm run build
+
+      - name: Run tests
+        run: pnpm test
+
+  release:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate GitHub App Token
+        id: generate_token
+        uses: tibdex/github-app-token@v1
+        with:
+          app_id: ${{ vars.VERSION_BUMPER_APPID }}
+          private_key: ${{ secrets.VERSION_BUMPER_SECRET }}
+
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          token: ${{ steps.generate_token.outputs.token }}
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: "22"
+          cache: "pnpm"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build project
+        run: pnpm run build
+
+      - name: Bump version and create tag
+        id: version
+        uses: mathieudutour/github-tag-action@v6.2
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          default_bump: patch
+          tag_prefix: v
+
+      - name: Update package.json version
+        if: steps.version.outputs.new_tag
+        run: |
+          NEW_VERSION=${{ steps.version.outputs.new_version }}
+
+          # Update root package.json
+          pnpm version $NEW_VERSION --no-git-tag-version
+
+          # Update all workspace package versions
+          pnpm -r exec pnpm version $NEW_VERSION --no-git-tag-version
+
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add package.json packages/*/package.json pnpm-lock.yaml
+          git commit -m "chore: bump version to $NEW_VERSION [skip ci]" || exit 0
+          git push
+        env:
+          GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
+
+      - name: Create GitHub Release
+        if: steps.version.outputs.new_tag
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ steps.version.outputs.new_tag }}
+          name: Release ${{ steps.version.outputs.new_tag }}
+          body: ${{ steps.version.outputs.changelog }}
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to npm
+        if: steps.version.outputs.new_tag
+        run: |
+          # Publish all packages in workspace
+          # pnpm -r publishes packages in topological order (dependencies first)
+          # Root package is private and will be skipped automatically
+          pnpm -r publish --no-git-checks
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,23 @@
+# Generated files
+node_modules
+dist
+.DS_Store
+.crowd
+
+# Typescript
+*.tsbuildinfo
+*.d.ts
+
+# Turborepo
+.turbo
+
+# Jest
+coverage
+.coverage
+
+# Env files
+.env*
+!.env.example
+
+# vitepress
+docs/.vitepress/cache

.husky/post-checkout

@@ -0,0 +1,2 @@
+# Automate and ensure dependencies are installed/synced with the branch's codebase
+pnpm install

.husky/post-merge

@@ -0,0 +1,2 @@
+# Automate and ensure dependencies are installed/synced with the branch's codebase
+pnpm install

.husky/pre-commit

@@ -0,0 +1,2 @@
+# Ensure files are linted before commit
+pnpm lint-staged

.husky/pre-push

@@ -0,0 +1,8 @@
+# Ensure Typescript files have no errors before pushing
+# Ensure there is no linting or formatting errors before pushing
+pnpm run lint:all
+pnpm run format:check:all
+pnpm run typecheck:all
+
+# Run unit tests
+pnpm test

.lintstagedrc.js

@@ -0,0 +1,4 @@
+export default {
+  "*": "prettier --write --ignore-unknown",
+  "*.js,*.ts": "eslint --fix"
+};

.prettierignore

@@ -0,0 +1 @@
+dist

.prettierrc.yaml

@@ -0,0 +1,3 @@
+tabWidth: 2
+trailingComma: "none"
+useTabs: false

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Luke Baker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.