Feat/onboarding_agent using bazel

AGENTS.md

@@ -0,0 +1,31 @@
+<!--
+*******************************************************************************
+Copyright (c) 2026 Contributors to the Eclipse Foundation
+
+See the NOTICE file(s) distributed with this work for additional
+information regarding copyright ownership.
+
+This program and the accompanying materials are made available under the
+terms of the Apache License Version 2.0 which is available at
+https://www.apache.org/licenses/LICENSE-2.0
+
+SPDX-License-Identifier: Apache-2.0
+*******************************************************************************
+-->
+
+# Eclipse S-CORE
+
+Start onboarding: `/sdlc` (or `bazel run @score_onboarding//tools/onboarding:sdlc`)
+
+The onboarding agent (`tools/onboarding/`):
+- identifies repository context (ASIL, languages, toolchains, build/docs system)
+- classifies your contribution (bug fix, improvement, PoC, documentation, feature, question)
+- recommends a workflow (SDLC Harness, SpecKit, BMAD, Technical Analysis, Issue Planning, Traditional)
+- writes a single context contract to `.onboarding/context.json`
+- recommends a handoff to the next agent — it never starts one automatically
+
+See [`tools/onboarding/tools/onboarding/agent/onboarding.skill.md`](tools/onboarding/tools/onboarding/agent/onboarding.skill.md)
+for the full skill definition.
+
+See [`CONTRIBUTION.md`](CONTRIBUTION.md) for contribution rules, PR/issue
+templates, and the ECA/DCO signing requirement.

MODULE.bazel

@@ -14,6 +14,14 @@ module(name = "score_module_template")
 
 bazel_dep(name = "rules_python", version = "1.8.5", dev_dependency = True)
 
+# Onboarding agent, nested here as its own module so other repos can depend on
+# it directly via `bazel_dep(name = "score_onboarding", ...)`.
+bazel_dep(name = "score_onboarding", version = "0.1.0", dev_dependency = True)
+local_path_override(
+    module_name = "score_onboarding",
+    path = "tools/onboarding",
+)
+
 # Python 3.12: Required for testing infrastructure and code generation tools
 PYTHON_VERSION = "3.12"
 

README.md

@@ -100,6 +100,22 @@ bazel test //tests/...
 
 ---
 
+## Onboarding
+
+The repository includes the `score_onboarding` Bazel module to guide
+contributors into the appropriate Eclipse S-CORE SDLC workflow. From the
+repository root, start the interactive flow with:
+
+```sh
+bazel run @score_onboarding//tools/onboarding:sdlc
+```
+
+The tool reads repository metadata, collects the contributor role and change
+type, recommends a workflow, and writes the confirmed context to
+`.onboarding/context.json`. It does not start downstream agents automatically.
+
+---
+
 ## 🛠 Tools & Linters
 
 The template integrates **tools and linters** from **centralized repositories** to ensure consistency across projects.

REUSE.toml

@@ -37,3 +37,11 @@ SPDX-License-Identifier = "Apache-2.0"
 path = [".bazelversion"]
 SPDX-FileCopyrightText = "Copyright (c) 2026 Contributors to the Eclipse Foundation"
 SPDX-License-Identifier = "Apache-2.0"
+
+[[annotations]]
+path = [
+	"tools/onboarding/tools/onboarding/examples/context_example.json",
+	"tools/onboarding/tools/onboarding/schemas/context.schema.json",
+]
+SPDX-FileCopyrightText = "Copyright (c) 2026 Contributors to the Eclipse Foundation"
+SPDX-License-Identifier = "Apache-2.0"

tools/onboarding/MODULE.bazel

@@ -0,0 +1,25 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+# Nested Bazel module so other repos can depend on the onboarding agent
+# directly, e.g.:
+#   bazel_dep(name = "score_onboarding", version = "0.1.0")
+#   bazel run @score_onboarding//tools/onboarding:sdlc
+module(
+    name = "score_onboarding",
+    version = "0.1.0",
+)
+
+# Needed to resolve py_library/py_binary/py_test macros; toolchain
+# registration is the consuming (root) module's responsibility.
+bazel_dep(name = "rules_python", version = "1.8.5")

tools/onboarding/tools/onboarding/BUILD

@@ -0,0 +1,57 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+load("@rules_python//python:defs.bzl", "py_binary", "py_library", "py_test")
+
+package(default_visibility = ["//visibility:public"])
+
+py_library(
+    name = "onboarding_lib",
+    srcs = [
+        "__init__.py",
+        "cli.py",
+        "discovery.py",
+        "models.py",
+        "output.py",
+        "recommendation.py",
+        "state_machine.py",
+        "validators.py",
+    ],
+    data = [
+        "agent/onboarding.agent.yaml",
+        "agent/onboarding.skill.md",
+        "schemas/context.schema.json",
+    ],
+    imports = ["../.."],
+)
+
+py_binary(
+    name = "sdlc",
+    srcs = ["__main__.py"],
+    main = "__main__.py",
+    deps = [":onboarding_lib"],
+)
+
+[
+    py_test(
+        name = test_file.removesuffix(".py"),
+        srcs = [test_file],
+        deps = [":onboarding_lib"],
+    )
+    for test_file in [
+        "tests/test_state_machine.py",
+        "tests/test_discovery.py",
+        "tests/test_recommendation.py",
+        "tests/test_output.py",
+    ]
+]

