open-codev-workflow 0.1.4__tar.gz → 0.4.0__tar.gz

{open_codev_workflow-0.1.4 → open_codev_workflow-0.4.0}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2026, Martin Urban
+Copyright (c) 2026, Martin Urban, Hannah Kullik
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

open_codev_workflow-0.4.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: open-codev-workflow
+Version: 0.4.0
+Summary: Human-guided AI software delivery for real repositories.
+Author: Martin Urban
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/urban233/CoDev
+Project-URL: Repository, https://github.com/urban233/CoDev
+Project-URL: Issues, https://github.com/urban233/CoDev/issues
+Keywords: ai,developer-tools,software-delivery,antigravity,claude-code,junie,opencode
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pre-commit>=4.6.1
+Provides-Extra: dev
+Requires-Dist: build>=1.2.2; extra == "dev"
+Requires-Dist: mypy>=1.15; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: twine>=6.1; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/codev-mark.svg" width="96" height="96" alt="CoDev mark">
+</p>
+
+<h1 align="center">CoDev</h1>
+
+<p align="center"><strong>Human-guided AI software delivery.</strong></p>
+
+![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
+![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
+![CI](https://img.shields.io/github/actions/workflow/status/urban233/CoDev/ci.yml?branch=main&label=CI&style=flat-square)
+![PyPI version](https://img.shields.io/pypi/v/open-codev-workflow?style=flat-square)
+![Python versions](https://img.shields.io/pypi/pyversions/open-codev-workflow?style=flat-square)
+![License](https://img.shields.io/github/license/urban233/CoDev?style=flat-square)
+![Latest release](https://img.shields.io/github/v/release/urban233/CoDev?style=flat-square)
+![GitHub stars](https://img.shields.io/github/stars/urban233/CoDev?style=flat-square)
+![GitHub issues](https://img.shields.io/github/issues/urban233/CoDev?style=flat-square)
+
+CoDev installs a small, production-minded collaboration system into any Git repository. A
+developer and AI move through four steps — **Understand, Build, Review, Ship** — plus two
+that only show up when the work actually needs them: **Specify** for a genuinely new
+product, **Launch** for a real rollout decision. Review is layered, not a single pass: a
+fast correctness check after each build, an automatic style and maintainability gate
+immediately before a pull request opens, and five parallel specialist reviewers once it's
+open. It supports bounded three-agent execution without turning product development into
+an unattended coding loop.
+
+## Why CoDev
+
+- One workflow for solo developers and multi-developer teams.
+- Repository-grounded plans instead of invented APIs or architecture.
+- A bounded builder, an automatic pre-PR audit gate, and five parallel specialist
+  reviewers — not just one read-only pass.
+- Human authority over material decisions, merge, deployment, and rollout.
+- A general-purpose skill-evaluation harness — measure whether a skill (CoDev's own, or
+  one you wrote) actually helps, empirically, rather than just trusting that it does.
+- Versioned, conflict-aware installation across existing repositories.
+- No runtime dependency in the software being built.
+
+## Try it in 60 seconds
+
+```shell
+pipx install open-codev-workflow
+# or: uv tool install open-codev-workflow
+
+codev init --target . --agent-platform all
+codev status --target .
+```
+
+```text
+CoDev 0.4.0 - /path/to/your/repo
+Bundle: healthy (83 managed files, no drift)
+Adapters: opencode
+Tasks in progress: 0
+```
+
+Commit the installed files as one infrastructure change, then start an AI session in the
+repository and describe a small bug or task in plain language — you don't need to name a
+skill. **[Tutorial 1](src/codev_workflow/bundle/docs/codev/tutorials/01-your-first-fix.md)
+walks one small fix from here to a merged pull request, with every command and real
+output shown.**
+
+## Where to go next
+
+| I want to... | Go to |
+|---|---|
+| Understand the mental model before doing anything | [Onboarding guide](src/codev_workflow/bundle/docs/codev/onboarding/onboarding-guide.md) |
+| Just try it, right now | [Tutorial 1: your first fix](src/codev_workflow/bundle/docs/codev/tutorials/01-your-first-fix.md) |
+| See every command | [CLI reference](docs/cli-reference.md) |
+| See exactly what gets installed and why | [Architecture](docs/architecture.md) |
+| Adopt CoDev for a team, not just myself | [Adoption guide](docs/adoption.md) |
+| Understand why a specific mechanism exists | [Architecture Decision Records](docs/adr/) |
+| Set up GitHub CLI for PR review on Windows | [PR review setup](docs/pr-review-github-cli-setup.md) |
+| Contribute to CoDev itself | [Contributing](CONTRIBUTING.md) |
+| See everything `docs/` contains, organized by audience | [docs/README.md](docs/README.md) |
+
+## Design principles
+
+1. **Local at use time.** Agents read ordinary files in the target repository.
+2. **Central at maintenance time.** This repository is the canonical source.
+3. **Human at authority boundaries.** Automation supplies evidence, not approval.
+4. **Small by default.** Deeper design and delivery planning appear only when risk or
+   coordination requires them.
+5. **Safe to adopt.** Existing instructions and OpenCode settings are preserved.
+
+## Development
+
+```shell
+python -m unittest discover -s tests -v
+python -m compileall -q src tests
+python -m codev_workflow --version
+```
+
+Optional development checks:
+
+```shell
+python -m ruff check .
+python -m ruff format --check .
+python -m mypy
+python -m build
+python scripts/check_bundled_doc_links.py
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for what's expected of a change, and
+[docs/releasing.md](docs/releasing.md) for the release process.
+
+CoDev is licensed under BSD-3-Clause.

open_codev_workflow-0.4.0/README.md

@@ -0,0 +1,107 @@
+<p align="center">
+  <img src="assets/codev-mark.svg" width="96" height="96" alt="CoDev mark">
+</p>
+
+<h1 align="center">CoDev</h1>
+
+<p align="center"><strong>Human-guided AI software delivery.</strong></p>
+
+![Active Feature Development](https://img.shields.io/badge/Project_State-Active_Feature_Development-brightgreen?style=flat-square)
+![AI-driven](https://img.shields.io/badge/AI_Use-AI--driven-orange?style=flat-square)
+![CI](https://img.shields.io/github/actions/workflow/status/urban233/CoDev/ci.yml?branch=main&label=CI&style=flat-square)
+![PyPI version](https://img.shields.io/pypi/v/open-codev-workflow?style=flat-square)
+![Python versions](https://img.shields.io/pypi/pyversions/open-codev-workflow?style=flat-square)
+![License](https://img.shields.io/github/license/urban233/CoDev?style=flat-square)
+![Latest release](https://img.shields.io/github/v/release/urban233/CoDev?style=flat-square)
+![GitHub stars](https://img.shields.io/github/stars/urban233/CoDev?style=flat-square)
+![GitHub issues](https://img.shields.io/github/issues/urban233/CoDev?style=flat-square)
+
+CoDev installs a small, production-minded collaboration system into any Git repository. A
+developer and AI move through four steps — **Understand, Build, Review, Ship** — plus two
+that only show up when the work actually needs them: **Specify** for a genuinely new
+product, **Launch** for a real rollout decision. Review is layered, not a single pass: a
+fast correctness check after each build, an automatic style and maintainability gate
+immediately before a pull request opens, and five parallel specialist reviewers once it's
+open. It supports bounded three-agent execution without turning product development into
+an unattended coding loop.
+
+## Why CoDev
+
+- One workflow for solo developers and multi-developer teams.
+- Repository-grounded plans instead of invented APIs or architecture.
+- A bounded builder, an automatic pre-PR audit gate, and five parallel specialist
+  reviewers — not just one read-only pass.
+- Human authority over material decisions, merge, deployment, and rollout.
+- A general-purpose skill-evaluation harness — measure whether a skill (CoDev's own, or
+  one you wrote) actually helps, empirically, rather than just trusting that it does.
+- Versioned, conflict-aware installation across existing repositories.
+- No runtime dependency in the software being built.
+
+## Try it in 60 seconds
+
+```shell
+pipx install open-codev-workflow
+# or: uv tool install open-codev-workflow
+
+codev init --target . --agent-platform all
+codev status --target .
+```
+
+```text
+CoDev 0.4.0 - /path/to/your/repo
+Bundle: healthy (83 managed files, no drift)
+Adapters: opencode
+Tasks in progress: 0
+```
+
+Commit the installed files as one infrastructure change, then start an AI session in the
+repository and describe a small bug or task in plain language — you don't need to name a
+skill. **[Tutorial 1](src/codev_workflow/bundle/docs/codev/tutorials/01-your-first-fix.md)
+walks one small fix from here to a merged pull request, with every command and real
+output shown.**
+
+## Where to go next
+
+| I want to... | Go to |
+|---|---|
+| Understand the mental model before doing anything | [Onboarding guide](src/codev_workflow/bundle/docs/codev/onboarding/onboarding-guide.md) |
+| Just try it, right now | [Tutorial 1: your first fix](src/codev_workflow/bundle/docs/codev/tutorials/01-your-first-fix.md) |
+| See every command | [CLI reference](docs/cli-reference.md) |
+| See exactly what gets installed and why | [Architecture](docs/architecture.md) |
+| Adopt CoDev for a team, not just myself | [Adoption guide](docs/adoption.md) |
+| Understand why a specific mechanism exists | [Architecture Decision Records](docs/adr/) |
+| Set up GitHub CLI for PR review on Windows | [PR review setup](docs/pr-review-github-cli-setup.md) |
+| Contribute to CoDev itself | [Contributing](CONTRIBUTING.md) |
+| See everything `docs/` contains, organized by audience | [docs/README.md](docs/README.md) |
+
+## Design principles
+
+1. **Local at use time.** Agents read ordinary files in the target repository.
+2. **Central at maintenance time.** This repository is the canonical source.
+3. **Human at authority boundaries.** Automation supplies evidence, not approval.
+4. **Small by default.** Deeper design and delivery planning appear only when risk or
+   coordination requires them.
+5. **Safe to adopt.** Existing instructions and OpenCode settings are preserved.
+
+## Development
+
+```shell
+python -m unittest discover -s tests -v
+python -m compileall -q src tests
+python -m codev_workflow --version
+```
+
+Optional development checks:
+
+```shell
+python -m ruff check .
+python -m ruff format --check .
+python -m mypy
+python -m build
+python scripts/check_bundled_doc_links.py
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for what's expected of a change, and
+[docs/releasing.md](docs/releasing.md) for the release process.
+
+CoDev is licensed under BSD-3-Clause.

{open_codev_workflow-0.1.4 → open_codev_workflow-0.4.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "open-codev-workflow"
-version = "0.1.4"
+version = "0.4.0"
 description = "Human-guided AI software delivery for real repositories."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "BSD-3-Clause"
 authors = [{ name = "Martin Urban" }]
-keywords = ["ai", "developer-tools", "software-delivery", "antigravity", "codex", "junie", "opencode"]
+keywords = ["ai", "developer-tools", "software-delivery", "antigravity", "claude-code", "junie", "opencode"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Environment :: Console",
@@ -22,7 +22,9 @@ classifiers = [
   "Programming Language :: Python :: 3.13",
   "Topic :: Software Development :: Quality Assurance",
 ]
-dependencies = []
+dependencies = [
+    "pre-commit>=4.6.1",
+]
 
 [project.urls]
 Homepage = "https://github.com/urban233/CoDev"
@@ -50,26 +52,35 @@ where = ["src"]
 [tool.setuptools.package-data]
 codev_workflow = [
   "bundle/AGENTS.md",
+  "bundle/.codev/for-ai/*.md",
   "bundle/.agents/skills/*/SKILL.md",
+  "bundle/.agents/skills/*/skill-card.md",
   "bundle/.agents/skills/*/agents/*.yaml",
   "bundle/.agents/skills/*/assets/*",
   "bundle/.agents/skills/*/references/*",
   "bundle/.agents/skills/*/scripts/*",
   "bundle/.agents/agents/*.md",
+  "bundle/.agents/agents/*.md.template",
+  "bundle/.claude/agents/*.md",
+  "bundle/.claude/agents/*.md.template",
+  "bundle/.claude/commands/*.md",
+  "bundle/.claude/hooks/*.py",
+  "bundle/.claude/settings.json",
+  "bundle/.claude/CLAUDE.md",
   "bundle/.opencode/agents/*.md",
+  "bundle/.opencode/agents/*.md.template",
   "bundle/.junie/agents/*.md",
-  "bundle/.junie/commands/*.md",
+  "bundle/.github/*.md",
+  "bundle/.github/ISSUE_TEMPLATE/*.md",
   "bundle/docs/*.md",
-  "bundle/docs/for-ai/*.md",
-  "bundle/docs/handbooks/*.md",
-  "bundle/evals/development-workflow/*.json",
-  "bundle/scripts/*.py",
+  "bundle/docs/codev/onboarding/*.md",
+  "bundle/docs/codev/tutorials/*.md",
 ]
 
 [tool.ruff]
 line-length = 88
 target-version = "py311"
-exclude = ["src/codev_workflow/bundle"]
+exclude = ["src/codev_workflow/bundle", ".codev/eval/tasks/*/repository"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B", "SIM"]

open_codev_workflow-0.4.0/src/codev_workflow/__init__.py

@@ -0,0 +1,33 @@
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Urban, Hannah Kullik
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""CoDev: human-guided AI software delivery."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.4.0"

open_codev_workflow-0.4.0/src/codev_workflow/__main__.py

@@ -0,0 +1,32 @@
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Urban, Hannah Kullik
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+from codev_workflow.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

open_codev_workflow-0.4.0/src/codev_workflow/adapter.py

@@ -0,0 +1,229 @@
+# BSD 3-Clause License
+#
+# Copyright (c) 2026, Martin Urban, Hannah Kullik
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1. Redistributions of source code must retain the above copyright notice, this
+#    list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# 3. Neither the name of the copyright holder nor the names of its
+#    contributors may be used to endorse or promote products derived from
+#    this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""Conformance checks for installed platform adapters.
+
+Verifies structural parity across the full-workflow platform adapters
+(OpenCode, Claude Code) without requiring them to be rendered from one source
+yet: every role file must reference the `codev task` lifecycle wiring, must
+not resurrect the retired P0-P3 finding scale, and must not grant
+unrestricted shell execution. This is a second line of defense against
+cross-adapter drift, not a substitute for eventually rendering adapters from
+one config source.
+
+Junie and Antigravity are a narrower tier (ADR-0031): a single bounded-edit
+`assistant` role with no task-lifecycle integration. They still go through
+the same forbidden-pattern checks below (no unrestricted shell, no raw git
+mutation), just with no required markers to enforce.
+"""
+
+from __future__ import annotations
+
+import tomllib
+from dataclasses import dataclass
+from pathlib import Path
+
+_OUTER_LOOP_ROLES = (
+    "outer-loop-runner",
+    "correctness-tests-specialist",
+    "security-data-specialist",
+    "concurrency-specialist",
+    "architecture-maintainability-specialist",
+    "rollout-specialist",
+)
+
+
+def _role_paths(directory: str, extension: str) -> dict[str, str]:
+    # code-audit (and its code-audit-gate counterpart, ADR-0015) are
+    # deliberately absent here: both are templated ({{LANGUAGE_INSTRUCTIONS}}
+    # etc.), so the raw bundle only ever has a .template source, never the
+    # rendered filename this function's paths assume -- verify_adapter's
+    # bundle-parity test runs directly against the raw bundle. Their rendered
+    # output is instead checked where it's actually produced, by the
+    # installer's own per-platform agent-rendering tests.
+    paths = {
+        "orchestrator": f"{directory}/orchestrator.{extension}",
+        "planner": f"{directory}/planner.{extension}",
+        "builder": f"{directory}/builder.{extension}",
+        "reviewer": f"{directory}/reviewer.{extension}",
+        "lightweight-reviewer": f"{directory}/lightweight-reviewer.{extension}",
+    }
+    for role in _OUTER_LOOP_ROLES:
+        paths[role] = f"{directory}/{role}.{extension}"
+    return paths
+
+
+ADAPTER_ROLE_PATHS: dict[str, dict[str, str]] = {
+    "opencode": _role_paths(".opencode/agents", "md"),
+    "claude": _role_paths(".claude/agents", "md"),
+    # Junie and Antigravity are the narrow tier: a single bounded-edit
+    # `assistant` role, not the full orchestrator-driven workflow (see
+    # ADR-0031) -- no outer-loop roles, no code-audit, no task-lifecycle
+    # markers to require.
+    "junie": {"assistant": ".junie/agents/assistant.md"},
+    "antigravity": {"assistant": ".agents/agents/assistant.md"},
+}
+
+_REQUIRED_MARKERS: dict[str, tuple[str, ...]] = {
+    "orchestrator": (
+        "codev task start",
+        "codev task check",
+        "codev git open-pr",
+        "--github-issue",
+        "codev git issue-create",
+        "--no-github-issue",
+    ),
+    "planner": ("codev git issue-create",),
+    "builder": ("codev task record",),
+    "reviewer": ("codev task record",),
+    "lightweight-reviewer": ("codev task record",),
+    "outer-loop-runner": (
+        "codev task record",
+        "codev task triage",
+        "codev task waive",
+        "codev task reopen",
+        "--selection",
+        "codev git mark-ready",
+    ),
+    "correctness-tests-specialist": ("expansion_reason",),
+    "security-data-specialist": ("expansion_reason",),
+    "concurrency-specialist": ("expansion_reason",),
+    "architecture-maintainability-specialist": ("expansion_reason",),
+    "rollout-specialist": ("expansion_reason",),
+    # The narrow Junie/Antigravity `assistant` role is deliberately decoupled
+    # from the task lifecycle -- it never calls `codev task`/`codev git`, so
+    # there is no required marker to check for.
+    "assistant": (),
+}
+
+_FORBIDDEN_MARKERS: tuple[str, ...] = ("P0 through P3",)
+
+_UNRESTRICTED_BASH_MARKERS: tuple[str, ...] = ('"*": allow', "'*': allow")
+
+# ADR-0002: raw git/GitHub mutation must stay denied everywhere; `codev git`
+# is the only guarded path to committing, pushing, or opening a pull request.
+_RAW_MUTATION_MARKERS: tuple[str, ...] = (
+    '"git push*": allow',
+    "'git push*': allow",
+    '"git commit*": allow',
+    "'git commit*': allow",
+)
+
+# `codev git open-pr` renders recorded task evidence into the repository PR
+# template when no `--body`/`--body-file` is given. An agent hardcoding a body
+# placeholder would bypass that guarded rendering path.
+_HANDWRITTEN_PR_BODY_MARKERS: tuple[str, ...] = ("--body <body>",)
+
+# ADR-0021: OpenCode's per-subagent `task` permission block is the only
+# mechanical backstop against outer-loop-runner silently skipping the human
+# specialist-selection menu (ADR-0016/0018) -- these five must stay "ask",
+# never regress to "allow", or the one available guardrail disappears again
+# without anything noticing.
+_SPECIALIST_ALLOW_MARKERS: tuple[str, ...] = (
+    "correctness-tests-specialist: allow",
+    "security-data-specialist: allow",
+    "concurrency-specialist: allow",
+    "architecture-maintainability-specialist: allow",
+    "rollout-specialist: allow",
+)
+
+
+class AdapterVerificationError(Exception):
+    """Raised when a platform cannot be verified at all."""
+
+
+@dataclass(frozen=True)
+class RoleFinding:
+    role: str
+    path: str
+    ok: bool
+    problems: tuple[str, ...]
+
+
+@dataclass(frozen=True)
+class VerificationResult:
+    platform: str
+    findings: tuple[RoleFinding, ...]
+
+    @property
+    def ok(self) -> bool:
+        return all(finding.ok for finding in self.findings)
+
+
+def verify_adapter(platform: str, *, target: Path) -> VerificationResult:
+    role_paths = ADAPTER_ROLE_PATHS.get(platform)
+    if role_paths is None:
+        raise AdapterVerificationError(f"unknown platform: {platform!r}")
+
+    findings: list[RoleFinding] = []
+    for role, relative in sorted(role_paths.items()):
+        path = target / relative
+        problems: list[str] = []
+        if not path.is_file():
+            findings.append(RoleFinding(role, relative, False, ("missing file",)))
+            continue
+
+        text = path.read_text(encoding="utf-8")
+
+        if relative.endswith(".toml"):
+            try:
+                tomllib.loads(text)
+            except tomllib.TOMLDecodeError as error:
+                problems.append(f"invalid TOML: {error}")
+
+        for marker in _REQUIRED_MARKERS[role]:
+            if marker not in text:
+                problems.append(f"missing required reference: {marker!r}")
+        for marker in _FORBIDDEN_MARKERS:
+            if marker in text:
+                problems.append(f"contains a retired pattern: {marker!r}")
+        for marker in _UNRESTRICTED_BASH_MARKERS:
+            if marker in text:
+                problems.append(f"grants unrestricted shell execution: {marker!r}")
+        for marker in _RAW_MUTATION_MARKERS:
+            if marker in text:
+                problems.append(
+                    f"grants raw git mutation instead of the guarded `codev git` "
+                    f"surface: {marker!r}"
+                )
+        for marker in _HANDWRITTEN_PR_BODY_MARKERS:
+            if marker in text:
+                problems.append(
+                    f"hardcodes a PR body placeholder instead of relying on "
+                    f"`codev git open-pr`'s template-aware rendering: {marker!r}"
+                )
+        for marker in _SPECIALIST_ALLOW_MARKERS:
+            if marker in text:
+                problems.append(
+                    f"grants unconfirmed specialist dispatch instead of the "
+                    f"ADR-0021 permission gate: {marker!r}"
+                )
+
+        findings.append(RoleFinding(role, relative, not problems, tuple(problems)))
+
+    return VerificationResult(platform, tuple(findings))