Bring a clean trail to the work you already do.

Codex

Register the repository as a marketplace, then install the plugin. The plugin contributes the Sillage skill; your project keeps the workflow records and contracts.

codex plugin marketplace add mbourmaud/sillage-workflow
codex plugin add sillage-workflow@sillage

Claude Code

Add the same repository as a marketplace, then install the named plugin. If Claude has not created its plugin directory yet, run the marketplace command once and retry the install.

claude plugin marketplace add mbourmaud/sillage-workflow
claude plugin install sillage-workflow@sillage

The full Sillage workflow

Install the router and the small phase skills together. Hosts that support implicit invocation can select the next skill from your ordinary language and the current task state.

npx skills add mbourmaud/sillage-workflow \
  --skill using-sillage --skill sillage --skill orient --skill shape --skill slice \
  --skill build --skill prove --skill review --skill handoff \
  --skill research --skill architecture --skill testing --skill solid --skill ddd \
  --skill interface --skill systems --skill security --skill platform \
  --skill frontend-architecture --skill relational-data --skill document-data \
  --skill audit --skill migrate --skill debug --skill test-hygiene \
  --global --agent codex --yes

The skills give the agent the protocol. The project still owns its task card, decisions, native checks, and evidence.

Choose a specialist lens

Install a single portable skill when a project needs one discipline. The names stay short for hosts; the documentation qualifies them as Sillage skills.

npx skills add mbourmaud/sillage-workflow \
  --skill architecture --skill testing --skill ddd --skill solid \
  --skill interface --skill systems --skill security --skill platform \
  --skill frontend-architecture \
  --skill relational-data --skill document-data

Research, audit, migration, debugging, test hygiene, and engineering lenses are available as short portable names. They remain lenses inside the same lifecycle, not parallel workflows.

Update deliberately

Skills do not update in the background. Refresh an installed skill at a task boundary, review the change, and then run the project checks.

npx skills update sillage --global --yes

Updating a skill changes agent guidance only. It does not update project documents, native checks, or the optional reference CLI.

Start the first task

From a fresh conversation, use $using-sillage or simply say “start Sillage”:

The entry skill reads the minimal project and domain context, returns a short state card, and hands off to the next phase. It does not modify files during the handshake.

Then let the agent create or resume one small Markdown task card. Product decisions, scope changes, destructive actions, merges, releases, and deployments remain yours.

Read the workflow stages →