Repository navigation
spectra init --agent: install for 8 more AI agents (additive, Claude unchanged) - #63
Merged
Merged
Conversation
Every file spectra init writes without --agent, by path and line-ending-normalised SHA-256 (fresh workspace, and over a user's existing .claude/settings.json). The skills manifest's recorded hashes are verified against the files on disk and masked, so the pin holds on Windows and Linux checkouts alike.
New emitter layer (src/Spectra.CLI/Install/) used only for non-Claude agents: copilot, cursor, devin (windsurf), codex, gemini, antigravity (agy), kiro, opencode, plus `auto` detection, with BELLATRIX Agent's names and markers. - NeutralContent: the bundled skills/references/subagents transformed at emit time (neutral wording, Claude tools key dropped, name = folder, quoted YAML); the embedded source is untouched. - One AgentTarget per provider: native always-on fragment (or one marker block in AGENTS.md / GEMINI.md), skills dir, the 6 subagents in native format and tool names, documented allowlists only (Cursor, Devin, OpenCode). - AgentInstaller: set-cover skill dirs (.claude/skills reused when present), R6 hash gate with .spectra/manifest.<agent>.json, --regenerate, retiring unedited files, --dry-run. - InitHandler: only an installClaude = true guard on the two Claude-only calls; init without --agent is byte-identical (golden) and prints one notice line.
…LATRIX - Golden/104/agent-<name>.txt per agent and agent-all.txt; --agent claude is byte-identical to plain init; the Claude files are unchanged in an all-agents install. - Re-runs (plain and per-agent --regenerate) are byte-stable; user edits are skipped unless --regenerate; retired files only when unedited. - Aliases (windsurf, agy), usage errors, auto-detect, --dry-run writes nothing, --skip-skills, AGENTS.md/GEMINI.md human bytes kept (R1), allowlists merged by key, R8 namespace. - BELLATRIX coexistence in both orders against a recorded fixture of bellatrix init 3.1.1 (all 9 agents, web), plus live variants when bellatrix is on PATH.
- README, getting-started, skills-integration, cli-reference: `spectra init --agent`, the per-agent table (instructions, skills, subagents, delegation, allowlist), re-runs/--regenerate, BELLATRIX coexistence, update-skills note, and the known limitation (critic isolation is platform-enforced only in Claude Code; a CLI-enforced critic gate is planned). - New docs/live-verification-agents.md: per-agent checklist (scaffold, skills visible, one generate run, critic invoked) and a results table. - CHANGELOG 2.7.0; Directory.Build.props 2.7.0; CLAUDE.md row 104. - The plain-init notice is printed in human output only, so JSON-mode output (and the 099 golden) is unchanged. - Docs/source guards: GitHub Copilot as an `--agent` install target is not the removed SDK (explicit allow-list lines; paragraphs naming the option or the other agents).
There was a problem hiding this comment.
Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.
An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
spectra init --agent <list>installs SPECTRA's skills, subagents and always-on instructions for eight more AI agents:copilot,cursor,devin(aliaswindsurf),codex,gemini,antigravity(aliasagy),kiroandopencode.--agent autodetects them the way BELLATRIX Agent does.--regenerateoverwrites files you edited, and--dry-runwrites nothing and prints the plan. Version 2.7.0.The change is additive. The new layer lives in
src/Spectra.CLI/Install/and is used only for the non-Claude agents.Golden rule: the Claude install is unchanged
spectra initwithout--agentbehaves exactly as before. The only addition is a one-line stderr notice naming the other agents, and only in human output; JSON mode is unchanged..claude/settings.jsonmerge, same.spectra/skills-manifest.json. No skill, subagent or prompt content for Claude changed, and no workflow logic changed (generation, critic, verdict, repair, review-flagged, execution).installClaude = trueparameter onInitHandler.HandleAsync, which guards the two Claude-only calls. Its default is today's behaviour.tests/Spectra.CLI.Tests/Golden/ClaudeInstallGoldenTests.cspins all 40 files a freshspectra initwrites, plus the merge into an existing.claude/settings.json. It compares each file's path and SHA-256 (line endings normalised). The golden files inGolden/104/were recorded onmainbefore any other change in this branch and pass unchanged on every commit.Provider table
Placement was checked against each provider's official docs on 2026-10-27.
S= the shared fragment.spectra/spectra.instructions.md.--agentcopilot.github/instructions/spectra.instructions.md.github/skills(reuses.claude/skills).github/agents/*.agent.md(reuses.claude/agents)cursor.cursor/rules/spectra.mdc.cursor/skills(reuses.claude/skills/.agents/skills).cursor/agents/*.md.cursor/cli.jsonShell(spectra)devin/windsurf.devin/rules/spectra.md.devin/skills.devin/agents/*.md.devin/config.jsonExec(spectra)codexAGENTS.mdmarker block →S.agents/skills.codex/agents/*.tomlgeminiGEMINI.mdmarker block@./S.agents/skills.gemini/agents/*.mdantigravity/agy.agents/rules/spectra.md.agents/skills.agents/agents/<name>/agent.mdkiro.kiro/steering/spectra.md.kiro/skills.kiro/agents/*.mdopencodeAGENTS.mdmarker block →S(shared with Codex).opencode/skills(reuses.claude/skills/.agents/skills).opencode/agents/*.mdopencode.jsonpermission.bash["spectra *"]All 18 recorded decisions are in
FINDINGS-multi-client-gap-v2.md.Decisions that differ from the brief
--agent,initstays Claude-only, as the golden rule requires. BELLATRIX's detection is available as--agent auto: it uses existing manifests, or exactly one detected agent, and never guesses..spectra/verdicts/critic-verdict-<id>.json, whichingest-verdictreads. A strictly read-only critic would break that, so:readonly: true, which would block the write.["read", "write", "shell"].update-skillsis unchanged and refreshes only the Claude install. Re-runningspectra init --agent <list>refreshes the others. That step is hash-gated, so files you edited are skipped unless you pass--regenerate.spectra init --agent xon a workspace that already hasspectra.config.jsoninstalls only the non-Claude agents. It leaves the config and the Claude files alone; before this change,initrefused there..devin/skills, not.claude/skillsas in BELLATRIX, because Devin's docs list only.github/skillsas an import source for skills.Known limitation: the critic outside Claude Code
Only Claude Code runs a subagent from a skill instruction as an enforced, isolated step. In the other agents, delegation is the model's choice: Codex delegates only when asked, and Gemini on
@nameor by its own choice. The critic therefore runs when the agent follows the skill's instruction. Its isolated-context guarantee is not platform-enforced there. The README and the skills-integration page say so. A CLI-enforced critic gate is planned for a later version.Live verification
The automated tests check every installed file byte for byte. Whether each agent actually loads the files and starts the critic needs a person and a real session. Checklist and results table:
docs/live-verification-agents.md. It has not been run yet.Tests
Golden/104/agent-*.txt)..agents/skillsandAGENTS.md0 written) and--regenerateauto,--dry-run(writes nothing)bellatrix init3.1.1 output (all 9 agents)bellatrixtool when it is on PATH; skipped otherwise🤖 Generated with Claude Code