@uplift-ds/workflow-skills

Single source of truth for Uplift workflow contracts across Claude Code and Cursor.

What this package contains

• Canonical workflow commands: commands/align.md, commands/prep.md, commands/plan.md, commands/build.md
• Workflow skills: align/, prep/, plan/, build/, review/, conventions/, platform/, domain/
• Contract schemas: contracts/*.schema.json
• Manager-worker orchestration references: orchestrator/
• Pattern decision matrix: conventions/references/execution-pattern-classification.md
• Repo adapter templates: templates/repo-adapter/
• Sync CLI: uplift-workflow-sync
• Stage runner CLI: uplift-workflow run <stage> <ISSUE_ID> --phase=preflight|postflight

Cross-repo update model

1. Update this package once.
2. Publish a new version.
3. In each consumer repo, bump package version and run sync.

No manual copy/paste of .claude/* or .cursor/* across repos.

Sync local wrappers in a consumer repo

Install package, then run:

pnpm add -D @uplift-ds/workflow-skills@latest
pnpm uplift-workflow-sync --force

By default it writes:

• .claude/commands/{align,prep,plan,build}.md
• .cursor/commands/{align,prep,plan,build}.md
• .claude/skills/*/SKILL.md generated from package skills
• .cursor/skills/*/SKILL.md generated from package skills
• .cursor/rules/workflow-pipeline.mdc
• workflow.config.json (if missing, or overwrite with --force)

Run deterministic hooks

Use the runner around each LLM phase:

pnpm exec uplift-workflow run align SOC-415 --phase=preflight
# run reasoning using command/spec
pnpm exec uplift-workflow run align SOC-415 --phase=postflight

Optional target directory:

pnpm uplift-workflow-sync --target=/path/to/repo --force

Validation

From monorepo root:

pnpm install
pnpm run workflow:validate

Packaging strategy

• Current location: packages/workflow-skills in this monorepo.
• Recommended next step: move this folder to a dedicated repo (uplift-workflow-skills) and publish from there.