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
30 changes: 15 additions & 15 deletions agent-pack/CAPABILITY_MATRIX.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,21 +12,21 @@

## Matrix

| Capability | OpenCode | Codex CLI | Goose CLI/Desktop | Claude Code/Desktop Code |
|---|---|---|---|---|
| **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 | NOT YET ASSESSED — custom agents are outside this bounded slice | NOT YET ASSESSED — custom agents are outside this bounded 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 | SUPPORTED WITH LIMITATIONS — NeuralEngine contract projection only; other contracts remain unmapped | 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 | SUPPORTED WITH LIMITATIONS — short `AGENTS.md` pointer; Desktop launcher discovery remains environment-dependent | SUPPORTED WITH LIMITATIONS — native `CLAUDE.md` pointer; Desktop Code shares project configuration |
| **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 | SUPPORTED WITH LIMITATIONS — Goose host permission/approval controls remain authoritative; no adapter write authority | SUPPORTED WITH LIMITATIONS — Claude host permission modes 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 | SUPPORTED WITH LIMITATIONS — Developer shell tools are documented; executable/PATH/runtime behavior is target-environment dependent | SUPPORTED WITH LIMITATIONS — CLI shell execution is available; Desktop/local environment and `neural` availability remain target-dependent |
| **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 | SUPPORTED WITH LIMITATIONS — Goose project context files are documented; exact Desktop conflict precedence remains unverified | SUPPORTED WITH LIMITATIONS — `CLAUDE.md` is native; `AGENTS.md` requires an explicit import/reference |
| **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 | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; target installation and Desktop command availability not verified | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; Desktop Code runtime availability not locally verified |
| **Review** | SUPPORTED — `repository-review` skill, reviewer agent with read-only permissions, formal review format with verdict/checkpoint/validation/scope/findings | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **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 | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Certification** | SUPPORTED — Certification Report template, 3 verdicts (CERTIFIED/CERTIFIED WITH NOTES/NOT CERTIFIED), collision-safe naming, `.agent-work/certifications/` convention | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Model selection** | SUPPORTED — Model configured in OpenCode runtime. Agent Pack is model-agnostic (DeepSeek V4 Pro Max, GPT-5.6 Sol Medium, others) | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Non-interactive execution** | SUPPORTED WITH LIMITATIONS — Bash commands execute non-interactively. Human confirmation required only for restricted operations per permission model. | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Artifact generation** | SUPPORTED — Review artifacts, certification reports, documentation files generated as markdown. No code generation or template engines. | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| Capability | OpenCode | Codex CLI | Goose CLI/Desktop | Claude Code/Desktop Code | Copilot 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 — outside this NeuralEngine-only slice | NOT YET ASSESSED — custom agents are outside this bounded slice | NOT YET ASSESSED — custom agents are outside this bounded slice | NOT YET ASSESSED — custom agents are outside this bounded 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 | SUPPORTED WITH LIMITATIONS — NeuralEngine contract projection only; other contracts remain unmapped | SUPPORTED WITH LIMITATIONS — NeuralEngine contract projection only; other contracts remain unmapped | 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 | SUPPORTED WITH LIMITATIONS — short `AGENTS.md` pointer; Desktop launcher discovery remains environment-dependent | SUPPORTED WITH LIMITATIONS — native `CLAUDE.md` pointer; Desktop Code shares project configuration | SUPPORTED WITH LIMITATIONS — CLI instruction locations are documented; no extra pointer is required by the skill mechanism |
| **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 | SUPPORTED WITH LIMITATIONS — Goose host permission/approval controls remain authoritative; no adapter write authority | SUPPORTED WITH LIMITATIONS — Claude host permission modes remain authoritative; no adapter write authority | SUPPORTED WITH LIMITATIONS — read-only tools are automatic; modifying tools require host approval; 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 | SUPPORTED WITH LIMITATIONS — Developer shell tools are documented; executable/PATH/runtime behavior is target-environment dependent | SUPPORTED WITH LIMITATIONS — CLI shell execution is available; Desktop/local environment and `neural` availability remain target-dependent | SUPPORTED WITH LIMITATIONS — CLI shell execution is documented; target `neural` availability not locally 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 | SUPPORTED WITH LIMITATIONS — Goose project context files are documented; exact Desktop conflict precedence remains unverified | SUPPORTED WITH LIMITATIONS — `CLAUDE.md` is native; `AGENTS.md` requires an explicit import/reference | SUPPORTED WITH LIMITATIONS — `AGENTS.md` and `.github/copilot-instructions.md` are documented CLI instruction locations; combined precedence is not a total order |
| **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 | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; target installation and Desktop command availability not verified | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; Desktop Code runtime availability not locally verified | SUPPORTED WITH LIMITATIONS — projection preserves `neural status`, targeted retrieval, and read-only boundaries; target installation not locally verified |
| **Review** | SUPPORTED — `repository-review` skill, reviewer agent with read-only permissions, formal review format with verdict/checkpoint/validation/scope/findings | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **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 | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Certification** | SUPPORTED — Certification Report template, 3 verdicts (CERTIFIED/CERTIFIED WITH NOTES/NOT CERTIFIED), collision-safe naming, `.agent-work/certifications/` convention | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Model selection** | SUPPORTED — Model configured in OpenCode runtime. Agent Pack is model-agnostic (DeepSeek V4 Pro Max, GPT-5.6 Sol Medium, others) | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Non-interactive execution** | SUPPORTED WITH LIMITATIONS — Bash commands execute non-interactively. Human confirmation required only for restricted operations per permission model. | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |
| **Artifact generation** | SUPPORTED — Review artifacts, certification reports, documentation files generated as markdown. No code generation or template engines. | NOT YET ASSESSED | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice | NOT YET ASSESSED — outside this bounded slice |

