Skip to content

devia is for every agent - #5

Merged
schneiderjoseph merged 1 commit into
mainfrom
devia-for-every-agent
Sep 9, 2026
Merged

schneiderjoseph merged 1 commit into
mainfrom
devia-for-every-agent

Conversation

@schneiderjoseph

@schneiderjoseph schneiderjoseph commented Sep 9, 2026

Copy link
Copy Markdown
Owner

0.2.0 shipped --global serving Claude Code alone. Two of the four SKIP reasons were wrong: they stated an absence that had never been verified. Checking the machine instead of assuming:

  • ~/.cursor/rules/ exists and holds user-level .mdc rules, with the same frontmatter the devia adapter already ships
  • ~/.codex/skills/ uses the same SKILL.md convention as Claude Code
  • ~/.gemini/GEMINI.md is a single global instruction file

So --global now writes, each in the format the agent actually reads: the skill pack for Claude Code and Codex, the rules adapter for Cursor, the universal contract for Gemini. CLAUDE_CONFIG_DIR and CODEX_HOME are honoured.

Copilot and Windsurf still report SKIP with the reason -- their user-level configuration is editor settings rather than a file devia can place -- and that is now debt D8 with what must be established before building, not a silent omission.

Ownership decides how a path is written. A directory the agent owns (~/.claude/skills, ~/.codex/skills, /.cursor/rules) is added to freely. A file the user owns (/.gemini/GEMINI.md) is written only when absent or empty; otherwise SKIP says why and the content stays. --force overrides both and names every path it took.

Registries, recorded with the tool itself:

  • G6 opened and closed: devia is for every agent, no agent is privileged
  • D8 opened: no user-level install for Copilot and Windsurf
  • 01_ARCHITECTURE carries the decision, so a future surface serving one agent has to say why the others are not served

Version: package 0.3.0, standard unchanged at 0.1.0.

Verified: 33 tests with and without FORCE_COLOR, including one that writes into a temporary home and asserts a plain install touches nothing outside the repository, that each agent receives its own format, and that an edited file survives without --force. validate clean, check P0 clear, memory validate clean.

Summary

Type

Devia compliance

  • Rules touched (IDs):
  • New rule? source cited, severity, priority, validation method:
  • Breaking for adopters? (rule id, .devia/ layout, CLI contract):
  • CHANGELOG.md updated:
  • Generated files rebuilt (npm run build:index):

Checks

  • npm run validate passes
  • npm test passes
  • node bin/devia.mjs check --root . passes
  • devia init still produces a valid project (devia validate clean in a scratch repo)

Not verified

0.2.0 shipped --global serving Claude Code alone. Two of the four SKIP reasons
were wrong: they stated an absence that had never been verified. Checking the
machine instead of assuming:

- ~/.cursor/rules/ exists and holds user-level .mdc rules, with the same
  frontmatter the devia adapter already ships
- ~/.codex/skills/ uses the same SKILL.md convention as Claude Code
- ~/.gemini/GEMINI.md is a single global instruction file

So --global now writes, each in the format the agent actually reads: the skill
pack for Claude Code and Codex, the rules adapter for Cursor, the universal
contract for Gemini. CLAUDE_CONFIG_DIR and CODEX_HOME are honoured.

Copilot and Windsurf still report SKIP with the reason -- their user-level
configuration is editor settings rather than a file devia can place -- and that
is now debt D8 with what must be established before building, not a silent
omission.

Ownership decides how a path is written. A directory the agent owns
(~/.claude/skills, ~/.codex/skills, ~/.cursor/rules) is added to freely. A file
the user owns (~/.gemini/GEMINI.md) is written only when absent or empty;
otherwise SKIP says why and the content stays. --force overrides both and names
every path it took.

Registries, recorded with the tool itself:
- G6 opened and closed: devia is for every agent, no agent is privileged
- D8 opened: no user-level install for Copilot and Windsurf
- 01_ARCHITECTURE carries the decision, so a future surface serving one agent
  has to say why the others are not served

Version: package 0.3.0, standard unchanged at 0.1.0.

Verified: 33 tests with and without FORCE_COLOR, including one that writes into
a temporary home and asserts a plain install touches nothing outside the
repository, that each agent receives its own format, and that an edited file
survives without --force. validate clean, check P0 clear, memory validate clean.
@schneiderjoseph
schneiderjoseph merged commit 937d681 into main Sep 9, 2026
4 checks passed
@schneiderjoseph
schneiderjoseph deleted the devia-for-every-agent branch September 14, 2026 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant