Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 25 additions & 10 deletions agent-pack/CAPABILITY_MATRIX.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@

| Capability | OpenCode | Codex CLI |
|---|---|---|
| **Agents / roles** | SUPPORTED — `builder` (generic implementation), `arch-data-engineer` (specialist, scoped permissions), `reviewer` (read-only, restricted permissions), `planner` (read-only planning and routing), `mechanical` (deterministic low-judgment operations) | NOT YET ASSESSED |
| **Skills / contracts** | SUPPORTED — 5 skills: neuralengine, repository-review, python-project-validation, arch-linux-diagnostics, verification | NOT YET ASSESSED |
| **Global instructions** | SUPPORTED — `neuralengine-usage.md` loaded via `opencode.json` instructions array | NOT YET ASSESSED |
| **Permissions** | SUPPORTED — Agent-level permission blocks with allow/deny/ask for edit, bash, task, tools. Reviewer enforces read-only. | NOT YET ASSESSED |
| **Shell execution** | SUPPORTED — Scoped bash allowlist for `arch-data-engineer` (read-only diagnostics and validation; commit, push, destructive Git/filesystem/partitioning commands, and Ruff auto-fix denied). Restricted allowlist for `reviewer`. | NOT YET ASSESSED |
| **Repository instructions** | SUPPORTED — `AGENTS.md`, `CODEX.md`, `VISION.md`, `CONTEXT.md`, `pyproject.toml` awareness built into agent rules | NOT YET ASSESSED |
| **NeuralEngine CLI** | SUPPORTED — `neural status` and `neural search` available and used in all reviews | NOT YET ASSESSED |
| **Agents / roles** | SUPPORTED — `builder` (generic implementation), `arch-data-engineer` (specialist, scoped permissions), `reviewer` (read-only, restricted permissions), `planner` (read-only planning and routing), `mechanical` (deterministic low-judgment operations) | NOT YET ASSESSED — outside this NeuralEngine-only slice |
| **Skills / contracts** | SUPPORTED — 5 skills: neuralengine, repository-review, python-project-validation, arch-linux-diagnostics, verification | SUPPORTED WITH LIMITATIONS — NeuralEngine contract projection only; other contracts remain unmapped |
| **Global instructions** | SUPPORTED — `neuralengine-usage.md` loaded via `opencode.json` instructions array | SUPPORTED WITH LIMITATIONS — short `AGENTS.md` pointer; Codex CLI runtime discovery not exercised here |
| **Permissions** | SUPPORTED — Agent-level permission blocks with allow/deny/ask for edit, bash, task, tools. Reviewer enforces read-only. | SUPPORTED WITH LIMITATIONS — Codex host sandbox/approval controls remain authoritative; no adapter write authority |
| **Shell execution** | SUPPORTED — Scoped bash allowlist for `arch-data-engineer` (read-only diagnostics and validation; commit, push, destructive Git/filesystem/partitioning commands, and Ruff auto-fix denied). Restricted allowlist for `reviewer`. | SUPPORTED WITH LIMITATIONS — `neural` commands are ordinary host shell commands; executable/PATH/runtime behavior not verified |
| **Repository instructions** | SUPPORTED — `AGENTS.md`, `CODEX.md`, `VISION.md`, `CONTEXT.md`, `pyproject.toml` awareness built into agent rules | SUPPORTED WITH LIMITATIONS — Codex CLI native `AGENTS.md` pointer for substantive/consequential work |
| **NeuralEngine CLI** | SUPPORTED — `neural status` and `neural search` available and used in all reviews | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; target installation not verified |
| **Review** | SUPPORTED — `repository-review` skill, reviewer agent with read-only permissions, formal review format with verdict/checkpoint/validation/scope/findings | NOT YET ASSESSED |
| **Verification** | SUPPORTED — reviewer agent with `verification` skill and enforced read-only command permissions (8 additional allow patterns: find, test, wc, sha256sum, diff, cmp, grep, sed). Quick Verification runs without permission prompts. | NOT YET ASSESSED |
| **Certification** | SUPPORTED — Certification Report template, 3 verdicts (CERTIFIED/CERTIFIED WITH NOTES/NOT CERTIFIED), collision-safe naming, `.agent-work/certifications/` convention | NOT YET ASSESSED |
Expand All @@ -30,9 +30,10 @@

