Final phase of agent substrate v1. 5 shipped agents now declare role at manifest level; assembler expands role's capability text fragments into the generated .md at a new `# AGENT SUBSTRATE — role <name>` section. Non-migrated agents byte-identical (golden snapshots green). Migrated agents: - kei-code-implementer → edit-local (8 caps: no-git-ops + scope/* + quality/* + safety::no-dep-bump + report-format) - kei-critic → read-only (tools::read-only + output::report-format + output::severity-grade) - kei-architect → read-only - kei-security-auditor → read-only - kei-validator → read-only _assembler/ extensions: - manifest.rs: substrate_role: Option<String> - assembler.rs: write_substrate() before blocks (backward-compat; no role = no substrate section) - substrate.rs (new, 102 LOC): loads _roles/<name>.toml, iterates capabilities.required, reads _capabilities/<cat>/<slug>/text.md, joins with \n\n---\n\n separator - validator.rs: substrate role existence + cap-text presence check - tests/substrate_role.rs (4 tests): happy path, unknown role, missing capability text, byte-parity on non-migrated - tests/regenerate_migrated.rs (ignored by default): regeneration gate _templates/task-examples/ — 5 example task.toml per migrated agent showing orchestrator the valid invocation shape. docs/AGENT-SUBSTRATE-SCHEMA.md: Phase 5 row ticked ✓ + Migrated agents subsection listing 5 agents with roles + pointer to examples. tests/substrate_integration.sh: +8 Phase-5 assertions - All 5 migrated .md files contain "# AGENT SUBSTRATE — role" - kei-code-implementer.md contains "MUST NOT invoke git" (policy::no-git-ops) - Every _templates/task-examples/*.toml parses as valid TOML - cargo check --workspace still passes post-migration - kei-agent-runtime compose works on edit-local-forge.toml example Tests: assembler 40/40 (was 30, +4 substrate_role + +1 ignored regen), kei-agent-runtime + kei-capability 37/37 preserved. Deferred: remaining 7 non-core agents (cost-guardian, modal-runner, fal-ai-runner, infra/ml-implementer, ml-researcher, researcher) migrate in v0.24 wave. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
44 lines
1.2 KiB
TOML
44 lines
1.2 KiB
TOML
# Example task.toml — read-only role for kei-critic.
|
|
# Read-only tasks only parameterise scope paths (for reference) and the
|
|
# required output fields. No cargo-check/test crates because read-only
|
|
# role lacks the tools::cargo-only-bash capability.
|
|
|
|
[task]
|
|
role = "read-only"
|
|
agent-id = "read-only-critic-EXAMPLE"
|
|
parent-agent = ""
|
|
|
|
[scope]
|
|
# Whitelist reads — substrate gate still denies Edit/Write globally, but
|
|
# the agent uses these globs to focus its inspection.
|
|
files-whitelist = [
|
|
"**/*.rs",
|
|
]
|
|
files-denylist = [
|
|
"**/target/**",
|
|
"**/generated/**",
|
|
]
|
|
|
|
[verification]
|
|
# Read-only pass — no cargo crates to verify. Left empty on purpose.
|
|
cargo-check-crates = []
|
|
cargo-test-crates = []
|
|
|
|
[output]
|
|
# Parameterises output::report-format + output::severity-grade.
|
|
report-fields-required = [
|
|
"findings-count",
|
|
"per-finding",
|
|
"severity-sort",
|
|
"categories",
|
|
]
|
|
|
|
[body]
|
|
text = """
|
|
Sweep the Rust workspace for anti-patterns, god objects, circular
|
|
imports, and Constructor-Pattern violations (files > 200 LOC,
|
|
functions > 30 LOC). Every finding must carry a [HIGH|MEDIUM|LOW]
|
|
severity grade (output::severity-grade) and a file:line citation.
|
|
No fixes — report only; the orchestrator will route edits to
|
|
kei-code-implementer.
|
|
"""
|