Skip to content

Agent integration claude skill#498

Merged
alishakawaguchi merged 9 commits intomainfrom
alisha/agent-integration-skill
Feb 26, 2026
Merged

Agent integration claude skill#498
alishakawaguchi merged 9 commits intomainfrom
alisha/agent-integration-skill

Conversation

@alishakawaguchi
Copy link
Contributor

@alishakawaguchi alishakawaguchi commented Feb 25, 2026

Summary

Adds a multi-phase Claude Code skill+plugin for integrating new AI coding agents with the Entire CLI.

Structure

  • Orchestrator skill (.claude/skills/agent-integration/SKILL.md) — /agent-integration runs all 3 phases sequentially
  • Local plugin (.claude/plugins/agent-integration/) — auto-discovered, provides colon-namespaced subcommands:
    • /agent-integration:research — Assess hook/lifecycle compatibility, produce a compatibility report + test script
    • /agent-integration:write-tests — Generate E2E test suite (agent runner + test scenarios)
    • /agent-integration:implement — Build the Go agent package via TDD

How it works

  1. Research — Inspects the target agent's CLI, probes for hook/lifecycle support, creates a capture test script, and produces a structured compatibility report
  2. Write Tests — Using the research findings, generates the E2E agent runner and any agent-specific test scenarios following existing patterns in e2e/
  3. Implement — Red-green-refactor TDD cycle to build the agent package under cmd/entire/cli/agent/

Each phase can be run independently or sequentially via the orchestrator. Shared parameters (agent name, slug, binary, etc.) are collected once and reused.

Plugin auto-discovery

The * prefix in the / menu indicates project-scoped skills/commands. The plugin in .claude/plugins/ is auto-discovered by Claude Code without needing --plugin-dir.

Test plan

  • Verify /agent-integration shows in the / menu with * prefix
  • Verify /agent-integration:research, :write-tests, :implement all appear
  • Run /agent-integration:research with a target agent and confirm it produces a compatibility report
  • Run /agent-integration to confirm it orchestrates all 3 phases

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings February 25, 2026 18:46
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new Claude skill (“agent-integration”) intended to guide contributors through probing an external agent’s hook/lifecycle model, generating E2E tests, and implementing a Go agent adapter for the Entire CLI.

Changes:

  • Introduces a new /agent-integration skill definition with shared parameters and command routing.
  • Adds “probe”, “e2e-tests”, and “implement” prompt playbooks for agent integration work.
  • Adds a short README documenting the skill’s files, workflow, and references.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
.claude/skills/agent-integration/probe-prompt.md Probe workflow for assessing an agent’s hook/lifecycle compatibility and generating a capture script/report.
.claude/skills/agent-integration/implement-prompt.md TDD-oriented instructions for implementing a new Go agent package + hooks/transcript support.
.claude/skills/agent-integration/e2e-test-prompt.md Instructions for adding an E2E AgentRunner and validating scenarios for a new agent.
.claude/skills/agent-integration/SKILL.md Skill metadata, command routing, and shared parameters.
.claude/skills/agent-integration/README.md High-level documentation for the new skill and links to relevant code/docs.

@cursor
Copy link

cursor bot commented Feb 25, 2026

PR Summary

Low Risk
Documentation/prompt-only additions under .claude/skills/ with no runtime code changes; main risk is incorrect guidance leading to inconsistent future integrations.

Overview
Adds a new .claude/skills/agent-integration skill that defines a three-phase workflow for onboarding new AI coding agents into the Entire CLI: probe (compatibility assessment + capture script + report), e2e-tests (generate an AgentRunner and any needed scenarios), and implement (TDD-driven Go package implementation guidance).

The prompts standardize shared parameters (AGENT_NAME, AGENT_SLUG, etc.), prescribe repo files to consult, and provide concrete output formats/commands while explicitly separating non-destructive probing from code-writing phases.

Written by Cursor Bugbot for commit a30b831. Configure here.

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 2 potential issues.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

Comment @cursor review or bugbot run to trigger another review on this PR

Entire-Checkpoint: 1b1eb9f7be88
@alishakawaguchi alishakawaguchi changed the title WIP - agent integration claude skill Agent integration claude skill Feb 25, 2026
Entire-Checkpoint: 5cb9b2cf5108
alishakawaguchi and others added 4 commits February 25, 2026 15:23
Split the agent-integration skill into an orchestrator skill (/agent-integration)
and a local plugin with individual commands (/agent-integration:research,
/agent-integration:write-tests, /agent-integration:implement). The plugin is
auto-discovered from .claude/plugins/ without needing --plugin-dir.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 2f609211922e
Plugin command files were duplicating the full procedure content already
present in the skill markdown files. Replace with thin wrappers that
reference the canonical skill files, and fix SKILL.md to reference skill
paths instead of plugin paths.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Entire-Checkpoint: 3d9fc17c4515
@alishakawaguchi alishakawaguchi marked this pull request as ready for review February 26, 2026 00:41
@alishakawaguchi alishakawaguchi requested a review from a team as a code owner February 26, 2026 00:41
alishakawaguchi and others added 2 commits February 25, 2026 20:28
Cross-reference /debug-e2e in the test-writer skill so users
know how to diagnose E2E failures after running tests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Collaborator

@Soph Soph left a comment

Choose a reason for hiding this comment

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

😍

@alishakawaguchi alishakawaguchi merged commit 38f0232 into main Feb 26, 2026
3 checks passed
@alishakawaguchi alishakawaguchi deleted the alisha/agent-integration-skill branch February 26, 2026 20:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants