Skip to content

Docs: multi-platform site + pre-release review fixes#11

Merged
jkyberneees merged 2 commits into
mainfrom
chore/multiplatform-docs-and-review-fixes
Jul 24, 2026
Merged

Docs: multi-platform site + pre-release review fixes#11
jkyberneees merged 2 commits into
mainfrom
chore/multiplatform-docs-and-review-fixes

Conversation

@jkyberneees

Copy link
Copy Markdown
Contributor

Follow-up to #8 and #10: updates the docs site for Gemini CLI / Claude Code support and fixes the findings from a holistic pre-release review of both ports.

Docs & landing

  • docs/index.html — multi-platform metadata/OG/JSON-LD, hero copy, install section now offers all three installer commands with per-platform notes, ecosystem section covers OpenCode + Gemini CLI + Claude Code, agent count 20+ → 21, fixed broken og-image.png reference (now uses existing hero-image.png)
  • docs/intro.html — install slide covers all three platforms, 20+ → 21, platform pill updated

Review fixes

  • Deny-list gap: the OpenCode agents' 10-entry dangerous-command deny list was dropped in both ports. Restored as prompt-level Security: Forbidden Commands guardrails in all 43 agent definitions, enforced by new checks in check_gemini_agents.sh / check_claude_agents.sh; optional platform-level enforcement documented (permissions.deny for Claude Code, policy.toml for Gemini CLI); root README claim qualified per platform
  • Claude Code orchestration: documented CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH: "2" requirement (Claude Code withholds the Agent tool from subagents by default) in claude/README.md, root README, and the installer's post-install message
  • CI: make test-all now runs test-preflight, so the agent lints actually execute in CI
  • Installers: --dry-run latest no longer performs live GitHub API calls (all three scripts)
  • Version drift: gemini/agents/engineering-team.md H1 v1.0v1.2.2

Verified: all three agent lints pass, bash -n clean on all installers, dry-run smoke-tested with a curl stub (zero network calls), make test-preflight green.

Release-day note

The README's pinned v1.2.2 install examples will keep 404ing for claude/gemini until either the new tag is cut and the examples are bumped, or kai-claude-v1.2.2.zip / kai-gemini-v1.2.2.zip assets are backfilled onto the existing v1.2.2 release.

- index.html: multi-platform metadata/OG/JSON-LD, hero copy, three
  installer commands in the install section, ecosystem section now
  covers OpenCode + Gemini CLI + Claude Code, agent count 20+ -> 21,
  fix broken og-image.png reference (use existing hero-image.png)
- intro.html: install slide covers all three platforms, agent count
  20+ -> 21, platform pill updated, platform-neutral demo string
Security:
- Port the 10-entry dangerous-command deny list as prompt-level
  'Security: Forbidden Commands' guardrails into all gemini/agents (21)
  and claude/agents (22) definitions, enforced by new checks in
  check_gemini_agents.sh and check_claude_agents.sh
- Document optional platform-level enforcement: permissions.deny for
  Claude Code, Policy Engine policy.toml for Gemini CLI
- Qualify the root README deny-list claim per platform

Claude Code orchestration:
- Document CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=2 requirement in
  claude/README.md, root README, and installer post-install message
  (Claude Code withholds the Agent tool from subagents by default);
  soften unverifiable version claim

Installers (all three):
- --dry-run no longer queries the GitHub API for 'latest' (uses a
  placeholder version and prints the candidate URLs instead)

CI:
- make test-all now depends on test-preflight, so the agent lints
  actually run in CI

Misc:
- gemini/agents/engineering-team.md H1 version v1.0 -> v1.2.2
@jkyberneees
jkyberneees merged commit 2f7221d into main Jul 24, 2026
5 checks passed
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.

1 participant