## Codex CLI assessment notes

All Codex capabilities are `NOT YET ASSESSED`. The Codex Platform Assessment
(task: `.agent-work/prompts/assess-codex-platform-v1.0.md`) is the designated
authority to evaluate Codex against this matrix.
This implementation assesses only the bounded Codex CLI NeuralEngine slice.
The remaining Codex capabilities stay `NOT YET ASSESSED`. The provider-native
assessment at `.agent-work/reviews/review-provider-native-cross-agent-neuralengine-adapters.md`
is the authority for the host findings used by this slice.

The following rules apply to the Codex assessment:

Expand All @@ -47,6 +48,20 @@ The following rules apply to the Codex assessment:
the v1.0 Adapter API defined in
[DECISIONS/architecture-freeze-v1.0.md](../DECISIONS/architecture-freeze-v1.0.md).

## Codex CLI evidence sources

The bounded Codex CLI NeuralEngine slice is derived from:

- `platforms/codex/AGENTS.md` — minimal project-instruction pointer.
- `platforms/codex/skills/neuralengine/SKILL.md` — controlled semantic
projection of `shared/neuralengine.md` with Codex-required front matter.
- `MANIFEST.md` — shared-to-Codex mapping and controlled-copy boundary.
- `tests/test_agent_rollout.py` — focused front-matter, pointer, and semantic
drift checks.

These files do not claim full Codex Adapter API support, Codex Desktop support,
or provider runtime installation.

## OpenCode evidence sources

OpenCode capabilities are derived from:
Expand Down
17 changes: 9 additions & 8 deletions agent-pack/MANIFEST.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@

## Shared-to-platform mapping

| Authoritative source | OpenCode target |
|---|---|
| `shared/neuralengine.md` | global instruction (`neuralengine-usage.md`) and NeuralEngine skill |
| `shared/repository-review.md` | repository-review skill |
| `shared/python-validation.md` | python-project-validation skill |
| `shared/arch-linux.md` | arch-linux-diagnostics skill |
| `shared/verification.md` | verification skill (Quick, Standard, and Certification implemented) |
| `shared/task-execution-policy.md` | no platform copy (vocabulary contract, deferred consumption) |
| Authoritative source | OpenCode target | Codex CLI target |
|---|---|---|
| `shared/neuralengine.md` | global instruction (`neuralengine-usage.md`) and NeuralEngine skill | `platforms/codex/skills/neuralengine/SKILL.md` (controlled copy; install target is `.agents/skills/neuralengine/SKILL.md`) |
| `shared/repository-review.md` | repository-review skill | not mapped in this slice |
| `shared/python-validation.md` | python-project-validation skill | not mapped in this slice |
| `shared/arch-linux.md` | arch-linux-diagnostics skill | not mapped in this slice |
| `shared/verification.md` | verification skill (Quick, Standard, and Certification implemented) | not mapped in this slice |
| `shared/task-execution-policy.md` | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) |

## Platform-specific files (no shared equivalent)

Expand All @@ -19,6 +19,7 @@
- `agents/reviewer.md`
- `agents/planner.md`
- `agents/mechanical.md`
- `codex/AGENTS.md`

These files are platform-specific configuration artifacts. They have no
corresponding shared source in this pack.
Expand Down
12 changes: 7 additions & 5 deletions agent-pack/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,11 @@ repository—not a separate product.
## Scope