tools/onboarding/tools/onboarding/__init__.py

@@ -0,0 +1,24 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+"""Minimal onboarding agent: collects context, discovers repo, routes workflow."""
+
+from .models import ContextEnvelope, ContributorProfile, RepositoryContext, WorkItem, WorkflowSelection
+
+__all__ = [
+    "ContextEnvelope",
+    "ContributorProfile",
+    "RepositoryContext",
+    "WorkItem",
+    "WorkflowSelection",
+]

tools/onboarding/tools/onboarding/__main__.py

@@ -0,0 +1,21 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+import sys
+
+# Absolute import: Bazel's py_binary stub runs this file as a top-level
+# script, so `__package__` is empty and relative imports fail.
+from tools.onboarding.cli import cli
+
+if __name__ == "__main__":
+    cli(sys.argv[1:])

tools/onboarding/tools/onboarding/agent/onboarding.agent.yaml

@@ -0,0 +1,39 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+
+description: "Type /sdlc or KICKOFF to start Eclipse S-CORE onboarding."
+entry_point: "tools.onboarding.cli:cli"
+skill: "onboarding.skill.md"
+
+collects:
+  - role
+  - repository
+  - technology
+  - contribution_type
+  - workflow
+
+produces:
+  - .onboarding/context.json
+
+handoffs:
+  - label: Start Issue Planning
+    agent: plan-issue-creation
+  - label: Start Technical Analysis
+    agent: plan-tech-analysis
+  - label: Start PLAN
+    agent: plan-requirements
+  - label: Start CODE (PoC / Spike)
+    agent: code-design
+
+notes: >
+  This agent only recommends a handoff. It never executes downstream agents automatically; the contributor must confirm before a handoff is started.

tools/onboarding/tools/onboarding/agent/onboarding.skill.md

@@ -0,0 +1,63 @@
+<!--
+*******************************************************************************
+Copyright (c) 2026 Contributors to the Eclipse Foundation
+
+See the NOTICE file(s) distributed with this work for additional
+information regarding copyright ownership.
+
+This program and the accompanying materials are made available under the
+terms of the Apache License Version 2.0 which is available at
+https://www.apache.org/licenses/LICENSE-2.0
+
+SPDX-License-Identifier: Apache-2.0
+*******************************************************************************
+-->
+
+# Onboarding Skill
+
+Single entry point into the Eclipse S-CORE AI SDLC ecosystem. Collects
+context, classifies the contribution, recommends a workflow, and hands off —
+it does not execute SDLC Harness, SpecKit, BMAD, Technical Analysis, or
+Planning itself.
+
+## Role Detection
+Ask the contributor for their role: `developer`, `reviewer`, `maintainer`, or
+`committer`. Returning contributors may skip the introduction.
+
+## Repository Discovery
+Read (never execute) `MODULE.bazel`, `project_config.bzl`, `README.md`, and
+`CONTRIBUTION.md` at the repository root. Extract: repository name, module,
+ASIL level, declared languages, build system.
+
+## Technology Discovery
+From `MODULE.bazel`, detect toolchains by dependency name:
+- `rules_rust` → Rust
+- `rules_cc` → C++
+- `toolchains_llvm` → LLVM
+- `qnx` (in `MODULE.bazel` or `scripts/`) → QNX
+
+## Contribution Classification
+Ask for the contribution type: `bug_fix`, `improvement`, `poc`,
+`documentation`, `feature`, or `question`.
+
+## Workflow Recommendation
+Map contribution type to a workflow (see `recommendation.py`):
+- `bug_fix` → SDLC Harness
+- `improvement` → SpecKit
+- `poc` → BMAD
+- `documentation` → Traditional
+- otherwise → Technical Analysis / Issue Planning
+
+If the repository's ASIL level is not `QM`, always recommend SDLC Harness
+regardless of contribution type, since safety-relevant work requires full
+traceability. The contributor may always override the recommendation.
+
+## Guardrails
+- Never write outside `.onboarding/context.json`.
+- Never auto-start a downstream agent; always require explicit confirmation.
+- Never fabricate repository metadata that discovery could not detect —
+  surface it as `"Unknown"` and let the contributor confirm/correct it.
+
+## Open-source contribution rules
+Point contributors to `CONTRIBUTION.md` for PR/issue templates, the ECA/DCO
+signing requirement, and commit message rules before any handoff.