jazzyalex / agent-support-matrix

Agent Support Matrix

Overview

Keep the support matrix and memory bank accurate, and gate updates with evidence so parsing
regressions are avoided.

Quick Start

1. Read docs/agent-support/workflow.md.
2. Run the session-format check and read results.<agent>.compatibility.
3. Compare latest available agent versions to docs/agent-support/agent-support-matrix.yml.

4. If gaps exist, run an impact scan, collect evidence, and update fixtures/tests before
   bumping max_verified_version.

Workflow

• Determine the current Agent Sessions version from AgentSessions.xcodeproj/project.pbxproj
MARKETING_VERSION.

• Run ./scripts/agent_watch.py --mode weekly and use compatibility.verdict as the
  support answer. severity and recommendation are legacy escalation fields, not
  support claims.

• Use references/impact-scan.md to inspect upstream releases for format changes.
• Follow references/update-checklist.md before updating docs or fixtures.

Guardrails

• Do not bump max_verified_version without fixtures or sample logs plus passing parser tests.

• Do not bump max_verified_version unless results.<agent>.compatibility.verdict is
  supports_latest, or the update explicitly records a narrower scope such as
  supports_installed_only with a blocker and follow-up.

• If an agent does not log a version, keep max_verified_version: "unknown" and document
  verification scope in docs/agent-json-tracking.md.

References

• references/matrix-schema.md for matrix fields and update rules.
• references/impact-scan.md for format change detection heuristics.
• references/update-checklist.md for the evidence checklist.

Related Skills

• agent-session-format-check — detection and evidence collection for session format
  drift, usage/limits tracking changes, OpenCode storage backend shifts, and discovery
  path contract failures. Use that skill for monitoring and diagnosis; use this skill
  for recording and gating version bumps.