/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...]
| Argument | Required | Description |
|---|---|---|
| output-path | No | One 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}/:
| File | Content |
|---|---|
{id}-{slug}.md | Integration log with file manifest and rollback instructions |
Also writes files directly into the project (src/, configs, etc.).
What It Asks
| Question | When | Why |
|---|---|---|
| Output selection | No arguments provided | Choose which outputs to integrate |
| Overwrite approval | File already exists | Prevent accidental data loss |
| Merge confirmation | Config files differ | Review merged content |
| Install approval | New dependencies found | User 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-activatenext if CI/CD configs were integrated
Related Skills
- /dev-project-assemble - Assemble project from scaffolds
- /devops-deploy-activate - Activate deployment pipeline
- /backend-scaffold - Generate backend code
- /frontend-scaffold - Generate frontend components
Technical Details
- Logical Name: dev-output-integrate
- Command:
/dev-output-integrate - Role: dev
- Output:
$JAAN_OUTPUTS_DIR/dev/output-integrate/{id}-{slug}/