AgentKit
DocsKitsCLI ReferenceDesktop App

Workflow guides

Run a cross-Kit product launch

Coordinate Marketing discovery and launch work with Engineer implementation through explicit artifacts, owners, and approval gates.

Use this workflow when a product or feature launch needs both a tested product change and coordinated marketing execution. The Marketing Kit owns market evidence, positioning, campaign assets, and measurement. The Engineer Kit owns technical scope, implementation, verification, and release readiness.

Define the shared contract

Before invoking a Skill, agree on:

FieldRequired decision
OutcomeProduct behavior and market result expected
AudienceSegment, user need, and exclusions
ScopeProduct change, launch assets, channels, and non-goals
TimingTarget window, dependencies, and readiness deadline
EvidenceProduct, customer, market, and technical sources
MeasurementProduct and marketing baselines, success metrics, and guardrails
AuthorityWho can approve scope, merge, deploy, publish, spend, and change accounts

If any load-bearing field is unknown, record an owner and resolution gate rather than filling it with an assumption.

Phase 1: establish market and launch evidence

  1. Use Marketing ak:marketing-research for sourced, dated evidence.
  2. Add ak:competitor, ak:persona, or ak:pricing-strategy only when the decision requires them.
  3. Use ak:marketing-planning to create the accepted launch brief and measurement plan.
  4. Use Marketing ak:handoff to transfer the product requirements to Engineer.

The handoff must contain the audience problem, accepted claims, desired product behavior, non-goals, asset requirements, target window, metrics, dependencies, open questions, and the owner of each approval.

Phase 2: plan and deliver the product change

  1. Use Engineer ak:brainstorm when the brief still allows multiple technical directions.
  2. Use ak:scout to verify repository constraints and existing behavior.
  3. Use ak:plan to map the accepted product outcome to phases, risks, tests, release gates, and observable stop conditions.
  4. Use ak:cook to implement the approved plan.
  5. Use ak:test and ak:code-review to verify behavior and production risk.
  6. Use Engineer ak:handoff to return release evidence to Marketing.

Engineer must not silently change the audience claim, launch promise, metric, or timing. Return conflicts to the shared contract and have the responsible owner decide.

The return handoff includes implemented behavior, known limitations, user-facing changes, screenshots or demos, test evidence, rollout constraints, rollback notes, release status, and any claim the implementation no longer supports.

Phase 3: prepare launch execution

  1. Use Marketing ak:launch-strategy to reconcile the accepted brief with actual release evidence.
  2. Use ak:campaign to prepare the campaign plan and ak:content-marketing or ak:write for scoped content.
  3. Route channel-specific drafts through the relevant Marketing Skill.
  4. Review claims against the Engineer handoff before publication.
  5. Obtain explicit approval for provider access, publication, spend, or production changes.

No launch asset should promise behavior that is absent, gated, deferred, or limited in the release evidence.

Phase 4: launch and learn

After authorized release and publication, use ak:analytics to compare product and marketing signals with their baselines. Record data quality, attribution limits, guardrails, and the decision rule before interpreting results.

Route technical regressions through the software delivery workflow. Route funnel or message opportunities through the marketing growth workflow. Material scope or audience changes return to the shared contract and require a new decision.

Completion checklist

The cross-Kit workflow is complete when:

  • product behavior and launch claims match;
  • required tests, reviews, and readiness gates passed;
  • launch artifacts and measurement definitions were approved;
  • deploy, publish, spend, and provider actions have named owners;
  • open risks, rollback conditions, and post-launch decisions are recorded.