mirror of
https://github.com/ruvnet/ruflo.git
synced 2026-09-28 06:22:58 +08:00
ADR-386 shipped the capability but the guidance still describes the old world: the open-federation skill has no channels at all and never names the canonical relay, and the gateway README and plugin manifest list a tool surface that is now three tools short. open-federation gains a Channels section with the two visibilities, the CLI verbs, and the three things worth saying before anyone trusts a private channel: metadata is not hidden, there is no revocation, and losing the key file loses the channel. It also records the tag trap — buzz-relay enforces NIP-29 group membership on `h`, so an h-tagged event publishes and then cannot be read back, which is why ruflo channels use `c`. claims gains a short section on scoping a claim stream to a channel, with the caveat that matters: a claim nobody outside the channel can read cannot arbitrate against one made outside it, so swarm-wide ownership stays on the open stream. Verified: marketplace validation passes over all 39 plugins, the manifest audit exits 0, and both skills still parse their frontmatter. Claude-Session: https://claude.ai/code/session_013u4pmL9ZUAXb6usVQgNo67
.agents Directory
This directory contains agent configuration and skills for OpenAI Codex CLI.
Structure
.agents/
config.toml # Main configuration file
skills/ # Skill definitions
skill-name/
SKILL.md # Skill instructions
scripts/ # Optional scripts
docs/ # Optional documentation
README.md # This file
Configuration
The config.toml file controls:
- Model selection
- Approval policies
- Sandbox modes
- MCP server connections
- Skills configuration
Skills
Skills are invoked using $skill-name syntax. Each skill has:
- YAML frontmatter with metadata
- Trigger and skip conditions
- Commands and examples
Documentation
- Main instructions:
AGENTS.md(project root) - Local overrides:
.codex/AGENTS.override.md(gitignored) - Claude Flow: https://github.com/ruvnet/claude-flow