docs(kiro): refresh verified_on dates for Kiro 1.28.3 -> 2.0.1 (no code changes) - #760
Conversation
…de changes) Closes #751. Triage of Kiro CLI 1.28.3 -> 2.0.1 (major version bump, Apr 13/16, 2026). Re-verified all 51 Kiro rules against the upstream changelog at https://kiro.dev/changelog/cli/ and the relevant docs pages. The 1.28 -> 2.0 jump was platform expansion - none of these add fields to any of the 5 Kiro file types agnix validates: - Windows native support (config format identical across platforms) - Headless mode + KIRO_API_KEY env var (env var, not a config field) - --no-interactive / --trust-all-tools / --trust-tools (CLI flags only) - TUI as default (chat.ui is global settings, not .kiro/agents/*.json) - Granular Tool Trust (runtime trust picker, no persistent config) - Session Settings Tool (in-memory overrides, doesn't write config) - Simplified Agent Creation (uses existing schema fields) - Subagent task dependencies (runtime scheduling, no new JSON fields) Verified two ambiguous changelog mentions against kiro.dev/docs/cli/custom-agents/configuration-reference: - availableAgents / trustedAgents (v1.25 subagent access control): NOT documented in agent JSON fields. Likely global settings. - knowledgeIndex resource type (v1.23/v1.24 Knowledge Index): only knowledgeBase remains documented as a valid resource type. No code changes required - this is a pure doc refresh. Documentation: - Bumped verified_on to 2026-04-22 for all 51 Kiro rules (KIRO-* steering, KR-AG-* agents, KR-HK-* hooks, KR-MCP-* MCP, KR-PW-* powers, KR-SK-* skills) in knowledge-base/rules.json and synced crates/agnix-rules/rules.json - Bumped RESEARCH-TRACKING.md \"Last Reviewed\" for Kiro CLI from 2026-02-05 to 2026-04-22 - Added .kiro/powers/*/POWER.md to RESEARCH-TRACKING.md's Config Format column for Kiro - it was missing despite kiro_power.rs existing in agnix-core (KR-PW-001..008) - Regenerated website/docs/rules/generated/*.md Discovered: agnix has FIVE Kiro validators, not four - kiro_power.rs for .kiro/powers/*/POWER.md was undocumented in earlier triage briefings. Memory updated. Verified locally: - cargo clippy --workspace --all-targets --all-features -- -D warnings clean - cargo test -p agnix-rules --tests: 47 + 4 parity tests pass - No source code changed; no new tests needed
There was a problem hiding this comment.
Code Review
This pull request performs a documentation refresh for Kiro CLI (v1.28.3 to v2.0.1), re-verifying 51 rules across categories such as Steering, Agents, Hooks, MCP, Powers, and Skills. The changes primarily involve updating verification dates in rules.json and rule documentation files, as well as refining the RESEARCH-TRACKING.md file. A suggestion was made to update the "Rules" column in RESEARCH-TRACKING.md for Kiro CLI to include specific rule prefixes for consistency with other tools in the list.
| | Codex CLI | `AGENTS.md`, `codex.toml` | https://developers.openai.com/codex/ | Automated (spec-drift.yml + tool-release-watch.yml) | Weekly | 2026-04-22 | AGM, XP | | ||
| | OpenCode | `AGENTS.md`, `.opencode/config.json` | https://opencode.ai/docs/ | Automated (spec-drift.yml + tool-release-watch.yml) | Weekly | 2026-04-22 | AGM, XP | | ||
| | Kiro CLI | `.kiro/steering/*.md`, `.kiro/agents/*.json`, `.kiro/hooks/*.kiro.hook`, `.kiro/settings/mcp.json` | https://kiro.dev/changelog/cli/ | Automated (tool-release-watch.yml via HTML scrape) | Quarterly | 2026-02-05 | -- | | ||
| | Kiro CLI | `.kiro/steering/*.md`, `.kiro/agents/*.json`, `.kiro/hooks/*.kiro.hook`, `.kiro/settings/mcp.json`, `.kiro/powers/*/POWER.md` | https://kiro.dev/changelog/cli/ | Automated (tool-release-watch.yml via HTML scrape) | Quarterly | 2026-04-22 | -- | |
There was a problem hiding this comment.
The "Rules" column for Kiro CLI is currently set to --, while other tools in the table list their respective rule categories or prefixes (e.g., CC-SK, AGM). Since this PR re-verified 51 Kiro rules across multiple categories (Steering, Agents, Hooks, MCP, Powers, and Skills), updating this column with the relevant prefixes would improve the consistency and utility of the tracking document.
| | Kiro CLI | `.kiro/steering/*.md`, `.kiro/agents/*.json`, `.kiro/hooks/*.kiro.hook`, `.kiro/settings/mcp.json`, `.kiro/powers/*/POWER.md` | https://kiro.dev/changelog/cli/ | Automated (tool-release-watch.yml via HTML scrape) | Quarterly | 2026-04-22 | -- | | |
| | Kiro CLI | .kiro/steering/*.md, .kiro/agents/*.json, .kiro/hooks/*.kiro.hook, .kiro/settings/mcp.json, .kiro/powers/*/POWER.md | https://kiro.dev/changelog/cli/ | Automated (tool-release-watch.yml via HTML scrape) | Quarterly | 2026-04-22 | KIRO, KR-AG, KR-HK, KR-MCP, KR-PW, KR-SK | |
There was a problem hiding this comment.
Pull request overview
Updates the Kiro CLI triage baseline documentation to reflect re-verification against Kiro CLI 2.0.1, without changing any validator logic in the codebase.
Changes:
- Bumped
verified_onto2026-04-22for all Kiro-related rules inknowledge-base/rules.jsonandcrates/agnix-rules/rules.json. - Regenerated
website/docs/rules/generated/*.mdfor all Kiro rule pages to reflect the updated verification date. - Updated
knowledge-base/RESEARCH-TRACKING.mdto include.kiro/powers/*/POWER.mdand refreshed Kiro’s “Last Reviewed” date; added a detailed Unreleased changelog entry describing the triage.
Reviewed changes
Copilot reviewed 4 out of 55 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| website/docs/rules/generated/kiro-001.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-002.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-003.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-004.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-005.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-006.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-007.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-008.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-009.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-010.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-011.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-012.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-013.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kiro-014.md | Update Kiro rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-001.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-002.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-003.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-004.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-005.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-006.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-007.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-008.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-009.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-010.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-011.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-012.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-ag-013.md | Update Kiro agents rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-001.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-002.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-003.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-004.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-005.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-006.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-007.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-008.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-009.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-hk-010.md | Update Kiro hooks rule doc Verified On date. |
| website/docs/rules/generated/kr-mcp-001.md | Update Kiro MCP rule doc Verified On date. |
| website/docs/rules/generated/kr-mcp-002.md | Update Kiro MCP rule doc Verified On date. |
| website/docs/rules/generated/kr-mcp-003.md | Update Kiro MCP rule doc Verified On date. |
| website/docs/rules/generated/kr-mcp-004.md | Update Kiro MCP rule doc Verified On date. |
| website/docs/rules/generated/kr-mcp-005.md | Update Kiro MCP rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-001.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-002.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-003.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-004.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-005.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-006.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-007.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-pw-008.md | Update Kiro powers rule doc Verified On date. |
| website/docs/rules/generated/kr-sk-001.md | Update Kiro skills rule doc Verified On date. |
| knowledge-base/rules.json | Refresh verified_on for all Kiro rules (KB source-of-truth). |
| crates/agnix-rules/rules.json | Refresh verified_on for all Kiro rules (packaged rules mirror). |
| knowledge-base/RESEARCH-TRACKING.md | Update Kiro “Last Reviewed” and add .kiro/powers/*/POWER.md to tracked formats. |
| CHANGELOG.md | Document the Kiro CLI 2.0.1 triage/doc refresh in Unreleased. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| ### Changed |
There was a problem hiding this comment.
CHANGELOG.md now has two separate ### Changed sections under [Unreleased]. This breaks the Keep-a-Changelog structure and makes entries harder to scan; please merge the Kiro CLI bullet into the existing ### Changed section (or rename one of the headings to the intended category).
| ### Changed |
|
Per-comment reply table for round 1
Pushing now. |
Reviewer feedback (PR #760 round 1): - Gemini: RESEARCH-TRACKING.md Kiro 'Rules' column was '--' while other tools list their rule prefixes. Filled in the actual prefixes (KIRO, KR-AG, KR-HK, KR-MCP, KR-PW, KR-SK) for parity with the rest of the table. - Copilot: CHANGELOG.md had two separate '### Changed' sections under [Unreleased]. Merged the new Kiro entry into the existing '### Changed' section to preserve Keep-a-Changelog structure.
Summary
Triage of Kiro CLI 1.28.3 -> 2.0.1 (issue #751, major version bump Apr 13/16, 2026). After re-verifying all 51 Kiro rules against the upstream changelog and docs, no code changes are required — this is a pure doc refresh.
Why no code changes
The 1.28 -> 2.0 jump was platform expansion. None of these add fields to any of the 5 Kiro file types agnix validates:
KIRO_API_KEYenv var--no-interactive/--trust-all-tools/--trust-toolschat.uiis global settings, not.kiro/agents/*.jsonTwo ambiguous changelog mentions verified against docs
availableAgents/trustedAgentskiro.dev/docs/cli/custom-agents/configuration-reference. Likely global settings.knowledgeIndexresource typeknowledgeBaseremains a valid resource type.Both verified by direct WebFetch on the upstream configuration reference page.
Doc updates
knowledge-base/rules.jsonandcrates/agnix-rules/rules.json: bumpedverified_onto2026-04-22for all 51 Kiro rules (KIRO-* steering, KR-AG-* agents, KR-HK-* hooks, KR-MCP-* MCP, KR-PW-* powers, KR-SK-* skills)knowledge-base/RESEARCH-TRACKING.md:.kiro/powers/*/POWER.mdto the Config Format column (it was missing despite agnix havingkiro_power.rswith KR-PW-001..008)website/docs/rules/generated/*.md(forced bydocs_website_paritytest)Discovery
agnix has FIVE Kiro validators, not four.
kiro_power.rs(.kiro/powers/*/POWER.md, KR-PW-001..008) was undocumented in earlier triage briefings. Memory updated for future triages.ToolVersions
ToolVersionsstruct has nokirofield; Kiro validators perform no version-aware branching. Nothing to bump.Test plan
cargo test -p agnix-rules --tests: 47 + 4 parity tests pass (rules.json byte-equality + VALIDATION-RULES.md parity)cargo clippy --workspace --all-targets --all-features -- -D warningscleanCloses #751.