/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 を使う。

2026-07-112

anytime-cross-review

anytime-trial/anytime-markdown

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 レビュー」「二者レビュー」の指示で使用する。

2026-07-112

anytime-review

anytime-trial/anytime-markdown

コードレビュー結果を出力する際の Markdown 書式（memory-core ingest パーサ対応）。### N. タイトル＋重大度/カテゴリ/対象の3メタデータ＋行頭の問題:/提案: マーカーで指摘を構造化する。レビュードキュメント・code-reviewer subagent 出力・requesting-code-review/security-review の指摘を書く時に使用する。

2026-07-112

anytime-cross-review

anytime-trial/anytime-markdown

2026-07-112

anytime-markdown-output

anytime-trial/anytime-markdown

Markdown ドキュメント（spec/tech/test/manual/proposal/plan/review/report）を出力・編集する際の構文・フロントマター・整形規約。/Shared/anytime-markdown-docs/ 配下に .md を作成/更新する時、見出し・テーブル・コードブロック・脚注・アドモニション・図表・フロントマター(type/c4Scope 等)を書く時、Markdown 出力仕様を確認する時に使用する。

2026-07-112

anytime-spec-lookup

anytime-trial/anytime-markdown

anytime-markdown の設計書（/Shared/anytime-markdown-docs/spec）を低トークンで辿るためのナビゲーション手順。索引(index.ja.md) → 対象 frontmatter → 型付き related を必要な深さだけ辿る progressive disclosure。設計書の調査・参照・関連ドキュメント探索・「どの spec を読むべきか」を判断する時に使用する。

2026-07-112

name	production-release
description	本番リリース手順ガイド。「リリース」「本番リリース」「拡張機能をリリース」「vsixを作成」「Marketplaceに公開」「バージョンを上げてリリース」などの指示で使用する。

VS Code 拡張機能リリース

更新日: 2026-07-09

anytime-markdown / anytime-graph / anytime-trail / anytime-database / anytime-sheet / anytime-agent / anytime-history / anytime-extension-pack VS Code 拡張機能および web-app のリリース手順。

手順

Step 1: 事前確認

git branch --show-current   # develop ブランチであること
git status                  # 未コミット変更がないこと
git pull origin develop     # 最新化

未コミット変更がある場合はユーザーに確認する。develop 以外のブランチの場合は警告する。

失敗時: develop 以外のブランチにいる場合は git checkout develop で切り替え。未コミット変更がある場合はユーザーに stash / commit / discard のいずれかを確認してから続行。

Step 2: バージョン更新

リリースの単位は 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-database matrix → 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系統ずつ確認する。

patch: バグ修正、軽微な改善、依存更新
minor: 新機能追加、後方互換性のある変更
major: 破壊的変更、後方互換性のない変更

例:
[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.json
packages/mcp-graph/package.json
packages/vscode-graph-extension/package.json

trail 系の更新:

# 各 package.json の version を手動で更新
# trail-core, vscode-trail-extension の2つを同一バージョンに統一

更新後、以下のファイルでバージョンが統一されていることを確認:

packages/trail-core/package.json
packages/vscode-trail-extension/package.json

database 系の更新:

# 各 package.json の version を手動で更新
# database-core, database-viewer, vscode-database-extension の3つを同一バージョンに統一

更新後、以下のファイルでバージョンが統一されていることを確認:

packages/database-core/package.json
packages/database-viewer/package.json
packages/vscode-database-extension/package.json

cms 系の更新:

# 各 package.json の version を手動で更新
# cms-core, mcp-cms の2つを同一バージョンに統一

更新後、以下のファイルでバージョンが統一されていることを確認:

packages/cms-core/package.json
packages/mcp-cms/package.json

sheet 系の更新:

# spreadsheet-core, spreadsheet-viewer, vscode-sheet-extension の3つを同一バージョンに統一

単独系統の更新（各 package.json の version を手動で更新）:

agent 系: packages/vscode-agent-extension/package.json
history 系: packages/vscode-history-extension/package.json
cms-remote 系: packages/mcp-cms-remote/package.json
web-app 系: packages/web-app/package.json
extension pack 系: packages/vscode-extension-pack/package.json

注意: 各系統のバージョンは独立している。npm run version:sync は使用禁止。すべて手動更新する。

Step 3: CHANGELOG 更新

リリース対象に応じて 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)
- グラフコアの主要な変更の要約

Step 4: セキュリティ監査

npm audit

critical / high の脆弱性がある場合は、該当パッケージを更新してから次のステップに進むこと（PR 作成前の必須ゲート）。更新時は型チェック・テストで互換性を確認する。

失敗時: 脆弱性パッケージの更新後は Step 5 のテスト・ビルド検証を再実行して互換性を確認。更新で破壊的変更が入る場合はユーザーに判断を仰ぐ。

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 系のみのリリースでも全テスト・全ビルドを実行する（依存関係の影響を検出するため）。

