@orgloop/module-engineering 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrgLoop contributors
+
+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.

package/orgloop-module.yaml

@@ -0,0 +1,88 @@
+apiVersion: orgloop/v1alpha1
+kind: Module
+metadata:
+  name: engineering
+  description: "Engineering organization workflow — PR review, CI failure triage, Linear tickets, Claude Code supervision"
+  version: 1.0.0
+
+requires:
+  connectors:
+    - type: source
+      id: github
+      connector: "@orgloop/connector-github"
+      required: true
+
+    - type: source
+      id: linear
+      connector: "@orgloop/connector-linear"
+      required: false
+      fallback: skip
+
+    - type: source
+      id: claude-code
+      connector: "@orgloop/connector-claude-code"
+      required: false
+      fallback: skip
+
+    - type: actor
+      id: agent
+      connector: "@orgloop/connector-openclaw"
+      required: true
+
+  services:
+    - name: openclaw
+      detect:
+        http: "http://127.0.0.1:18789/health"
+      install:
+        brew: "openclaw"
+        docs: "https://docs.openclaw.dev/install"
+      provides_credentials:
+        - OPENCLAW_WEBHOOK_TOKEN
+
+  credentials:
+    - name: GITHUB_TOKEN
+      description: "GitHub personal access token (repo scope)"
+      required: true
+      create_url: "https://github.com/settings/tokens/new?scopes=repo,read:org"
+
+    - name: LINEAR_API_KEY
+      description: "Linear API key"
+      required: false
+
+    - name: OPENCLAW_WEBHOOK_TOKEN
+      description: "OpenClaw webhook authentication token"
+      required: true
+
+    - name: GITHUB_WATCHED
+      description: "Comma-separated GitHub usernames to watch (your user + your bot)"
+      required: true
+
+parameters:
+  - name: github_source
+    description: "Name of your GitHub source connector"
+    type: string
+    required: true
+    default: github
+
+  - name: linear_source
+    description: "Name of your Linear source connector"
+    type: string
+    required: false
+    default: linear
+
+  - name: claude_code_source
+    description: "Name of your Claude Code source connector"
+    type: string
+    required: false
+    default: claude-code
+
+  - name: agent_actor
+    description: "Name of your agent actor"
+    type: string
+    required: true
+    default: openclaw-engineering-agent
+
+provides:
+  routes: 5
+  transforms: 3
+  sops: 3

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@orgloop/module-engineering",
+  "version": "0.1.0",
+  "description": "Engineering organization workflow module — PR review, CI failure, Linear triage, Claude Code supervision",
+  "type": "module",
+  "main": "orgloop-module.yaml",
+  "files": [
+    "orgloop-module.yaml",
+    "templates",
+    "sops"
+  ],
+  "keywords": [
+    "orgloop",
+    "orgloop-module",
+    "engineering",
+    "code-review",
+    "ci-failure"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/sops/ci-failure.md

@@ -0,0 +1,19 @@
+# CI Failure
+
+A CI workflow run has failed. Diagnose and fix it.
+
+## Instructions
+
+1. Read the workflow run details — which job failed, which step
+2. Pull the failing branch and reproduce locally if possible
+3. **Test failures** -> read the failing test, understand what it expects, fix the code or test
+4. **Build failures** -> check for type errors, missing dependencies, syntax issues
+5. **Lint failures** -> run the linter locally, fix issues
+6. Push the fix and verify CI passes
+
+## Guidelines
+
+- Fix the root cause, not the symptom
+- If the CI failure is in code you didn't write, investigate but flag it for review
+- Don't skip or disable tests to make CI pass
+- If the failure is flaky (intermittent), document it and re-run once before investigating

package/sops/linear-ticket.md

@@ -0,0 +1,18 @@
+# Linear Ticket Update
+
+A Linear ticket has changed state. Review and take appropriate action.
+
+## Instructions
+
+1. Read the ticket details — title, description, current state, assignee, comments
+2. **Ticket moved to "In Progress"** -> pick it up, start working
+3. **Ticket moved to "In Review"** -> check if there's a PR associated, review it
+4. **New comment on your ticket** -> read and respond or act on it
+5. **Ticket created and assigned to you** -> acknowledge, plan your approach, start working
+
+## Guidelines
+
+- Keep the ticket updated with your progress — add comments as you work
+- If you're blocked, move the ticket to "Blocked" and explain why in a comment
+- Link PRs to tickets so the workflow is traceable
+- If a ticket is unclear, ask for clarification in a comment before starting work

package/sops/pr-review.md

@@ -0,0 +1,19 @@
+# PR Review Received
+
+A reviewer submitted feedback on a pull request.
+
+## Instructions
+
+1. Read every review comment carefully — understand the full context before responding
+2. **Code change requests** -> make the fix, push the commit
+3. **Questions** -> respond with a clear explanation in the PR thread
+4. **Disagreements** -> explain your reasoning. If the reviewer has a point, make the change
+5. After addressing all comments, re-request review from the same reviewer
+6. If CI fails after your changes, fix it before re-requesting review
+
+## Guidelines
+
+- Don't batch responses — address each comment individually
+- If a comment requires a code change, make it. Don't just acknowledge it
+- Keep PR responses concise and technical
+- If a review comment reveals a deeper architectural issue, flag it but fix what was asked

package/templates/routes.yaml

@@ -0,0 +1,90 @@
+apiVersion: orgloop/v1alpha1
+kind: RouteGroup
+
+routes:
+  - name: "{{ module.name }}-pr-review"
+    description: "PR review submitted — address feedback"
+    when:
+      source: "{{ params.github_source }}"
+      events:
+        - resource.changed
+      filter:
+        provenance.platform_event: pull_request.review_submitted
+    transforms:
+      - ref: my-notifications
+      - ref: dedup
+    then:
+      actor: "{{ params.agent_actor }}"
+      config:
+        session_key: "orgloop:{{ params.github_source }}:pr-review"
+        wake_mode: now
+        deliver: true
+    with:
+      prompt_file: "{{ module.path }}/sops/pr-review.md"
+
+  - name: "{{ module.name }}-pr-comment"
+    description: "PR review comment — respond to inline feedback"
+    when:
+      source: "{{ params.github_source }}"
+      events:
+        - resource.changed
+      filter:
+        provenance.platform_event: pull_request_review_comment
+    transforms:
+      - ref: my-notifications
+      - ref: dedup
+    then:
+      actor: "{{ params.agent_actor }}"
+      config:
+        session_key: "orgloop:{{ params.github_source }}:pr-comment"
+        wake_mode: now
+        deliver: true
+    with:
+      prompt_file: "{{ module.path }}/sops/pr-review.md"
+
+  - name: "{{ module.name }}-ci-failure"
+    description: "CI failure — diagnose and fix"
+    when:
+      source: "{{ params.github_source }}"
+      events:
+        - resource.changed
+      filter:
+        provenance.platform_event: workflow_run.completed
+    transforms:
+      - ref: my-notifications
+    then:
+      actor: "{{ params.agent_actor }}"
+      config:
+        session_key: "orgloop:{{ params.github_source }}:ci-failure"
+        wake_mode: now
+    with:
+      prompt_file: "{{ module.path }}/sops/ci-failure.md"
+
+  - name: "{{ module.name }}-linear-triage"
+    description: "Linear issue updates — triage and act"
+    when:
+      source: "{{ params.linear_source }}"
+      events:
+        - resource.changed
+    transforms:
+      - ref: dedup
+    then:
+      actor: "{{ params.agent_actor }}"
+      config:
+        session_key: "orgloop:{{ params.linear_source }}:activity"
+        wake_mode: now
+        deliver: true
+    with:
+      prompt_file: "{{ module.path }}/sops/linear-ticket.md"
+
+  - name: "{{ module.name }}-claude-code-supervisor"
+    description: "Claude Code session ended — review and decide next action"
+    when:
+      source: "{{ params.claude_code_source }}"
+      events:
+        - actor.stopped
+    then:
+      actor: "{{ params.agent_actor }}"
+      config:
+        session_key: "orgloop:{{ params.claude_code_source }}:supervisor"
+        wake_mode: now