- Six authoritative shared workflow files (Verification Framework added in v0.2.0, Task Execution Policy added in v0.4.0).
- One platform variant (OpenCode) derived from the user's current, working
OpenCode configuration.
- Placeholder directories for future Codex, Claude Code, and Antigravity
platform variants.
- One complete platform variant (OpenCode) derived from the user's current,
working OpenCode configuration.
- One bounded Codex CLI NeuralEngine skill projection.
- Placeholder directories for future Claude Code and Antigravity platform
variants.

This pack does not modify NeuralEngine runtime behavior, Brain persistence,
schemas, migrations, user data, or public APIs.
Expand Down Expand Up @@ -47,7 +48,7 @@ contract and introduces the generic builder agent:
| Task Execution Policy foundation review | READY FOR INDEPENDENT REVIEW |
| ACP independent review | PASS |
| OpenCode | Supported |
| Codex | Placeholder (not implemented) |
| Codex CLI NeuralEngine slice | Supported with limitations (CLI only) |
| Claude Code | Placeholder (not implemented) |
| Antigravity | Placeholder (not implemented) |

Expand Down Expand Up @@ -211,6 +212,7 @@ Shared contracts:
OpenCode platform implementation:

- [platforms/opencode/](platforms/opencode/) — OpenCode adapter and skills.
- [platforms/codex/](platforms/codex/) — Codex CLI NeuralEngine adapter slice.
- [platforms/opencode/agents/planner.md](platforms/opencode/agents/planner.md) — Read-only planning and routing agent.
- [platforms/opencode/agents/builder.md](platforms/opencode/agents/builder.md) — Generic builder agent (new in v0.4.0).
- [platforms/opencode/agents/arch-data-engineer.md](platforms/opencode/agents/arch-data-engineer.md) — Specialist implementation agent.
Expand Down
7 changes: 7 additions & 0 deletions agent-pack/platforms/codex/AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Codex CLI NeuralEngine pointer

For substantive or consequential work, consider the repository
`neuralengine` skill at `.agents/skills/neuralengine/SKILL.md`.

The semantic authority is `agent-pack/shared/neuralengine.md`. This pointer
does not duplicate or redefine that contract.
46 changes: 40 additions & 6 deletions agent-pack/platforms/codex/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,43 @@
# Codex Platform
# Codex CLI Platform

**Status:** Not implemented as of Agent Pack v0.2.0.
**Status:** NeuralEngine thin adapter implemented for Codex CLI only.

**Intended future mapping:** Adapt the five shared contracts to Codex agent
configuration format. Map OpenCode skills and agents to equivalent Codex
constructs.
This adapter is a controlled projection of
`agent-pack/shared/neuralengine.md`. It does not implement Codex Desktop or
any other provider, and it does not modify NeuralEngine runtime behavior,
Brain persistence, schemas, APIs, or user-global Codex configuration.

**Current version:** Not supported. This directory exists as a placeholder.
## Adapter files

- `AGENTS.md` — minimal project-instruction pointer; merge this pointer into a
target repository's project instructions without replacing unrelated rules.
- `skills/neuralengine/SKILL.md` — Codex-compatible skill projection with only
the required `name` and `description` front matter.

The skill body is a controlled copy of the shared contract. Drift validation
requires the body after front matter removal to remain byte-equal to
`agent-pack/shared/neuralengine.md`.

## Manual installation mapping

Installation is explicit and manual, consistent with the Agent Pack
architecture:

```text
skills/neuralengine/SKILL.md
→ <target-repository>/.agents/skills/neuralengine/SKILL.md
```

The `AGENTS.md` content is a pointer to merge into the target repository's
project instructions. This package does not provide an installer, write to
`~/.codex`, or claim Desktop support.

## Limitations

- Codex CLI is the only supported surface in this adapter.
- Codex Desktop discovery parity is not established by this slice.
- Availability of the `neural` executable, `PATH`, Brain access, and runtime
command behavior must be verified in the target environment.
- Host permissions and approvals remain Codex controls; this adapter grants no
Brain-write, staging, commit, push, merge, tag, release, or publication
authority.
Loading