## Codex CLI assessment notes

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 | Codex CLI target | Goose CLI/Desktop target | Claude Code/Desktop Code 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`) | `platforms/goose/skills/neuralengine/SKILL.md` (controlled copy; install target is `.agents/skills/neuralengine/SKILL.md`) | `platforms/claude/skills/neuralengine/SKILL.md` (controlled copy; install target is `.claude/skills/neuralengine/SKILL.md`) |
| `shared/repository-review.md` | repository-review skill | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/python-validation.md` | python-project-validation skill | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/arch-linux.md` | arch-linux-diagnostics skill | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/verification.md` | verification skill (Quick, Standard, and Certification implemented) | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/task-execution-policy.md` | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) |
| Authoritative source | OpenCode target | Codex CLI target | Goose CLI/Desktop target | Claude Code/Desktop Code target | Copilot 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`) | `platforms/goose/skills/neuralengine/SKILL.md` (controlled copy; install target is `.agents/skills/neuralengine/SKILL.md`) | `platforms/claude/skills/neuralengine/SKILL.md` (controlled copy; install target is `.claude/skills/neuralengine/SKILL.md`) | `platforms/copilot/skills/neuralengine/SKILL.md` (controlled copy; install target is `.github/skills/neuralengine/SKILL.md`) |
| `shared/repository-review.md` | repository-review skill | not mapped in this slice | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/python-validation.md` | python-project-validation skill | not mapped in this slice | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/arch-linux.md` | arch-linux-diagnostics skill | not mapped in this slice | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/verification.md` | verification skill (Quick, Standard, and Certification implemented) | not mapped in this slice | not mapped in this slice | not mapped in this slice | not mapped in this slice |
| `shared/task-execution-policy.md` | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) | no platform copy (vocabulary contract, deferred consumption) |

## Platform-specific files (no shared equivalent)

Expand All @@ -22,6 +22,7 @@
- `codex/AGENTS.md`
- `goose/AGENTS.md`
- `claude/CLAUDE.md`
- `copilot/README.md`

These files are platform-specific configuration artifacts. They have no
corresponding shared source in this pack.
Expand Down
6 changes: 4 additions & 2 deletions agent-pack/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ repository—not a separate product.
- One bounded Codex CLI NeuralEngine skill projection.
- One bounded Goose CLI/Desktop NeuralEngine skill projection.
- One bounded Claude Code/Desktop Code NeuralEngine skill projection.
- One bounded GitHub Copilot CLI NeuralEngine skill projection.
- Placeholder directory for future Antigravity platform variants.

This pack does not modify NeuralEngine runtime behavior, Brain persistence,
Expand Down Expand Up @@ -52,6 +53,7 @@ contract and introduces the generic builder agent:
| Codex CLI NeuralEngine slice | Supported with limitations (CLI only) |
| Goose CLI/Desktop NeuralEngine slice | Supported with limitations (bounded post-v1.0 extension) |
| Claude Code/Desktop Code NeuralEngine slice | Supported with limitations (bounded post-v1.0 extension) |
| GitHub Copilot CLI NeuralEngine slice | Supported with limitations (bounded post-v1.0 extension) |
| Antigravity | Placeholder (not implemented) |

Review artifacts:
Expand Down Expand Up @@ -196,8 +198,7 @@ equality, frontmatter integrity, model-name absence, and agent coexistence).
- [DEFINITION-OF-DONE.md](DEFINITION-OF-DONE.md) — Formal v1.0 quality gates.
- [ROADMAP.md](ROADMAP.md) — Milestone roadmap from v0.1.0 to v1.0.0.
- [MANIFEST.md](MANIFEST.md) — Shared-to-platform mapping and update rules.
- [CAPABILITY_MATRIX.md](CAPABILITY_MATRIX.md) — Platform capability matrix (OpenCode, Codex CLI, Goose, and Claude Code/Desktop Code).
- [CAPABILITY_MATRIX.md](CAPABILITY_MATRIX.md) — Platform capability matrix (OpenCode, Codex CLI, Goose, and Claude Code/Desktop Code).
- [CAPABILITY_MATRIX.md](CAPABILITY_MATRIX.md) — Platform capability matrix (OpenCode, Codex CLI, Goose, Claude Code/Desktop Code, and Copilot CLI).
- [DECISIONS/](DECISIONS/) — Architecture Decision Records (ADRs).
- [RELEASE_NOTES_v0.4.0.md](RELEASE_NOTES_v0.4.0.md) — v0.4.0 release notes.
- [RELEASE_NOTES_v0.3.0.md](RELEASE_NOTES_v0.3.0.md) — v0.3.0 release notes.
Expand All @@ -218,6 +219,7 @@ Platform implementations:
- [platforms/codex/](platforms/codex/) — Codex CLI NeuralEngine adapter slice.
- [platforms/goose/](platforms/goose/) — Goose CLI/Desktop NeuralEngine adapter slice.
- [platforms/claude/](platforms/claude/) — Claude Code/Desktop Code NeuralEngine adapter slice.
- [platforms/copilot/](platforms/copilot/) — GitHub Copilot 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
Loading