pipeline-uninstall

Atelier Pipeline -- Uninstall

This skill removes the Atelier Pipeline multi-agent orchestration system from the user's project. It is careful, transparent, and non-destructive by default.

<contract> <requires>

• Pipeline previously installed via /pipeline-setup (at least one of .claude/rules/, .claude/agents/, .claude/hooks/, .claude/pipeline-config.json, or docs/pipeline/ exists).
• Write access to project root and explicit user "yes" confirmation before any removal.

</requires> <produces>

• Removal of core pipeline files in .claude/rules/, .claude/agents/ (core only), .claude/commands/, .claude/references/, .claude/hooks/, and docs/pipeline/.
• Removal of .claude/pipeline-config.json and .claude/.atelier-version.
• .claude/settings.json with pipeline hook registrations stripped (file deleted if empty).
• CLAUDE.md with the "Pipeline System (Atelier Pipeline)" section stripped (file deleted if empty).

</produces> <invalidates>

• brain-setup <requires>: .claude/ is no longer guaranteed to exist after uninstall.
• brain-hydrate <requires>: pipeline state directory and agent personas the hydration scout fan-out depends on are gone.
• Any user-created discovered agents in .claude/agents/ lose their orchestration host (files preserved, but no longer functional).

</invalidates> </contract>

<procedure id="uninstall">

Uninstall Procedure

Step 1: Inventory Installed Files

Before removing anything, scan the project to build a complete inventory of what was installed by the pipeline.

Core pipeline files (installed by pipeline-setup):

.claude/rules/
  default-persona.md
  agent-system.md
  pipeline-orchestration.md
  pipeline-models.md
  branch-lifecycle.md

.claude/agents/  (core agents only)
  sarah.md
  colby.md
  robert.md
  sable.md
  investigator.md
  distillator.md
  ellis.md
  agatha.md
  sentinel.md          (if Sentinel was enabled)

.claude/commands/
  pm.md
  ux.md
  architect.md
  pipeline.md
  devops.md
  docs.md

.claude/references/
  dor-dod.md
  invocation-templates.md
  pipeline-operations.md
  agent-preamble.md
  branch-mr-mode.md
  xml-prompt-schema.md

.claude/hooks/
  enforce-paths.sh
  enforce-sequencing.sh
  enforce-pipeline-activation.sh
  enforce-git.sh
  session-hydrate.sh
  pre-compact.sh
  enforcement-config.json

.claude/pipeline-config.json
.claude/.atelier-version

docs/pipeline/
  pipeline-state.md
  context-brief.md
  error-patterns.md
  investigation-ledger.md

Detect each file's existence using Glob and build two lists:

1. Core pipeline files -- files matching the manifest above that exist on disk
2. User-created custom agents -- any .md files in .claude/agents/ whose YAML frontmatter name does NOT match a core agent (sarah, colby, ellis, agatha, robert, sable, investigator, distillator, sentinel)

Step 2: Present Removal Plan

Display the full removal plan to the user BEFORE touching any files. Organize by category:

Pipeline Uninstall Plan
=======================

WILL REMOVE (core pipeline files):
  .claude/rules/           -- [N] files (Eva persona, orchestration rules, models, branch lifecycle)
  .claude/agents/          -- [N] core agent files (sarah, colby, ...)
  .claude/commands/        -- [N] files (slash command definitions)
  .claude/references/      -- [N] files (quality framework, templates, operations)
  .claude/hooks/           -- [N] files (enforcement scripts and config)
  .claude/pipeline-config.json
  .claude/.atelier-version
  docs/pipeline/           -- [N] files (pipeline state, context, error patterns)

WILL MODIFY:
  .claude/settings.json    -- Remove hook registrations (PreToolUse, SubagentStop, PreCompact)
  CLAUDE.md                -- Remove "Pipeline System (Atelier Pipeline)" section

WILL PRESERVE (not removed):
  [List any user-created custom agents found in .claude/agents/]
  [If no custom agents: "No user content to preserve."]

Total files to remove: [count]
Total files to modify: [count]

Step 3: Handle Preservable Content

Custom agents: If user-created custom agents are found in .claude/agents/, inform the user:

Found [N] custom agent(s) that were not installed by the pipeline:

- [agent-name] -- [description from frontmatter]

These will NOT be removed. They'll remain in .claude/agents/ but won't

function without the pipeline's orchestration rules. You can delete them

manually if you no longer need them.

Step 4: Get User Confirmation

Ask for explicit confirmation before proceeding:

This will remove [N] files and modify [M] files. This cannot be undone

(though git can restore them if they were committed).

Proceed with uninstall? (yes/no)

Do not proceed without explicit "yes" from the user.

Step 5: Remove Files

Execute the removal in this order:

1. Remove hook registrations from .claude/settings.json:
2. Read the current settings file
3. Remove the PreToolUse hook entries that reference enforce-paths.sh, enforce-sequencing.sh, enforce-pipeline-activation.sh, and enforce-git.sh
4. Remove the SessionStart hook entry that references session-hydrate.sh
5. Remove the PreCompact hook entry that references pre-compact.sh
6. If the hooks object is now empty, remove the hooks key entirely
7. If settings.json is now empty ({}), delete the file
8. Preserve any non-pipeline hook entries and other settings

1. Remove the pipeline section from CLAUDE.md:
2. Find and remove the section starting with ## Pipeline System (Atelier Pipeline) through the end of that section (up to the next ## heading or end of file)
3. If CLAUDE.md is now empty or contains only whitespace, delete the file
4. Preserve all other content in CLAUDE.md

1. Remove core pipeline files (skip any that don't exist):
2. Delete all files in .claude/hooks/ that match the manifest
3. Delete all core agent files in .claude/agents/ (preserve custom agents)
4. Delete all files in .claude/commands/ that match the manifest
5. Delete all files in .claude/references/ that match the manifest
6. Delete all files in .claude/rules/ that match the manifest
7. Delete .claude/pipeline-config.json
8. Delete .claude/.atelier-version
9. Delete all files in docs/pipeline/ that match the manifest

1. Clean up empty directories:
2. If .claude/hooks/ is now empty, remove the directory
3. If .claude/agents/ is now empty (no custom agents), remove the directory
4. If .claude/commands/ is now empty, remove the directory
5. If .claude/references/ is now empty, remove the directory
6. If .claude/rules/ is now empty, remove the directory
7. If docs/pipeline/ is now empty, remove the directory
8. If docs/ is now empty, remove the directory
9. Do NOT remove .claude/ itself -- it may contain settings.json or other non-pipeline files

Step 6: Print Summary

After removal, print a summary:

Atelier Pipeline uninstalled.

Removed: [N] files across [M] directories
Modified: .claude/settings.json (hooks removed), CLAUDE.md (pipeline section removed)
Preserved: [list of preserved items, or "nothing"]

The atelier-pipeline plugin is still registered with Claude Code.
To fully remove it: claude plugin remove atelier-pipeline

If you change your mind, reinstall with: /pipeline-setup

</procedure>

<gate id="uninstall-constraints">

Important Notes

• Never remove files without showing the plan first. The inventory step is mandatory.
• Never remove user-created custom agents. Only remove files that match the core pipeline manifest.
• Preserve non-pipeline content in settings.json and CLAUDE.md. Only remove pipeline-specific entries.
• Handle missing files gracefully. If a file from the manifest doesn't exist, skip it silently -- don't error.
• This skill does NOT remove the plugin itself. It removes the inst