migrate
migrate helps you add govctl governance to an established project by examining existing evidence—documentation, code structure, VCS history, and configuration—to recover consequential decisions and specifications. It guides you through a discovery phase, presents candidates for backfill as Architecture Decision Records, RFCs, or Work Items, and executes only authorized changes in small coherent batches. The workflow preserves traceability, respects existing artifact state, and stops when evidence conflicts or authorization is unclear.
migrate adopts govctl governance in existing projects by discovering and confirming historical decisions before backfilling a baseline.
AI-generated summary based on this skill's SKILL.md
Install
govctl-org/govctl/migrate · repository language: Rust
git clone https://github.com/govctl-org/govctl
cp -r govctl/.claude/skills/migrate ~/.claude/skills/migratenpx skillfed install govctl-org/govctl/migrateFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I adopt govctl in a brownfield codebase?
migrate helps you add govctl governance to an established project by examining existing evidence—documentation, code structure, VCS history, and configuration—to recover consequential decisions and specifications. It guides you through a discovery phase, presents candidates for backfill as Architecture Decision Records, RFCs, or Work Items, and executes only authorized changes in small coherent batches.
Can migrate backfill governance in an existing repo without rewriting history?
Yes. migrate is designed to adopt govctl governance in an existing project without rewriting history. It preserves traceability, respects existing artifact state, and stops when evidence conflicts or authorization is unclear, allowing you to incrementally migrate to govctl while preserving product behavior.
What does the govctl migration discovery process involve?
migrate's discovery process examines your codebase to recover durable governance decisions from code, docs, and VCS evidence. It identifies architectural patterns, specifications, and consequential choices already embedded in your project, then surfaces them as candidates for formalization as ADRs, RFCs, or work items.
How does migrate handle incremental govctl adoption?
migrate executes changes in small coherent batches, allowing you to adopt govctl gradually. Each batch is authorized separately, and the workflow stops when evidence conflicts or authorization is unclear, giving you full control over the pace and scope of your governance adoption.
Can migrate recover governance decisions from legacy code?
Yes. migrate discovers and backfills architectural decisions and specifications from legacy code by analyzing existing evidence across documentation, code structure, version control history, and configuration. This lets you set up ADRs, RFCs, and work items for an established codebase without starting from scratch.
What license does migrate use?
migrate is released under the MIT license, allowing free use, modification, and distribution in both open-source and commercial projects.
SKILL.md
rendered from the published skill — quoted content, verbatim
Brownfield Migration
Adopt govctl incrementally in an existing codebase according to [[ADR-0032]]. Recover durable governance from available evidence without rewriting history, inventing rationale, or changing product behavior.
This is a historical backfill workflow. Use gov for implementation,
discuss for unresolved design, init for installation and scaffolding policy,
and commit for VCS operations.
Operational Baseline
Discovery
Check for gov/config.toml before running resource discovery. Its absence means
the repository is not initialized; use the init skill when the adoption
request authorizes scaffolding, or confirm that step with the user first.
When the config exists, establish what was previously migrated:
```bash govctl status govctl search <topic> govctl adr list govctl rfc list govctl work list active govctl work
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
.claude/skills/migrate/SKILL.md