Skip to content

docs(kiro): refresh verified_on dates for Kiro 1.28.3 -> 2.0.1 (no code changes) - #760

Merged
avifenesh merged 2 commits into
mainfrom
chore/triage-kiro-2-0-1
Apr 23, 2026
Merged

docs(kiro): refresh verified_on dates for Kiro 1.28.3 -> 2.0.1 (no code changes)#760
avifenesh merged 2 commits into
mainfrom
chore/triage-kiro-2-0-1

Conversation

@avifenesh

Copy link
Copy Markdown
Collaborator

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:

v2.0 feature Why no agnix impact
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; not persisted to config files
TUI as default chat.ui is global settings, not .kiro/agents/*.json
Granular Tool Trust (v1.27) Runtime trust picker; no persistent config
Session Settings Tool (v1.27) In-memory overrides; doesn't write config
Simplified Agent Creation (v1.27) Uses existing schema fields
Subagent task dependencies Runtime scheduling; no new JSON fields

Two ambiguous changelog mentions verified against docs

Candidate Source Verdict
availableAgents / trustedAgents v1.25 subagent access control NOT in agent JSON fields per kiro.dev/docs/cli/custom-agents/configuration-reference. Likely global settings.
knowledgeIndex resource type v1.23/v1.24 Knowledge Index NOT documented. Only knowledgeBase remains a valid resource type.

Both verified by direct WebFetch on the upstream configuration reference page.

Doc updates

  • knowledge-base/rules.json and crates/agnix-rules/rules.json: 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)
  • knowledge-base/RESEARCH-TRACKING.md:
    • Bumped Kiro CLI "Last Reviewed" 2026-02-05 -> 2026-04-22
    • Added .kiro/powers/*/POWER.md to the Config Format column (it was missing despite agnix having kiro_power.rs with KR-PW-001..008)
  • Regenerated website/docs/rules/generated/*.md (forced by docs_website_parity test)

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

ToolVersions struct has no kiro field; 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 warnings clean
  • No source code changed, so no new tests needed
  • CI: Verify Changelog
  • CI: Security Audit
  • CI: Tests
  • CI: claude-review

Closes #751.

…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
Copilot AI review requested due to automatic review settings April 23, 2026 01:44

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.

Comment thread knowledge-base/RESEARCH-TRACKING.md Outdated
| 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 | -- |

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

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.

Suggested change
| 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 |

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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_on to 2026-04-22 for all Kiro-related rules in knowledge-base/rules.json and crates/agnix-rules/rules.json.
  • Regenerated website/docs/rules/generated/*.md for all Kiro rule pages to reflect the updated verification date.
  • Updated knowledge-base/RESEARCH-TRACKING.md to include .kiro/powers/*/POWER.md and 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.

Comment thread CHANGELOG.md Outdated
Comment on lines +22 to +23

### Changed

Copilot AI Apr 23, 2026

Copy link

Choose a reason for hiding this comment

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

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).

Suggested change
### Changed

Copilot uses AI. Check for mistakes.
@avifenesh

Copy link
Copy Markdown
Collaborator Author

Per-comment reply table for round 1

# Reviewer File Status Resolution
1 Gemini RESEARCH-TRACKING.md:22 (Kiro Rules column was `--`) Fixed Filled in the actual rule prefixes: `KIRO, KR-AG, KR-HK, KR-MCP, KR-PW, KR-SK`. Matches the same convention as the other tools' rows in the table.
2 Copilot CHANGELOG.md:23 (two `### Changed` sections under [Unreleased]) Fixed Merged the new Kiro entry into the existing `### Changed` section. No more duplicate heading. Keep-a-Changelog structure preserved.

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.
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.

Tool release: Kiro CLI 2.0.1 (was 1.28.3)

2 participants