@codemcp/ade 0.2.0

package/.github/agents/ade.agent.md

@@ -0,0 +1,28 @@
+---
+name: ade
+description: ADE — Agentic Development Environment agent with project conventions and tools
+tools:
+  - read
+  - edit
+  - search
+  - agent
+  - workflows/*
+  - agentskills/*
+mcp-servers:
+  workflows:
+    type: stdio
+    command: "npx"
+    args: ["@codemcp/workflows-server@latest"]
+    tools: ["*"]
+  agentskills:
+    type: stdio
+    command: "npx"
+    args: ["-y", "@codemcp/skills-server"]
+    tools: ["*"]
+---
+
+You are an AI assistant that helps users develop software features using the workflows server.
+IMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.
+Each tool call returns a JSON response with an "instructions" field. Follow these instructions immediately after you receive them.
+Use the development plan which you will retrieve via whats_next() to record important insights and decisions as per the structure of the plan.
+Do not use your own task management tools.

package/.github/copilot-instructions.md

@@ -0,0 +1,11 @@
+You are an AI assistant that helps users develop software features using the workflows server.
+IMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.
+Each tool call returns a JSON response with an "instructions" field. Follow these instructions immediately after you receive them.
+Use the development plan which you will retrieve via whats_next() to record important insights and decisions as per the structure of the plan.
+Do not use your own task management tools.
+
+This project follows TanStack conventions. Use use_skill() to access the tanstack-architecture, tanstack-design, tanstack-code, tanstack-testing, and playwright-cli skills before making changes.
+
+Use the conventional-commits skill (via use_skill()) when writing commit messages.
+
+This project uses Architecture Decision Records. Use the adr-nygard skill (via use_skill()) when making or documenting architectural decisions. Store ADRs in docs/adr/.

package/.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

package/.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 }}

package/.husky/post-checkout

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

package/.husky/post-merge

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

package/.husky/pre-commit

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

package/.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

package/.kiro/agents/ade.json

@@ -0,0 +1,20 @@
+{
+  "name": "ade",
+  "description": "ADE — Agentic Development Environment agent with project conventions and tools.",
+  "prompt": "You are an AI assistant that helps users develop software features using the workflows server.\nIMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.\nEach tool call returns a JSON response with an \"instructions\" field. Follow these instructions immediately after you receive them.\nUse the development plan which you will retrieve via whats_next() to record important insights and decisions as per the structure of the plan.\nDo not use your own task management tools.",
+  "mcpServers": {
+    "workflows": {
+      "command": "npx",
+      "args": ["@codemcp/workflows-server@latest"],
+      "autoApprove": ["*"]
+    },
+    "agentskills": {
+      "command": "npx",
+      "args": ["-y", "@codemcp/skills-server"],
+      "autoApprove": ["*"]
+    }
+  },
+  "tools": ["read", "write", "spec", "@workflows/*", "@agentskills/*"],
+  "allowedTools": ["read", "write", "spec", "@workflows/*", "@agentskills/*"],
+  "useLegacyMcpJson": true
+}

package/.kiro/settings/mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "workflows": {
+      "command": "npx",
+      "args": ["@codemcp/workflows-server@latest"],
+      "autoApprove": ["*"]
+    },
+    "agentskills": {
+      "command": "npx",
+      "args": ["-y", "@codemcp/skills-server"],
+      "autoApprove": ["*"]
+    }
+  }
+}

package/.knowledge/.prettierignore

@@ -0,0 +1 @@
+docsets

package/.knowledge/config.yaml

@@ -0,0 +1,9 @@
+version: "1.0"
+docsets:
+  - id: conventional-commits-spec
+    name: The Conventional Commits specification
+    description: "Git repository: https://github.com/conventional-commits/conventionalcommits.org.git"
+    sources:
+      - url: https://github.com/conventional-commits/conventionalcommits.org.git
+        type: git_repo
+        branch: main

package/.lintstagedrc.js

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

package/.mcp.json

@@ -0,0 +1,20 @@
+{
+  "mcpServers": {
+    "workflows": {
+      "command": "npx",
+      "args": ["@codemcp/workflows-server@latest"]
+    },
+    "@codemcp/knowledge-server": {
+      "command": "npx",
+      "args": ["-y", "@codemcp/knowledge-server"]
+    },
+    "agentskills": {
+      "command": "npx",
+      "args": ["-y", "@codemcp/skills-server"]
+    },
+    "knowledge": {
+      "command": "npx",
+      "args": ["-y", "@codemcp/knowledge-server"]
+    }
+  }
+}

package/.opencode/agents/ade.md

@@ -0,0 +1,118 @@
+---
+name: ade
+description: ADE — Agentic Development Environment agent with project conventions and tools
+permission:
+  read:
+    "*": "allow"
+    "*.env": "deny"
+    "*.env.*": "deny"
+    "*.env.example": "allow"
+  edit: "allow"
+  glob: "allow"
+  grep: "allow"
+  list: "allow"
+  lsp: "allow"
+  task: "allow"
+  todoread: "deny"
+  todowrite: "deny"
+  skill: "deny"
+  webfetch: "ask"
+  websearch: "ask"
+  codesearch: "ask"
+  bash:
+    "*": "deny"
+    "grep *": "allow"
+    "rg *": "allow"
+    "find *": "allow"
+    "fd *": "allow"
+    ls: "allow"
+    "ls *": "allow"
+    "cat *": "allow"
+    "head *": "allow"
+    "tail *": "allow"
+    "wc *": "allow"
+    "sort *": "allow"
+    "uniq *": "allow"
+    "diff *": "allow"
+    "echo *": "allow"
+    "printf *": "allow"
+    pwd: "allow"
+    "which *": "allow"
+    "type *": "allow"
+    whoami: "allow"
+    date: "allow"
+    "date *": "allow"
+    env: "allow"
+    "tree *": "allow"
+    "file *": "allow"
+    "stat *": "allow"
+    "readlink *": "allow"
+    "realpath *": "allow"
+    "dirname *": "allow"
+    "basename *": "allow"
+    "sed *": "allow"
+    "awk *": "allow"
+    "cut *": "allow"
+    "tr *": "allow"
+    "tee *": "allow"
+    "xargs *": "allow"
+    "jq *": "allow"
+    "yq *": "allow"
+    "mkdir *": "allow"
+    "touch *": "allow"
+    "cp *": "ask"
+    "mv *": "ask"
+    "ln *": "ask"
+    "npm *": "ask"
+    "node *": "ask"
+    "pip *": "ask"
+    "python *": "ask"
+    "python3 *": "ask"
+    "rm *": "deny"
+    "rmdir *": "deny"
+    "curl *": "deny"
+    "wget *": "deny"
+    "chmod *": "deny"
+    "chown *": "deny"
+    "sudo *": "deny"
+    "su *": "deny"
+    "sh *": "deny"
+    "bash *": "deny"
+    "zsh *": "deny"
+    "eval *": "deny"
+    "exec *": "deny"
+    "source *": "deny"
+    ". *": "deny"
+    "nohup *": "deny"
+    "dd *": "deny"
+    "mkfs *": "deny"
+    "mount *": "deny"
+    "umount *": "deny"
+    "kill *": "deny"
+    "killall *": "deny"
+    "pkill *": "deny"
+    "nc *": "deny"
+    "ncat *": "deny"
+    "ssh *": "deny"
+    "scp *": "deny"
+    "rsync *": "deny"
+    "docker *": "deny"
+    "kubectl *": "deny"
+    "systemctl *": "deny"
+    "service *": "deny"
+    "crontab *": "deny"
+    reboot: "deny"
+    "shutdown *": "deny"
+    "passwd *": "deny"
+    "useradd *": "deny"
+    "userdel *": "deny"
+    "iptables *": "deny"
+  external_directory: "deny"
+  doom_loop: "deny"
+---
+
+You are an AI assistant that helps users develop software features using the workflows server.
+IMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.
+Each tool call returns a JSON response with an "instructions" field. Follow these instructions immediately after you receive them.
+Use the development plan which you will retrieve via whats_next() to record important insights and decisions as per the structure of the plan.
+Do not use your own task management tools.

package/.prettierignore

@@ -0,0 +1,2 @@
+dist
+.knowledge/docsets

package/.prettierrc.yaml

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

package/.vibe/beads-state-ade-autonomy-facet-46zodk.json

@@ -0,0 +1,29 @@
+{
+  "conversationId": "ade-autonomy-facet-46zodk",
+  "projectPath": "/Users/oliverjaegle/projects/privat/codemcp/ade",
+  "epicId": "ade-2",
+  "phaseTasks": [
+    {
+      "phaseId": "explore",
+      "phaseName": "Explore",
+      "taskId": "ade-2.1"
+    },
+    {
+      "phaseId": "plan",
+      "phaseName": "Plan",
+      "taskId": "ade-2.2"
+    },
+    {
+      "phaseId": "code",
+      "phaseName": "Code",
+      "taskId": "ade-2.3"
+    },
+    {
+      "phaseId": "commit",
+      "phaseName": "Commit",
+      "taskId": "ade-2.4"
+    }
+  ],
+  "createdAt": "2026-03-18T07:42:25.681Z",
+  "updatedAt": "2026-03-18T07:42:25.681Z"
+}

package/.vibe/beads-state-ade-fix-no-arch-selected-hvfiio.json

@@ -0,0 +1,34 @@
+{
+  "conversationId": "ade-fix-no-arch-selected-hvfiio",
+  "projectPath": "/Users/oliverjaegle/projects/privat/codemcp/ade",
+  "epicId": "ade-1",
+  "phaseTasks": [
+    {
+      "phaseId": "reproduce",
+      "phaseName": "Reproduce",
+      "taskId": "ade-1.1"
+    },
+    {
+      "phaseId": "analyze",
+      "phaseName": "Analyze",
+      "taskId": "ade-1.2"
+    },
+    {
+      "phaseId": "fix",
+      "phaseName": "Fix",
+      "taskId": "ade-1.3"
+    },
+    {
+      "phaseId": "verify",
+      "phaseName": "Verify",
+      "taskId": "ade-1.4"
+    },
+    {
+      "phaseId": "finalize",
+      "phaseName": "Finalize",
+      "taskId": "ade-1.5"
+    }
+  ],
+  "createdAt": "2026-03-18T07:27:28.580Z",
+  "updatedAt": "2026-03-18T07:27:28.580Z"
+}