Low Cafeine Workflows

Repo-local Codex and Claude Code workflow installer.

@low-cafeine/workflows installs workflow assets into the target repo. It defaults to Codex, can install Claude Code assets, and avoids relying on global ~/.codex or ~/.claude state.

Quick Start

Run this inside the target project repo:

npx @low-cafeine/workflows init

init installs the default runtime profile for Codex:

• production-feature-dev
• prototype-to-prod
• required shared kits
• required hard rules

The target project gets:

.codex/
  constraints/
  kits/
  prototype-to-prod.yml
  rules/
  skills/

Then restart Codex in that repo and invoke a workflow by name:

production-feature-dev로 이 화면 구현해줘

prototype-to-prod로 이 프로토타입을 실제 컴포넌트로 바꿔줘

For Claude Code, install the same runtime workflow into .claude:

npx @low-cafeine/workflows init --agent claude

The Claude install writes:

.claude/
  CLAUDE.md
  constraints/
  kits/
  prototype-to-prod.yml
  rules/
  skills/

Install both Codex and Claude Code assets:

npx @low-cafeine/workflows init --agent both

Profiles

Install only feature-development workflow assets:

npx @low-cafeine/workflows feature

Install only prototype-conversion workflow assets:

npx @low-cafeine/workflows prototype

Install Vue refactoring workflow assets:

npx @low-cafeine/workflows vue-refactor

Install workflow authoring and template maintenance assets:

npx @low-cafeine/workflows maintainer

Install the default runtime set:

npx @low-cafeine/workflows runtime

Install everything:

npx @low-cafeine/workflows all

Profiles live in .codex/workflows.json and select required skills, skill groups, kits, and rules.

Commands

npx @low-cafeine/workflows init
npx @low-cafeine/workflows update
npx @low-cafeine/workflows list

init installs assets without overwriting changed existing files.

update overwrites changed installed files with the package version.

list shows packaged profiles, skills, skill groups, configs, kits, rules, and manifests.

Options

Choose a profile explicitly:

npx @low-cafeine/workflows init --profile prototype
npx @low-cafeine/workflows update --profile feature

Install one skill plus only its declared shared assets:

npx @low-cafeine/workflows init --skills production-feature-dev

Install all packaged skills plus their required shared assets:

npx @low-cafeine/workflows init --skills all

Use the all profile when you also want maintainer and template-authoring assets.

Install maintainer assets with another profile:

npx @low-cafeine/workflows init --include-maintainer

Preview without writing:

npx @low-cafeine/workflows prototype --dry-run

Overwrite existing changed files during init:

npx @low-cafeine/workflows init --force

Install into another project directory:

npx @low-cafeine/workflows init --target /path/to/project

Override shared assets:

npx @low-cafeine/workflows init --kits prod-ui
npx @low-cafeine/workflows init --rules production-workflow-hard.rules
npx @low-cafeine/workflows init --no-kits
npx @low-cafeine/workflows init --no-rules

Choose the target agent:

npx @low-cafeine/workflows init --agent codex
npx @low-cafeine/workflows init --agent claude
npx @low-cafeine/workflows init --agent both

Repository Layout

.codex/
  workflows.json          profile manifest
  constraints/            workflow constraint templates
  kits/                   reusable workflow/template sources
  prototype-to-prod.yml   runtime prototype conversion config
  rules/                  hard rules copied into target repos
  skills/                 runnable Codex skills copied into target repos

.claude/
  CLAUDE.md               generated only when installing with --agent claude or --agent both
  constraints/            Claude-local workflow constraints
  kits/                   Claude-local shared workflow sources
  prototype-to-prod.yml   Claude-local prototype conversion config
  rules/                  Claude-local hard rules
  skills/                 Claude Code project skills

bin/
  codex-workflows.js

kits are source templates. skills are runnable installed packages. Claude-local copies are written under .claude only for claude or both.

Release

Before publishing, make sure no token file is present:

test ! -f .npmrc

Check package contents:

npm pack --dry-run

Publish a new version:

npm version patch
npm publish --access public

Never commit .npmrc or an npm token.