lint エラーがある場合は修正してから次のステップに進むこと（CI の npm run lint と同じチェック）。root の lint 実体は eslint packages/markdown-viewer/src packages/web-app/src のみで、graph 系・trail 系・database 系等は lint 対象外。
e2e テストが失敗した場合は修正してから次のステップに進むこと（PR 作成前の必須ゲート）。
VR（ビジュアル回帰）が失敗したら、まず --update-snapshots を打たない。 祖先要素の小数高さ（例: ボタン行 39.39px）による sub-pixel ずれだと、見た目は変わっていないのに複数スナップショットが落ちる。origin/master を worktree に出して同じ VR を走らせ（node_modules は main へ symlink）、master で pass するならローカル環境差ではなくコード起因。差分画像を読み、要素の getBoundingClientRect() の top が整数かを確認してから、ベースライン更新か実装修正かを決める。
E2E カバレッジ: e2e:coverage は Chromium のみで実行し、coverage/coverage-final.json（Istanbul 形式）を出力する。出力されたカバレッジファイルのファイル数をコンソールで確認する（E2E coverage: N files → のログ）。C4 モデルビューアでカバレッジを読み込み、対象ファイルのカバレッジ状況を視覚的に確認する。
next build が失敗した場合は修正してから次のステップに進むこと（Netlify デプロイと同じビルドコマンド）。
e2e テストは Playwright + Chromium で実行される（dev サーバーが自動起動する）。
vscode-markdown-extension の 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 を再実行。

Step 6: VSIX パッケージ作成

リリース対象に応じて 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 が生成されることを確認する。

Step 7: ローカルテスト

リリース対象の 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

Step 8: コミット・push

本番リリース依頼を受けている状態のため、通常の push 操作時にユーザー確認は挟まない。リリース依頼自体が push の承認にあたる。

git add -A
git commit -m "release: v<version>"
git push origin develop

失敗時: push が rejected された場合は git pull --rebase origin develop で最新を取り込んでから再 push。コンフリクトが発生した場合はユーザーに確認。

Step 8.5: CI 検証ゲート

push 後に GitHub Actions（CI / Publish VS Code Extension ワークフローの ci ジョブ）の完了を待つ。

develop push の CI は高速フィードバック用で、以下のみ実行される:

型チェック・lint

ユニットテスト・e2e・ビルド・VSIX 作成・audit は master PR で実行されるため、develop push では省略される。Step 5 でローカル実行済みのため、CI での再実行は不要。

CI が全通過 → Step 9 へ進む
CI が失敗 → 原因を修正し、Step 5 に戻って全検証を再実行する

注意: 修正の規模に関わらず、コード変更後は必ず Step 5 からやり直すこと。「軽微な修正だから lint だけ」という例外は認めない。

ループバックルール

Step 5 通過後、Step 9（PR マージ）までの間にコード修正が発生した場合は、修正規模に関わらず必ず Step 5 に戻って全検証を再実行する。 rebase や force push が発生した場合も同様。

Step 9: PR 作成・マージ

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 は品質ゲートとして全項目を実行する:

依存チェック・audit・型チェック・lint
全ユニットテスト
web-app ビルド + バンドルレポート
拡張機能ビルド・VSIX 作成
e2e テスト（3ブラウザ）

master PR の CI が全通過したらマージする。

master へのマージ後、GitHub Actions が自動で以下を実行する（markdown 系・graph 系・trail 系・database 系・sheet 系・agent 系・history 系・extension pack 系それぞれ独立した publish ジョブ）:

ci.yml の CI ジョブで拡張機能ビルド・VSIX を作成（テスト等は master push ではスキップ）
trail 系・database 系は ci.yml の build-trail / build-database matrix が per-platform で各 4 VSIX を生成し、続けて publish-trail / publish-database ジョブを実行
Marketplace に公開（バージョンが変わっていない系統はタグが既存のためスキップ）
git タグを自動作成・push（markdown 系: 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 Release を自動作成（VSIX 添付 + リリースノート自動生成）

Step 10: 公開確認

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. 手動アップロード:

Publisher 管理ページにアクセス
New Extension → Visual Studio Code → .vsix ファイルをアップロード

publisher: anytime-trial

master ビルド失敗時のロールバック手順

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 で修正 → パッチバージョンを上げて再リリース（revert より前進を優先）
緊急時は 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 Actions 自動公開

ワークフロー: .github/workflows/ci.yml（per-platform ビルドを含め一本化済み）

トリガー: master ブランチへの push（PR マージ時）
処理:
- 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 作成）
- per-platform 系（trail / database）: build-trail / build-database matrix（4 プラットフォーム = linux/win32 × x64/arm64、darwin なし）が各 4 VSIX を生成 → publish-trail / publish-database ジョブが一括 publish → タグ作成 → GitHub Release 作成
スキップ条件: 同一バージョンのタグが既に存在する場合はスキップ（markdown 系: 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>）
必要な Secret: VSCE_PAT（Azure DevOps Personal Access Token、全拡張機能で共有）

VSCE_PAT の設定手順

Azure DevOps にアクセス
User Settings → Personal Access Tokens → New Token
Organization: All accessible organizations、Scopes: Marketplace > Manage
トークンをコピー
GitHub リポジトリ → Settings → Secrets and variables → Actions → New repository secret
Name: VSCE_PAT、Value: コピーしたトークン

備考

packages/vscode-markdown-extension/.vscodeignore でパッケージに含めないファイルを制御
VSIX のみ作成してローカル配布する場合は Step 7 のタグ push をスキップ可
hotfix の場合は main ブランチから作業し、main と develop の両方にマージする