Skip to content

feat: add /pollinate and /pollinate-verify skills for cross-codebase feature porting#1

Merged
kylestratis merged 24 commits into
mainfrom
pollinate
May 18, 2026
Merged

feat: add /pollinate and /pollinate-verify skills for cross-codebase feature porting#1
kylestratis merged 24 commits into
mainfrom
pollinate

Conversation

@kylestratis
Copy link
Copy Markdown
Owner

Summary

  • Add /pollinate command and skill for analyzing source features, mapping conventions to target project, and generating design documents that feed into the standard /plan/execute pipeline
  • Add /pollinate-verify command and skill with three-layer verification: differential testing, adversarial hardening (via Opus agent), and standard verify
  • Include differential testing framework appendix with same-language, cross-language (test vector), and acceptable difference documentation patterns
  • Add graceful degradation when beads/deciduous tracking tools are unavailable
  • Add LEARNED comments and convention mapping rationale for reusable knowledge capture

Test plan

  • 70/70 structural acceptance criteria validated by test analyst
  • Same-language local port (Python→Python): source extraction, convention analysis, design doc generation
  • Cross-language remote port (Python→JavaScript): clone, chunking, cross-language test vectors
  • Rigor critical flag: property-based testing, minimum 2 adversarial iterations
  • Pollinate-verify three-layer execution: differential → adversarial → standard verify
  • Graceful degradation: skill completes without beads/deciduous installed
  • Full pipeline: /pollinate/plan/execute/pollinate-verify
  • Human test plan at docs/test-plans/2026-03-26-pollinate.md

🤖 Generated with Claude Code

kylestratis and others added 24 commits March 26, 2026 20:01
… 1-3)

- Add Before Starting section with beads epic creation and deciduous goal logging
- Add Step 1: Parse arguments for source type detection and feature identifier
- Add Step 2: Agent dispatch prompts for local path and remote URL handling
- Add Step 3: Chunk decomposition with optional user interaction
- Include deciduous logging for extraction results and chunk decisions
- Follow patterns from designing/SKILL.md and exploring/SKILL.md

Verifies: pollinate.AC1.1-AC1.5 (source acquisition and feature extraction)
- Add explicit deciduous logging commands at end of Step 3
- Log extraction action with feature name, source, line count, and dependency count
- Log decomposition decision (monolithic, suggested chunks, or custom chunks)
- Include all three decision variants based on user choice
- Provide audit trail for source analysis decisions

Task 2: Add deciduous logging for source analysis decisions
- Minor: Remove duplicate 'Announce' line from Before Starting section
- Important: Duplicate full structured output requirements into remote URL prompt block so it's self-contained (agent can't see local prompt)
- Critical: Add guidance for remote clone persistence in design doc generation phase
Step 4 analyzes the target project's conventions and patterns:
- Dispatches codebase-investigator to extract language, naming, error handling, async, testing, and dependency patterns
- For cross-language ports, researches idiomatic equivalents using combined-researcher
- Builds Convention Mapping Table (source vs target conventions with adaptation notes)
- Builds Dependency Mapping Table (source deps → target equivalents with installation status)
- Logs deciduous actions for convention analysis and cross-language research
Step 5 surfaces trade-off decisions to the user in three categories:

1. Dependency Swaps - for each source vs target dependency difference, present options:
   - Use target equivalent (recommended)
   - Port source dependency inline
   - Skip functionality
   Each logged to deciduous with rationale

2. Architectural Adaptations - for each architectural style difference, present options:
   - Adapt to target style (recommended with performance/accuracy notes)
   - Keep source style
   - Hybrid approach
   Each logged to deciduous with rationale

3. Rigor Flagging (conditional) - if --rigor critical not passed, use multiSelect to let
   user flag chunks for elevated verification (property-based testing, extra adversarial)
   Logged to deciduous with list of flagged chunks

All decisions logged to deciduous with confidence 85 (85 for swaps/arch, 80 for rigor)
Summary action logged after all decisions
Update Final Verification Phase template to match actual pollinate-verify layer names:
- Layer 2: Changed 'Behavioral Equivalence' to 'Adversarial Hardening'
- Layer 3: Changed 'Integration Verification' to 'Standard Verify'

These names now match the actual implementation of the pollinate-verify skill.

Location: plugins/workflow-commands/skills/pollinate/SKILL.md:731-733
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add /pollinate and /pollinate-verify to plugin description
- Add pollinate, porting, cross-codebase keywords
- Sync marketplace.json version (was drifted at 0.4.0)
- Create CHANGELOG.md with release history

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kylestratis kylestratis merged commit ac1de29 into main May 18, 2026
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