Skip to content

docs(readme): restructure the support matrix into a presence overview - #1710

Merged
dyoshikawa merged 2 commits into
dyoshikawa:mainfrom
saitota:improve-supported-tools-table
Jun 2, 2026
Merged

docs(readme): restructure the support matrix into a presence overview#1710
dyoshikawa merged 2 commits into
dyoshikawa:mainfrom
saitota:improve-supported-tools-table

Conversation

@saitota

@saitota saitota commented May 26, 2026

Copy link
Copy Markdown
Contributor

Summary

The single dense matrix was hard to read, so I tried restructuring it. Sharing as a proposal — please judge whether it's worth merging.

  • Reduced it to a presence overview (✅ / blank): readers first want to know "is my tool supported?", not the full scope breakdown.
  • Split AI Coding Tools from Open Standards (AGENTS.md, Agent Skills).
  • Moved --targets values and mode details (project / global / simulated) to the Supported Tools reference, which already has that table.
  • Kept the ⚠️ Deprecated markers and the Deprecation notes section as-is.

Note

The matrix was missing 3 entries the code already supports. Synced both README.md and docs/reference/supported-tools.md to the implementation: kilo × subagents/hooks, kiro × hooks.

If this table is updated by any automated/agentic flow when adding a tool, let me know — I'd like to avoid breaking that.

Test plan

  • Overview matches the feature → tool registries in src/features/*/ (29 targets incl. open standards)
  • oxfmt --check / cspell

@saitota
saitota force-pushed the improve-supported-tools-table branch from 88cc256 to 0b4dee7 Compare May 26, 2026 16:10

@dyoshikawa dyoshikawa left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for taking this on — the dense matrix really was hard to scan, and the presence-overview idea reads a lot better. The Kilo subagents/hooks correction is a genuine find too.

A couple of things to sort before this can merge. The branch is based on an older main, so as-is it reverts the Antigravity 2.0 split (antigravity-ide / antigravity-cli) and drops the deprecation markers — a rebase should clear that up. The bigger open question is AGENTS.md and AgentsSkills: the description says they moved into an Open Standards section, but that table isn't in the diff, so right now they just disappear. And since you're correcting Kilo, docs/reference/supported-tools.md needs the same edit to stay in sync.

On the design call itself, dropping the project/global/simulated nuance from the README in favor of the reference link is reasonable, but that's a maintainer judgement — I'd let dyoshikawa weigh in on losing the at-a-glance mode info. Left a few inline notes on the specific spots.

Comment thread README.md Outdated
| Takt | ✅ | | | ✅ | ✅ | ✅ | | |
| Qwen Code | ✅ | ✅ | | | | | | ✅ |
| Kiro | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Google Antigravity | ✅ | | | ✅ | | ✅ | | |

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This branch looks like it's based on an older main. Since the merge base, main split Antigravity into antigravity-ide and antigravity-cli (Antigravity 2.0), and both support mcp and hooks. Collapsing them back into a single "Google Antigravity" row with mcp/hooks blank drops two rows and reads as a regression against current main. The ⚠️ deprecation markers on Gemini CLI and Antigravity also disappear here. Could you rebase on latest main and re-derive the table from the current one?

Comment thread README.md Outdated
- 🔧: Supports MCP tool config (`enabledTools`/`disabledTools`)
The table below shows whether each tool supports a given feature (✅ = supported, blank = not supported). For each tool's `--targets` value and mode details (project / global / simulated), see the [Supported Tools reference](https://rulesync.dyoshikawa.com/reference/supported-tools).

| Tool | rules | ignore | mcp | commands | subagents | skills | hooks | permissions |

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description mentions splitting AI Coding Tools from Open Standards (AGENTS.md, Agent Skills), but I don't see an Open Standards table in the diff — the agentsmd and agentsskills rows are just removed. Both are still valid --targets (src/types/tool-targets.ts) and present in the docs reference table, so they vanish from the README entirely. Could you add the Open Standards table you mentioned, or keep these two in the matrix?

Comment thread README.md Outdated
| Factory Droid | ✅ | | ✅ | ✅ | ✅ | ✅ | ✅ | |
| OpenCode | ✅ | | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Cline | ✅ | ✅ | ✅ | ✅ | | ✅ | | ✅ |
| Kilo Code | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Marking Kilo subagents/hooks as ✅ is correct — KiloSubagent and KiloHooks are both registered, so the README was genuinely lagging here. Nice catch. One follow-up: docs/reference/supported-tools.md still shows these blank, and the project guidelines ask for README and docs to stay in sync, so it'd be good to update that file in the same PR.

Repository owner deleted a comment from dyoshikawa May 28, 2026
@saitota
saitota force-pushed the improve-supported-tools-table branch from 0b4dee7 to 641f602 Compare May 29, 2026 02:45
@saitota

saitota commented May 29, 2026

Copy link
Copy Markdown
Contributor Author

Thanks for the review! Addressed all three:

  • Rebased onto latest main
  • Restored the Open Standards table (AGENTS.md, Agent Skills) to match the PR description.
  • Synced docs/reference/supported-tools.md with the same kilo × subagents/hooks correction.

Split the dense matrix into AI Coding Tools / Open Standards presence tables (✅ / blank), and link to the Supported Tools reference for --targets values and project/global/simulated mode details.
Resolve README.md conflict by keeping the presence-overview restructuring.
The overview already reflects the latest data; Kilo Code (subagents/hooks)
and Kiro (hooks) markers match the processors and the merged reference table.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dyoshikawa
dyoshikawa merged commit 7bbdcc0 into dyoshikawa:main Jun 2, 2026
1 check passed
@dyoshikawa

Copy link
Copy Markdown
Owner

@saitota Thank you!

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.

2 participants