Skip to content

feat(skills): add pending integration stub pattern across delivery lifecycle - #82

Open
lauraCoxItential wants to merge 3 commits into
itential:mainfrom
lauraCoxItential:feature/pending-integration-stub-pattern
Open

feat(skills): add pending integration stub pattern across delivery lifecycle#82
lauraCoxItential wants to merge 3 commits into
itential:mainfrom
lauraCoxItential:feature/pending-integration-stub-pattern

Conversation

@lauraCoxItential

Copy link
Copy Markdown

Summary

When a customer's integrations are known but not yet finalized, delivery no longer has to stop. This PR introduces a consistent stub pattern across all three delivery agents so engineers can build, test, and demonstrate progress now — and activate the real adapters with a single targeted update later.

Changes

  • solution-arch-agent: new ⚠ Stub feasibility status (distinct from ⚠ Blocked); Design stage produces integration-model-{name}.json OpenAPI stubs and integration-questions.md customer questionnaire for each pending integration
  • builder-agent: new Pending Integration Pattern section — one stub workflow per integration (exercises one core connectivity action), newVariable placeholder task with pending_adapter sentinel, as-built Activate section with pre-filled replacement task JSON
  • qa-agent: new pending-adapter test case type and ⏳ Pending adapter report status — criteria blocked by a pending adapter are accepted residuals, not failures
  • AGENTS.md: four new key rules from Lightning AI engagement (rules 26–29) — cloud OAuth-only auth, flat .data.variables path, template group field cannot be empty, service account Admin Essentials navigation
  • docs: design spec at docs/superpowers/specs/2026-07-09-pending-integration-stub-pattern-design.md

Source

Derived from useCase-lightningAi — EmailOpensource adapter not installed on customer cloud instance, 10 integration model files produced during design phase.

Testing

  • Pattern reviewed against Lightning AI as-built — placeholder task, activation recipe, and pending criteria match what was actually delivered
  • Branch naming follows feature/ convention per CONTRIBUTING.md
  • Commit messages follow Conventional Commits format per CONTRIBUTING.md
  • Review solution-arch-agent ⚠ Stub vs ⚠ Blocked distinction is clear
  • Review builder-agent stub workflow structure and placeholder task mechanics are actionable
  • Review qa-agent pending-adapter type is consistent with existing case types
  • Review AGENTS.md rules 26–29 are precise and not duplicating existing rules

🤖 Generated with Claude Code

lauraCoxItential and others added 2 commits July 9, 2026 10:13
Derived from useCase-lightningAi — captures the pattern for building and
demonstrating delivery progress when customer integrations aren't yet finalized.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
When a customer's integrations aren't yet finalized, delivery no longer
has to stop. Introduces a consistent stub pattern across all three agents:

- solution-arch-agent: new ⚠ Stub feasibility status (distinct from
  Blocked); Design stage produces integration-model-{name}.json stubs
  and integration-questions.md customer questionnaire per pending adapter
- builder-agent: new Pending Integration Pattern section — stub workflow
  per integration (one core connectivity action), newVariable placeholder
  task pattern with pending_adapter sentinel, as-built Activate section
  with pre-filled replacement task JSON
- qa-agent: pending-adapter test case type, ⏳ Pending adapter report
  status — criteria blocked by a pending adapter are accepted residuals,
  not failures
- AGENTS.md: four new rules from Lightning AI engagement (rules 26-29) —
  cloud OAuth-only auth, flat .data.variables path, template group field,
  service account Admin Essentials navigation

Derived from useCase-lightningAi — EmailOpensource stub + 10 integration
model files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@lauraCoxItential
lauraCoxItential requested a review from a team as a code owner July 9, 2026 14:37
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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