Menu
本番リリース手順ガイド。「リリース」「本番リリース」「拡張機能をリリース」「vsixを作成」「Marketplaceに公開」「バージョンを上げてリリース」などの指示で使用する。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | production-release |
| description | 本番リリース手順ガイド。「リリース」「本番リリース」「拡張機能をリリース」「vsixを作成」「Marketplaceに公開」「バージョンを上げてリリース」などの指示で使用する。 |
更新日: 2026-07-09
anytime-markdown / anytime-graph / anytime-trail / anytime-database / anytime-sheet / anytime-agent / anytime-history / anytime-extension-pack VS Code 拡張機能および web-app のリリース手順。
git branch --show-current # develop ブランチであること
git status # 未コミット変更がないこと
git pull origin develop # 最新化
未コミット変更がある場合はユーザーに確認する。develop 以外のブランチの場合は警告する。
失敗時: develop 以外のブランチにいる場合は git checkout develop で切り替え。未コミット変更がある場合はユーザーに stash / commit / discard のいずれかを確認してから続行。
リリースの単位は CI の publish ジョブ（タグで公開判定） が定義する。同一系統内の「同期セット」パッケージは常に同一バージョンを維持すること。 各系統のバージョンは独立している。
[!IMPORTANT] publish はそのジョブが参照する 拡張機能 package.json の version で判定し、
<tag-prefix><version>のタグが未作成なら公開する。同期セット外のパッケージ（vendored tiptap・各 core/server/viewer の独立バージョン）は bump 対象外で、webpack バンドルにそのまま同梱されるためバージョンを上げる必要はない。
| 系統 | publish ジョブ / タグ | 同期セット（手動 bump 対象） | 備考 |
|---|---|---|---|
| markdown 系 | publish-markdown / v<x> | package.json (root), packages/mcp-markdown, packages/markdown-viewer, packages/markdown-rich, packages/vscode-markdown-extension | markdown-core は vendored tiptap で 0.0.0 固定・bump 対象外。version.ts の APP_VERSION は root を動的参照 |
| graph 系 | publish-graph / graph-v<x> | packages/graph-core, packages/mcp-graph, packages/vscode-graph-extension | graph-viewer は独立バージョン |
| trail 系 | publish-trail / trail-v<x> | packages/trail-core, packages/vscode-trail-extension | trail-server / trail-viewer / trail-db / mcp-trail / memory-core / agent-core は独立・bump 対象外（webpack 同梱）。VSIX は per-platform 4 種（build-trail matrix: linux/win32 × x64/arm64） |
| database 系 | publish-database / database-v<x> | packages/database-core, packages/database-viewer, packages/vscode-database-extension | VSIX は per-platform 4 種（build-database matrix: linux/win32 × x64/arm64。darwin なし） |
| sheet 系 | publish-sheet / sheet-v<x> | packages/spreadsheet-core, packages/spreadsheet-viewer, packages/vscode-sheet-extension | — |
| agent 系 | publish-agent / agent-v<x> | packages/vscode-agent-extension | agent-core は独立バージョン |
| history 系 | publish-history / history-v<x> | packages/vscode-history-extension | trace-core / trace-viewer / trace-agent-node は独立バージョン |
| extension pack 系 | publish-extension-pack / pack-v<x> | packages/vscode-extension-pack | メタパッケージ |
| web-app 系 | （Marketplace 公開なし。master push で Netlify 自動デプロイ） | packages/web-app | タグなし。markdown-* / graph-core の変更を取り込む |
| cms 系 | （Marketplace 公開なし。CI test のみ） | packages/cms-core, packages/mcp-cms | — |
| cms-remote 系 | deploy-mcp-cms-remote.yml（Cloudflare Workers） | packages/mcp-cms-remote | deploy-cms-remote スキル参照 |
[!NOTE] per-platform 系（trail / database）の VSIX（各 4 種）は CI（
ci.ymlのbuild-trail/build-databasematrix →publish-trail/publish-database）が自動生成・自動公開する。旧build-anytime-database.ymlはci.ymlに統合済み。darwin ターゲットは現在ビルドしていない。
バージョン管理ルール:
系統間のバージョンは独立している（markdown 0.10.1 と graph 0.1.0 が共存可能）
npm run version:sync は使用禁止。 全ワークスペースに影響し、意図しないパッケージのバージョンを書き換えるため
バージョン更新は各 package.json の version フィールドを直接編集する
バージョン更新後は全パッケージのバージョンを一覧表示して整合性を確認する:
for dir in . packages/*/; do name=$(node -p "require('./$dir/package.json').name" 2>/dev/null) && ver=$(node -p "require('./$dir/package.json').version" 2>/dev/null) && printf "%-45s %s\n" "$name" "$ver"; done
リリース対象の自動検出:
前回リリース（master の HEAD）以降に変更があるパッケージを特定し、対応する系統を列挙する。
# master との差分でパッケージごとの変更ファイル数を表示
git diff --stat origin/master...HEAD -- packages/ | grep 'packages/' | sed 's|/.*||' | sort | uniq -c | sort -rn
変更が検出された系統のみをリリース対象とする。変更がない系統はスキップする。
系統ごとのバージョンアップ確認:
リリース対象の各系統について、変更内容を要約し、ユーザーに patch / minor / major を1系統ずつ確認する。
例:
[graph 系] 0.1.0 → 変更: useCanvasBase の型エラー修正、選択矩形カラー定数削除
→ patch (0.1.1) / minor / major ?
[web-app 系] 0.10.1 → 変更: C4 Viewer の GitHub 連携、/docs/view でのドキュメント表示
→ patch / minor (0.11.0) / major ?
ユーザーの回答に基づいて各系統のバージョンを更新する。
markdown 系の更新:
# 以下4つの package.json の version フィールドを手動で同一バージョンに更新
# - package.json (root)
# - packages/markdown-core/package.json
# - packages/mcp-markdown/package.json
# - packages/vscode-markdown-extension/package.json
更新後、上記4ファイルのバージョンが統一されていることを確認。
packages/markdown-viewer/src/version.ts の APP_VERSION はルート package.json を動的参照するため手動更新不要。
graph 系の更新:
# 各 package.json の version を手動で更新
# graph-core, mcp-graph, vscode-graph-extension の3つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/graph-core/package.jsonpackages/mcp-graph/package.jsonpackages/vscode-graph-extension/package.jsontrail 系の更新:
# 各 package.json の version を手動で更新
# trail-core, vscode-trail-extension の2つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/trail-core/package.jsonpackages/vscode-trail-extension/package.jsondatabase 系の更新:
# 各 package.json の version を手動で更新
# database-core, database-viewer, vscode-database-extension の3つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/database-core/package.jsonpackages/database-viewer/package.jsonpackages/vscode-database-extension/package.jsoncms 系の更新:
# 各 package.json の version を手動で更新
# cms-core, mcp-cms の2つを同一バージョンに統一
更新後、以下のファイルでバージョンが統一されていることを確認:
packages/cms-core/package.jsonpackages/mcp-cms/package.jsonsheet 系の更新:
# spreadsheet-core, spreadsheet-viewer, vscode-sheet-extension の3つを同一バージョンに統一
単独系統の更新（各 package.json の version を手動で更新）:
packages/vscode-agent-extension/package.jsonpackages/vscode-history-extension/package.jsonpackages/mcp-cms-remote/package.jsonpackages/web-app/package.jsonpackages/vscode-extension-pack/package.json注意: 各系統のバージョンは独立している。npm run version:sync は使用禁止。すべて手動更新する。
リリース対象に応じて CHANGELOG を更新する。各パッケージには CHANGELOG.md（英語）と CHANGELOG.ja.md（日本語）の2ファイルが存在する。両方を同時に更新すること。 形式は Keep a Changelog。
CHANGELOG.md: 英語版（セクションヘッダー: Added / Changed / Fixed / Removed / Security）CHANGELOG.ja.md: 日本語版（セクションヘッダー: 追加 / 変更 / 修正 / 削除 / セキュリティ）## [x.y.z] - YYYY-MM-DD
### Added
- 新機能
### Changed
- 変更
### Fixed
- バグ修正
develop ブランチの最新コミットログを参照してエントリ内容を作成する。ユーザーに内容を確認してもらう。
各モジュールの CHANGELOG 記載ルール:
各パッケージの CHANGELOG にはそのパッケージ固有の変更のみを記載する。共通機能は担当パッケージに記載し、重複記載しない。
| CHANGELOG | 記載する内容 | 記載しない内容 |
|---|---|---|
packages/markdown-viewer/CHANGELOG.md | エディタコア機能（Tiptap、コンポーネント、拡張機能、スタイル、セキュリティ）。markdown-rich 固有変更も含む | VS Code 固有、web-app 固有、CI/CD。markdown-core（vendored tiptap）は CHANGELOG なし |
packages/vscode-markdown-extension/CHANGELOG.md | VS Code 拡張固有（Custom Editor、treeview、webview、activationEvents、ステータスバー移行等）+ ### Editor Core (markdown-viewer / markdown-rich) セクションにエディタコア更新の要約 | web-app 固有、CI/CD、git treeview、graph editor |
packages/web-app/CHANGELOG.md | web-app 固有（ランディングページ、CMS、/docs、C4 Viewer、Next.js、SEO、Auth.js、PWA、Dockerfile）+ CI/CD（GitHub Actions、SonarCloud、e2e テスト） | VS Code 固有、エディタコア |
packages/graph-core/CHANGELOG.md | グラフエンジンコア（ノード、エッジ、キャンバス、レイアウト、エクスポート、アクセシビリティ） | VS Code 固有 |
packages/vscode-graph-extension/CHANGELOG.md | VS Code Graph 拡張固有（Custom Editor、テーマ、設定パネル）+ ### Graph Core (graph-core) セクションに graph-core 更新の要約 | graph-core 詳細 |
packages/trail-viewer/CHANGELOG.md | Trail / C4 ビューア UI コンポーネント（ツリー、グラフ、DSM、ツールバー、C4/C5 レベル） | VS Code 固有、サーバー固有 |
packages/trail-core/CHANGELOG.md | Trail コア機能（タイムライン、アクティビティ追跡、C4 グラフフィルタ） | VS Code 固有 |
packages/vscode-trail-extension/CHANGELOG.md | VS Code Trail 拡張固有 + ### Trail Core (trail-core / trail-server / trail-viewer) セクションにコア・サーバー・ビューア更新の要約 | 各コア詳細 |
packages/database-core/CHANGELOG.md | データベースアダプタ層（DatabaseAdapter, SqlJsAdapter, BetterSqlite3Adapter, PaginatedSqlSheetAdapter, FK 推定、識別子バリデーション） | VS Code 固有、UI 固有 |
packages/database-viewer/CHANGELOG.md | データベース UI コンポーネント（DatabaseEditor, ErdView, TableTree, ResultGrid, SqlEditorPanel） | VS Code 固有、コア詳細 |
packages/vscode-database-extension/CHANGELOG.md | VS Code Database 拡張固有（Custom Editor、Activity Bar パネル、l10n、per-platform VSIX）+ ### Database Core (database-core / database-viewer) セクションに更新の要約 | コア詳細、UI 詳細 |
packages/cms-core/CHANGELOG.md | CMS コア機能（S3 操作、ドキュメント管理、レポート管理） | web-app 固有、VS Code 固有 |
packages/mcp-cms/CHANGELOG.md | MCP CMS サーバー固有（MCP ツール定義、サーバー設定） | CMS コア詳細 |
packages/mcp-cms-remote/CHANGELOG.md | CMS Remote サーバー固有（Cloudflare Workers、リモート MCP） | CMS コア詳細 |
packages/vscode-extension-pack/CHANGELOG.md | パック構成の変更（含まれる拡張機能の追加/削除） | 個別拡張機能の詳細 |
VS Code 拡張での core パッケージ要約の書き方:
VS Code 拡張の CHANGELOG には、各バージョンにコアパッケージの更新要約セクションを設ける。日本語で簡潔に要約する（1エントリ1行、主要機能のみ）。詳細は各 core パッケージの CHANGELOG を参照。
vscode-markdown-extension → ### Editor Core (markdown-core) セクションvscode-graph-extension → ### Graph Core (graph-core) セクションvscode-trail-extension → ### Trail Core (trail-core) セクションvscode-database-extension → ### Database Core (database-core / database-viewer) セクション## [x.y.z] - YYYY-MM-DD
### Added
- VS Code 拡張固有の変更
### Editor Core (markdown-core)
- エディタコアの主要な変更の要約
## [x.y.z] - YYYY-MM-DD
### Added
- VS Code Graph 拡張固有の変更
### Graph Core (graph-core)
- グラフコアの主要な変更の要約
npm audit
critical / high の脆弱性がある場合は、該当パッケージを更新してから次のステップに進むこと（PR 作成前の必須ゲート）。更新時は型チェック・テストで互換性を確認する。
失敗時: 脆弱性パッケージの更新後は Step 5 のテスト・ビルド検証を再実行して互換性を確認。更新で破壊的変更が入る場合はユーザーに判断を仰ぐ。
ワークスペースごとに個別実行する。npm test --workspaces は使用しない。 1コマンドで全ワークスペースを流すと、失敗箇所の特定が困難になり、途中停止で後続テストが未実行になるため。
# 5-1: 型チェック・lint・スキルゲート
npx tsc --noEmit
npm run lint # 注: root の lint 実体は `eslint packages/markdown-viewer/src packages/web-app/src` のみ。graph 系・trail 系・database 系等は lint 対象外
npm run check-skills # 同梱スキルの byte 一致 + 参照実在性 lint + SHORTCUT ゲート + scripts テスト。develop push の CI が回すのでローカルでも必須
# 5-2: ユニットテスト（ワークスペースごとに個別実行）
# 注: markdown-core は vendored tiptap でテスト無し（`--passWithNoTests` を付けないと exit 1）。
# エディタコアのテスト実体は markdown-viewer / markdown-rich にある。
cd packages/markdown-viewer && npx jest --coverage --maxWorkers=1
cd packages/markdown-rich && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/mcp-markdown && npx jest --coverage --maxWorkers=1
cd packages/graph-core && npx jest --coverage --maxWorkers=1
cd packages/mcp-graph && npx jest --coverage --maxWorkers=1
cd packages/trail-core && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/database-core && npx jest --coverage --maxWorkers=1
cd packages/database-viewer && npx jest --coverage --maxWorkers=1
cd packages/cms-core && npx jest --coverage --maxWorkers=1
cd packages/mcp-cms && npx jest --passWithNoTests --maxWorkers=1
cd packages/mcp-cms-remote && npx jest --coverage --passWithNoTests --maxWorkers=1
cd packages/web-app && npx jest --coverage --passWithNoTests --maxWorkers=1
# 5-3: E2E・カバレッジ・ビルド
cd packages/web-app && E2E_COVERAGE=1 npx playwright test --project=chromium
cd packages/web-app && npx next build
cd packages/vscode-markdown-extension && npx webpack --mode production
cd packages/vscode-graph-extension && npx webpack --mode production
cd packages/vscode-trail-extension && npx webpack --mode production
cd packages/vscode-database-extension && npx webpack --mode production
各コマンドの結果を個別に確認し、全て通過してから次のステップに進む。 graph 系のみのリリースでも全テスト・全ビルドを実行する（依存関係の影響を検出するため）。
npm run lint と同じチェック）。root の lint 実体は eslint packages/markdown-viewer/src packages/web-app/src のみで、graph 系・trail 系・database 系等は lint 対象外。--update-snapshots を打たない。 祖先要素の小数高さ（例: ボタン行 39.39px）による sub-pixel ずれだと、見た目は変わっていないのに複数スナップショットが落ちる。origin/master を worktree に出して同じ VR を走らせ（node_modules は main へ symlink）、master で pass するならローカル環境差ではなくコード起因。差分画像を読み、要素の getBoundingClientRect() の top が整数かを確認してから、ベースライン更新か実装修正かを決める。e2e:coverage は Chromium のみで実行し、coverage/coverage-final.json（Istanbul 形式）を出力する。出力されたカバレッジファイルのファイル数をコンソールで確認する（E2E coverage: N files → のログ）。C4 モデルビューアでカバレッジを読み込み、対象ファイルのカバレッジ状況を視覚的に確認する。next build が失敗した場合は修正してから次のステップに進むこと（Netlify デプロイと同じビルドコマンド）。vscode-test はコンテナ環境でネットワークエラーになる場合があるため無視してよい。失敗時:
tsc --noEmit 失敗 → 型エラーを修正してから再実行。npm run lint 失敗 → lint エラーを修正してから再実行。CI と同じ ESLint ルールが適用される。lint 修正後は必ず npx tsc --noEmit と全ユニットテストを再実行すること。 lint の autofix や手動修正で型エラーやテスト失敗が発生する場合がある。e2e:coverage 失敗 → スクリーンショットやトレースを確認し、UI変更による期待値のずれか実際のバグかを切り分ける。カバレッジが出力されない場合は .v8-coverage/ の生成状況と dev サーバーのソースマップ提供を確認する。next build 失敗 → Netlify デプロイで同じエラーが発生する。依存パッケージのバージョン不整合が主な原因。npm ls <package> で重複バージョンを確認し、overrides で統一する。webpack 失敗 → ビルドログの最初のエラーから対処。依存関係の問題なら npm ci を再実行。リリース対象に応じて VSIX を生成する:
markdown 系:
cd packages/vscode-markdown-extension
npx vsce package --no-dependencies
anytime-markdown-<version>.vsix が生成されることを確認する。
graph 系:
cd packages/vscode-graph-extension
npx vsce package --no-dependencies
anytime-graph-<version>.vsix が生成されることを確認する。
trail 系（per-platform、4 VSIX）:
anytime-trail は better-sqlite3 のネイティブバイナリを含むため per-platform 配布が必要。
ci.yml の build-trail matrix が develop / master push 時に 4 プラットフォーム
（linux/win32 × x64/arm64。darwin なし）の VSIX を自動生成する。
ローカル検証では単一プラットフォーム（実行環境）の VSIX のみ生成する:
cd packages/vscode-trail-extension
npx vsce package --no-dependencies
anytime-trail-<version>.vsix が生成されることを確認する。
本番リリース時の per-platform VSIX 4 種は CI で自動生成・自動公開される。
database 系（per-platform、4 VSIX）:
anytime-database も better-sqlite3 を含むため per-platform 配布が必要。
ci.yml の build-database matrix が develop / master push 時に 4 プラットフォーム
（linux/win32 × x64/arm64。darwin なし）の VSIX を自動生成する。
ローカル検証では単一プラットフォーム（実行環境）の VSIX のみ生成する:
cd packages/vscode-database-extension
npx @vscode/vsce package --no-dependencies
anytime-database-<version>.vsix が生成されることを確認する。
本番リリース時の per-platform VSIX 4 種は CI で自動生成・自動公開される。
sheet 系:
cd packages/vscode-sheet-extension
npx vsce package --no-dependencies
anytime-sheet-<version>.vsix が生成されることを確認する。
agent 系:
cd packages/vscode-agent-extension
npx vsce package --no-dependencies
anytime-agent-<version>.vsix が生成されることを確認する。
history 系:
cd packages/vscode-history-extension
npx vsce package --no-dependencies
anytime-history-<version>.vsix が生成されることを確認する。
extension pack 系:
cd packages/vscode-extension-pack
npx vsce package
anytime-extension-pack-<version>.vsix が生成されることを確認する。
リリース対象の VSIX を自動インストールしてから、ユーザーに動作確認を依頼する。
# リリース対象の拡張機能を自動インストール（対象系統のみ実行）
# markdown 系
code --install-extension packages/vscode-markdown-extension/anytime-markdown-<version>.vsix
# graph 系
code --install-extension packages/vscode-graph-extension/anytime-graph-<version>.vsix
# trail 系
code --install-extension packages/vscode-trail-extension/anytime-trail-<version>.vsix
# database 系（ローカル単一プラットフォーム）
code --install-extension packages/vscode-database-extension/anytime-database-<version>.vsix
# extension pack 系
code --install-extension packages/vscode-extension-pack/anytime-extension-pack-<version>.vsix
本番リリース依頼を受けている状態のため、通常の push 操作時にユーザー確認は挟まない。リリース依頼自体が push の承認にあたる。
git add -A
git commit -m "release: v<version>"
git push origin develop
失敗時: push が rejected された場合は git pull --rebase origin develop で最新を取り込んでから再 push。コンフリクトが発生した場合はユーザーに確認。
push 後に GitHub Actions（CI / Publish VS Code Extension ワークフローの ci ジョブ）の完了を待つ。
develop push の CI は高速フィードバック用で、以下のみ実行される:
ユニットテスト・e2e・ビルド・VSIX 作成・audit は master PR で実行されるため、develop push では省略される。Step 5 でローカル実行済みのため、CI での再実行は不要。
注意: 修正の規模に関わらず、コード変更後は必ず Step 5 からやり直すこと。「軽微な修正だから lint だけ」という例外は認めない。
Step 5 通過後、Step 9（PR マージ）までの間にコード修正が発生した場合は、修正規模に関わらず必ず Step 5 に戻って全検証を再実行する。 rebase や force push が発生した場合も同様。
develop → master の PR を作成してマージする。
gh pr create --base master --head develop --title "release: v<version>" --body "v<version> リリース"
失敗時: マージコンフリクトが発生した場合は、develop 上で git merge master してコンフリクトを解決 → 再 push → PR を再作成。
master PR の CI は品質ゲートとして全項目を実行する:
master PR の CI が全通過したらマージする。
master へのマージ後、GitHub Actions が自動で以下を実行する（markdown 系・graph 系・trail 系・database 系・sheet 系・agent 系・history 系・extension pack 系それぞれ独立した publish ジョブ）:
ci.yml の CI ジョブで拡張機能ビルド・VSIX を作成（テスト等は master push ではスキップ）ci.yml の build-trail / build-database matrix が per-platform で各 4 VSIX を生成し、続けて publish-trail / publish-database ジョブを実行v<version>、graph 系: graph-v<version>、trail 系: trail-v<version>、database 系: database-v<version>、sheet 系: sheet-v<version>、agent 系: agent-v<version>、history 系: history-v<version>、extension pack 系: pack-v<version>）GitHub Actions の実行結果を確認する:
gh run list --repo anytime-trial/anytime-markdown --branch master --limit 1 で成功を確認失敗時: Actions が失敗した場合は gh run view --log-failed でエラーログを確認。VSCE_PAT の期限切れが多い。手動公開で対応する:
手動公開が必要な場合:
A. CLI で公開:
# markdown 系
cd packages/vscode-markdown-extension
npx vsce publish --no-dependencies --pat <token>
# graph 系
cd packages/vscode-graph-extension
npx vsce publish --no-dependencies --pat <token>
# trail 系（per-platform、4 VSIX を一括 publish）
cd packages/vscode-trail-extension
# 事前に ci.yml の build-trail artifact から 4 VSIX をダウンロードしておくこと
npx @vscode/vsce publish --packagePath \
anytime-trail-linux-x64.vsix \
anytime-trail-linux-arm64.vsix \
anytime-trail-win32-x64.vsix \
anytime-trail-win32-arm64.vsix \
--pat <token>
# database 系（per-platform、4 VSIX を一括 publish）
cd packages/vscode-database-extension
# 事前に ci.yml の build-database artifact から 4 VSIX をダウンロードしておくこと
npx @vscode/vsce publish --packagePath \
anytime-database-linux-x64.vsix \
anytime-database-linux-arm64.vsix \
anytime-database-win32-x64.vsix \
anytime-database-win32-arm64.vsix \
--pat <token>
# sheet / agent / history 系
cd packages/vscode-sheet-extension && npx vsce publish --no-dependencies --pat <token>
cd packages/vscode-agent-extension && npx vsce publish --no-dependencies --pat <token>
cd packages/vscode-history-extension && npx vsce publish --no-dependencies --pat <token>
# extension pack 系
cd packages/vscode-extension-pack
npx vsce publish --pat <token>
B. 手動アップロード:
.vsix ファイルをアップロードpublisher: anytime-trial
master の CI または publish が失敗し、Marketplace に公開されていない場合:
失敗原因を特定（gh run view --log-failed）
develop で修正 → Step 5 からやり直し
修正後、再度 develop → master PR を作成・マージ
同一バージョンのタグが既存の場合は自動スキップされるため、タグを削除してから再マージ:
# markdown 系
git push origin --delete v<version>
git tag -d v<version>
# graph 系
git push origin --delete graph-v<version>
git tag -d graph-v<version>
# trail 系
git push origin --delete trail-v<version>
git tag -d trail-v<version>
# database 系
git push origin --delete database-v<version>
git tag -d database-v<version>
Marketplace に公開済みで問題が発覚した場合:
[ ] develop ブランチが最新
[ ] バージョンが各系統内で統一（リリース対象の系統）
[ ] CHANGELOG 更新済み（リリース対象の系統）
[ ] npm audit で critical/high 脆弱性なし
[ ] tsc --noEmit 通過
[ ] npm run lint 通過
[ ] npm run check-skills 通過
[ ] npm test 全ユニットテスト通過（markdown-viewer / markdown-rich）
[ ] npm test 全ユニットテスト通過（mcp-markdown）
[ ] npm test 全ユニットテスト通過（graph-core）
[ ] npm test 全ユニットテスト通過（mcp-graph）
[ ] npm test 全ユニットテスト通過（trail-core）
[ ] npm test 全ユニットテスト通過（database-core）
[ ] npm test 全ユニットテスト通過（database-viewer）
[ ] npm test 全ユニットテスト通過（cms-core）
[ ] npm test 全ユニットテスト通過（mcp-cms）
[ ] npm test 全ユニットテスト通過（mcp-cms-remote）
[ ] npm test 全ユニットテスト通過（web-app）
[ ] e2e テスト通過（packages/web-app）
[ ] E2E カバレッジ出力確認（coverage/coverage-final.json）
[ ] next build 通過（packages/web-app）
[ ] webpack ビルド通過（packages/vscode-markdown-extension）
[ ] webpack ビルド通過（packages/vscode-graph-extension）
[ ] webpack ビルド通過（packages/vscode-trail-extension）
[ ] webpack ビルド通過（packages/vscode-database-extension）
[ ] VSIX 生成済み（リリース対象の拡張機能・extension pack。trail 系・database 系は ci.yml の build-trail / build-database で各 4 VSIX を CI 生成）
[ ] ローカルテスト完了
[ ] コミット・push 済み
[ ] CI 検証ゲート通過（GitHub Actions の ci ジョブが全通過）
[ ] develop → master PR マージ済み
[ ] GitHub Actions 成功（タグ自動作成・公開完了）
ワークフロー: .github/workflows/ci.yml（per-platform ビルドを含め一本化済み）
ci.yml: CI ジョブ（テスト + ビルド + 拡張機能の VSIX 作成）→ publish-markdown / publish-graph / publish-history / publish-trail / publish-sheet / publish-agent / publish-database / publish-extension-pack ジョブ（並行実行、各 CI の VSIX を取得 → vsce publish → タグ作成 → GitHub Release 作成）build-trail / build-database matrix（4 プラットフォーム = linux/win32 × x64/arm64、darwin なし）が各 4 VSIX を生成 → publish-trail / publish-database ジョブが一括 publish → タグ作成 → GitHub Release 作成v<version>、graph 系: graph-v<version>、history 系: history-v<version>、trail 系: trail-v<version>、sheet 系: sheet-v<version>、agent 系: agent-v<version>、database 系: database-v<version>、extension pack 系: pack-v<version>）VSCE_PAT（Azure DevOps Personal Access Token、全拡張機能で共有）All accessible organizations、Scopes: Marketplace > ManageVSCE_PAT、Value: コピーしたトークンpackages/vscode-markdown-extension/.vscodeignore でパッケージに含めないファイルを制御/Shared/anytime-markdown-docs 配下のドキュメントを新規作成・執筆する時に、type（spec/tech/test/manual/proposal/plan/review/report）ごとの記載内容（何を書くか）・フォルダ構成・索引 index.[lang].md の自動生成運用を定義する。設計書（spec）の書き方・component spec の 2 ファイル分離・E2E シナリオ表・技術解説記事（tech。「技術記事を書いて」「ブログ記事を作成」「解説記事を書いて」等）の構成テンプレート・執筆ガイドライン・文体・生成ワークフロー・試験設計書（「試験設計書」「テスト設計書」「テストケースを設計」「テスト観点で洗い出し」「テスト計画」「QA 設計」等。7 ペルソナ観点・技法・自動化判定）・プランファイルの「変更対象ファイル」節・索引再生成が必要な時に使用する。構文・フロントマター・整形は anytime-markdown-output、既存設計書の読み方・辿り方は anytime-spec-lookup を使う。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。
develop マージ前に Claude(pr-review-toolkit:code-reviewer subagent)と Codex(codex exec review)が同一 diff を独立レビューし、互いの指摘を検証(adversarial cross-check)して合意指摘を採用する相互レビュー。指摘は review doc + trail memory_reviews に記録する。「相互レビュー」「cross review」「/anytime-cross-review」「Claude Codex レビュー」「二者レビュー」の指示で使用する。
Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。
anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。