Skip to main content

/dev-output-integrate

Bridge generated outputs from jaan-to/outputs/ into operational project locations.


Overview

Reads generated jaan-to output files, parses their README placement instructions, and copies them into the correct project locations. Handles config file merging (package.json, tsconfig.json), entry point wiring (plugin registration, imports), dependency installation, and post-integration validation. Always shows diffs and gets approval before overwriting.

  • OpenAPI-Aware Integration: When outputs include Orval/MSW files, handles placement of API config (orval.config.ts), mock handlers (src/mocks/), Storybook MSW initialization (.storybook/preview.*), and MSW service worker installation.

Usage

/dev-output-integrate
/dev-output-integrate [output-path...]
ArgumentRequiredDescription
output-pathNoOne or more paths to jaan-to output folders

When run without arguments, scans all outputs interactively.


What It Produces

Files at $JAAN_OUTPUTS_DIR/dev/output-integrate/{id}-{slug}/:

FileContent
{id}-{slug}.mdIntegration log with file manifest and rollback instructions

Also writes files directly into the project (src/, configs, etc.).


What It Asks

QuestionWhenWhy
Output selectionNo arguments providedChoose which outputs to integrate
Overwrite approvalFile already existsPrevent accidental data loss
Merge confirmationConfig files differReview merged content
Install approvalNew dependencies foundUser controls package installation

Workflow Chain

/backend-scaffold + /frontend-scaffold + /devops-infra-scaffold --> /dev-output-integrate --> /devops-deploy-activate

Example

Input:

/dev-output-integrate jaan-to/outputs/backend/scaffold/01-my-api/

Output:

Files copied:        12 files
Entry points edited: 3 files (app.ts, providers.tsx, package.json)
Dependencies added: 8 packages
Validation: TypeScript ✓, Lint ✓, Tests ✓

Integration log: jaan-to/outputs/dev/output-integrate/01-my-api-integration/01-my-api-integration.md

Tips

  • Run after all scaffold and service skills have generated their outputs
  • Review the integration plan carefully before approving — especially replacements and merges
  • Keep a clean git state before running so you can easily roll back with git stash
  • Use /devops-deploy-activate next if CI/CD configs were integrated


Technical Details

  • Logical Name: dev-output-integrate
  • Command: /dev-output-integrate
  • Role: dev
  • Output: $JAAN_OUTPUTS_DIR/dev/output-integrate/{id}-{slug}/