C3 Migration

Upgrades C3 architecture documentation to the latest version by applying automated transforms and sequential migration batches.

SkillLearning DocumentationDocs Standards

The source repository doesn't declare a license. Check its terms before reusing the code.

Key features

  • Structured ADR (Architecture Decision Record) status and consistency checks
  • Automated version detection for numeric and date-based C3 schemes
  • Sequential transformation planning across multiple version gaps
  • Batch processing of file updates to ensure trackability and stability
  • Automatic metadata updates for README frontmatter and project versioning

Use cases

  • Ensuring project-specific C3 settings are compatible with updated skill capabilities
  • Standardizing naming conventions and folder structures for architectural documentation
  • Upgrading a project from legacy C3 flat structures to the modern nested container format

FAQ

What does the C3 Migration skill do?

The C3 Migration skill automates the process of upgrading .c3/ architecture documentation to the latest version. It detects version gaps, creates a transformation plan, and applies updates in sequential batches to ensure your project documentation stays current and stable.

Does it support both numeric and date-based versions?

Yes. The skill is designed to recognize and transition between legacy numeric versions (v1, v2, v3) and modern date-based versioning (YYYYMMDD-slug), maintaining a clear chronological upgrade path for your documentation.

What kind of transformations can it perform?

It can perform complex structural changes such as flattening component directories, renaming context files, converting containers to folders, updating frontmatter metadata, and ensuring consistent lowercase naming conventions for Architecture Decision Records (ADRs).

How does this skill ensure my documentation remains stable during updates?

The skill follows a strict safety protocol: it identifies the version gap, presents a detailed migration plan for your approval, and then executes changes in small batches of 3-5 files. This approach allows for easy tracking and prevents large-scale errors.

When should I use the C3 Migration skill?

You should use this skill whenever you need to align your project's .c3/ directory with the latest architectural standards. It is particularly useful when moving between major versions (like v2 to v3) or transitioning to date-based versioning schemes.