| name | agent-convention-sync |
| description | Seek out and update agent discovery files as conventions evolve. Use when agent ecosystems add new ways to state behavior, skills, or rules; when discovery files need revision; or when maintaining FOR_AGENTS.md, .cursorrules, docs/for-agents.md, docs/agent-discovery.md. |
Agent Convention Sync — HALOS
Keep HALOS agent discovery files current as coding tools and agent frameworks evolve.
When to Use This Skill
- User asks to update or add agent discovery/convention files
- User mentions new agent tools (e.g., Aider, Continue, Bolt, v0) or conventions (e.g.,
.agentrules, AI_CONTEXT.md)
- Discovery files may be out of date
- Proposal or discussion about how agents discover HALOS
Current Discovery Files
| File | Purpose |
|---|
FOR_AGENTS.md | Root-level agent entry point |
.cursorrules | Legacy Cursor config |
AGENTS.md | Contract and agent definitions |
docs/for-agents.md | Full agent guidelines, discovery table |
docs/agent-discovery.md | Why/how documentation |
spec/manifest.json | Machine-readable discovery |
.cursor/rules/halos-alignment.mdc | Cursor rule (always apply) |
Process for Additions or Revisions
-
Research — Search for new conventions: agent instruction formats, discovery mechanisms, tool-specific config files (e.g., .aider.conf, .continuerc, AI_CONTEXT.md, .well-known/agents/).
-
Propose — For structural changes (new files, new sections), use the proposal process (proposals/). For minor updates (fixing links, wording), edit directly.
-
Update files:
- Add new discovery files if a convention gains adoption and HALOS should be visible there
- Update
docs/for-agents.md discovery table when adding/changing files
- Update
docs/agent-discovery.md "Files Added" and "Maintenance" sections
- Keep
FOR_AGENTS.md as a brief pointer; avoid duplicating full contract
- Keep
.cursorrules minimal (one-line pointer)
-
Canonical sources — The HALOS contract lives in spec/core.json and .cursor/rules/halos-alignment.mdc. Discovery files should point to these, not duplicate them.
-
README — Update the "For AI Agents" section and "Agents" links if new files are added.
Conventions to Watch
- Agent Skills (SKILL.md) — Anthropic/agentskills.io format
- OSSA — Agent manifests,
.ossa.yaml
- Agent Discovery Protocol (ADP) —
.well-known/agents/
- Cursor —
.cursorrules, .cursor/rules/, AGENTS.md
- Aider —
.aider.conf, .aiderignore
- Continue —
.continuerc
- Emerging —
FOR_AI.md, AI_CONTEXT.md, .agentrules, AGENT_INSTRUCTIONS.md
When a convention becomes widely used, consider adding a HALOS pointer in that format. When obsolete, mark deprecated in docs but avoid breaking existing users.
Related Docs
