Migration

Upgrading between Fulcrum versions

This guide covers upgrading between Fulcrum versions. Each major version may include breaking changes that require migration steps.

💡 Pro tip: Before upgrading, commit any uncommitted changes and create a backup branch. Migration is usually smooth, but it's good practice.

Current Version: 0.20

The latest stable version with unified namespace and consolidated agents.

# Check your current version
cat .fulcrum/config.json | grep version

# Or use npm
npm list @anthropic/fulcrum

v0.19 → v0.20

Released: January 2026
Difficulty: Easy (non-breaking)

What Changed

Unified fulcrum: namespace prefix for all entities
Consolidated QA Engineer (full-stack testing expert)
Streamlined to 4 vendor adapters: Claude, Copilot, Gemini, Codex

Upgrade Steps

# 1. Update the package
npm update @anthropic/fulcrum

# 2. Regenerate vendor files
npm run fulcrum:generate

# Done! No breaking changes.

v0.17 → v0.19

Released: December 2025
Difficulty: Easy (non-breaking)

What Changed

98% faster session startup with lazy loading Memory Bank
New platform-architect skill for cloud deployments
Self-injecting using-fulcrum skill at session start

Upgrade Steps

# 1. Update the package
npm update @anthropic/fulcrum

# 2. Regenerate vendor files
npm run fulcrum:generate

# Done! No breaking changes.

v0.15 → v0.17

Released: December 2025
Difficulty: Easy (minor adjustments)

What Changed

Added Gemini CLI support
Added Codex CLI support
Unified .fulcrum/ configuration

Upgrade Steps

# 1. Update the package
npm update @anthropic/fulcrum

# 2. Regenerate vendor files
npm run fulcrum:generate

v0.13 → v0.15

Released: December 2025
Difficulty: Moderate (significant restructure)

⚠️ Major version upgrade: v0.15 is a vendor-agnostic rewrite. This is the most significant migration.

What Changed

Renamed to Fulcrum (from Claude AI Team Framework)
Complete vendor-agnostic architecture
Single source of truth in .fulcrum/
New configuration format (config.json)
Unified agent definitions
Beads integration for work tracking

Upgrade Steps

# 1. Backup your current setup
git checkout -b backup-pre-015
git add -A && git commit -m "Backup before v0.15 migration"
git checkout main

# 2. Install v0.15
npm install @anthropic/fulcrum@0.15

# 3. Run setup wizard
/setup-fulcrum

# 4. Initialize Beads
/setup-beads

# 5. Regenerate all vendor files
npm run fulcrum:generate

Troubleshooting

Common Issues

Issue	Cause	Solution
Commands not recognized	Old command names	Use new names: `/start`, `/execute-work`
Agents not loading	Old agent IDs in config	Update to new agent names (see table above)
Config parse error	JS config vs JSON	Migrate to `config.json` format
Vendor files missing	Forgot to regenerate	Run `npm run fulcrum:generate`
Memory Bank empty	Context not migrated	Copy files to `agentic_context/`
Beads errors	Not initialized	Run `/setup-beads`

Clean Slate Migration

If migration is problematic, consider a clean install:

# Remove all Fulcrum files
rm -rf .fulcrum/ .claude/ .github/copilot/ .gemini/ .codex/ agentic_context/ .beads/

# Fresh install
npm install @anthropic/fulcrum@latest
/setup-fulcrum
/setup-beads

📝 Note: A clean install loses custom agents and Memory Bank content. Back up agentic_context/ and custom agents first.

Getting Help

Check the release notes for detailed changelogs
Search GitHub issues for known migration problems
Join the Discord community for live help

Version History

Version	Release	Highlights
0.20	Jan 2026	Namespace consolidation, QA unification, vendor streamlining
0.19	Dec 2025	Smart context, platform-architect skill, lazy loading
0.17	Dec 2025	Multi-vendor support (Gemini, Codex)
0.15	Dec 2025	Vendor-agnostic rewrite, Beads integration
0.13	Dec 2025	Quality gates, PR creator
0.11	Dec 2025	Test engineer, council review
0.09	Jan 2025	Skills system
0.07	Jan 2025	Beads work tracking
0.05	Jan 2025	Agent council
0.03	Jan 2025	Parallel execution
0.01	Jan 2025	Initial release

Deprecation Timeline

Deprecated features and their removal schedule:

Feature	Deprecated	Removed	Replacement
`fulcrum.config.js`	v0.15	v0.15	`.fulcrum/config.json`
`/begin` command	v0.15	v0.17	`/start`
`.fulcrum/workflows/`	v0.17	v0.19	`.fulcrum/skills/`
Multiple QA agents	v0.19	v0.20	Unified `qa-engineer`