artifact-lifecycle

Artifact Lifecycle Skill

統合アーティファクトライフサイクルワークフローの便利なラッパーです。

概要

このスキルは、.claude/workflows/core/skill-lifecycle.md にある包括的なアーティファクトライフサイクル管理ワークフローへのシンプルなインターフェースを提供します。

使用するタイミング

次のような場合にこのスキルを使用します。

• 新しいアーティファクト（スキル、エージェント、フック、ワークフロー、テンプレート、スキーマ）を作成する
• 既存のアーティファクトを更新する
• 移行ガイダンスを付けてアーティファクトを非推奨にする
• アーティファクトがすでに存在するか確認する

クイックスタート

// Invoke this skill
Skill({ skill: 'artifact-lifecycle' });

ワークフローのリファレンス

完全なワークフロー： .claude/workflows/core/skill-lifecycle.md

フェーズ

フェーズ 1：検出

アーティファクトが存在するか確認し、バージョンを比較します。

エージェント： architect 出力： 推奨事項を含む検出レポート

フェーズ 2：決定

実行する操作（CREATE、UPDATE、DEPRECATE）を決定します。

エージェント： planner 出力： タスクを含むアクションプラン

フェーズ 3：実行

決定した操作を実行します。

エージェント： developer + 適切なクリエータースキル ツール：

• スキルの場合は Skill({ skill: "skill-creator" })
• エージェントの場合は Skill({ skill: "agent-creator" })
• フックの場合は Skill({ skill: "hook-creator" })
• ワークフローの場合は Skill({ skill: "workflow-creator" })

フェーズ 4：統合

レジストリ、カタログ、CLAUDE.md を更新します。

エージェント： developer 更新対象：

• creator-registry.json
• skill-catalog.md（スキルの場合）
• CLAUDE.md Section 3（エージェントの場合）、または Section 8.5/8.6（スキル／ワークフローの場合）

フェーズ 5：検証

統合をテストし、参照を確認します。

エージェント： qa 確認項目：

• アーティファクトを呼び出せる
• 参照が有効である
• 壊れた相互参照がない

使用例

新しいスキルを作成する

User: "Create a skill for Kubernetes deployment"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: CREATE mode
Invokes: skill-creator
Updates: registry, catalog, CLAUDE.md
Validates: skill invocable

既存のエージェントを更新する

User: "Update the devops agent to support Terraform Cloud"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: UPDATE mode
Version: 1.0.0 → 1.1.0
Updates: agent file, CHANGELOG
Validates: agent referenced correctly

ワークフローを非推奨にする

User: "Deprecate the old deployment workflow"

Router spawns with:
Skill({ skill: "artifact-lifecycle" })

Workflow determines: DEPRECATE mode
Adds: deprecation notice, migration guide
Updates: CLAUDE.md with replacement reference
Validates: no broken references

設定

パラメーター	値	デフォルト
artifact_type	skill, agent, hook, workflow, template, schema	自動検出
operation	create, update, deprecate, integrate	自動検出
version_bump	major, minor, patch	minor

厳守事項

1. 必ずタイプ別のクリエータースキルを使用してください — artifact-lifecycle を、research-synthesis、companion-check、validation を省略する近道として扱ってはいけません。各フェーズにはそれぞれ理由があります。
2. アクションを開始する前に、必ず操作モードを決定してください（CREATE/UPDATE/DEPRECATE）— Phase 2 で決定を確定する前に Phase 3 を始めてはいけません。誤った操作は、無駄な作業や危険な作業につながります。
3. Phase 5 の検証を省略してはいけません — ライフサイクルタスクを完了扱いにする前に、アーティファクトを呼び出せることを確認する必要があります。完了扱いで壊れたアーティファクトを納品するのは、何も納品しないより悪いことです。
4. Phase 4 では、必ずカタログと CLAUDE.md を更新してください — カタログやルーティングのエントリーがないアーティファクトは、エージェントやルーターから認識されません。登録を伴わない統合は不完全です。
5. 単一アーティファクトの簡単な更新に artifact-lifecycle を使用してはいけません — タイプ別のアップデーター（skill-updater、agent-updater、workflow-updater）を使用してください。ライフサイクルは複数フェーズにわたるオーケストレーション専用です。

アンチパターン

アンチパターン	失敗する理由	正しいアプローチ
CREATE の前に research-synthesis を省略する	重複または古い成果物を作成するリスクがあります	必ず最初に research-synthesis を実行してください
Phase 2 の決定前にアクションを開始する	誤った操作が適用されます。UPDATE が必要なのに CREATE してしまいます	Phase 3 の前に Phase 2 を完了してください
Phase 5 の検証を省略する	壊れた成果物が完成品として提供されます	必ず呼び出し可能性を確認してください
Phase 4 でカタログ／レジストリを更新しない	成果物がエージェントやルーターから見えません	必ずカタログ、レジストリ、CLAUDE.md を更新してください
単純なバージョン更新に artifact-lifecycle を使う	軽微な作業に対して手順が大がかりになります	UPDATE モードでは skill-updater／agent-updater を使ってください
artifact_type を指定しない	誤った作成スキルが気付かれないまま呼び出されます	Phase 1 で必ず artifact_type を指定または確認してください

メモリプロトコル

1. 開始前に .claude/context/memory/learnings.md を読みます
2. 決定事項を .claude/context/memory/decisions.md に記録します
3. 問題を .claude/context/memory/issues.md に記録します

関連スキル

• skill-creator - スキルを直接作成します
• agent-creator - エージェントを直接作成します
• workflow-creator - ワークフローを直接作成します
• codebase-integration - 外部成果物を統合します

関連ワークフロー

• .claude/workflows/core/skill-lifecycle.md - ライフサイクル全体のワークフロー
• .claude/workflows/core/external-integration.md - 外部成果物の統合
• .claude/workflows/core/router-decision.md - ルーターの判断フロー